<?xml version="1.0" ?> <!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % English "INCLUDE"> ]> <refentry lang="&language;"> <refentryinfo> <title>KDE User's Manual</title> <author>&Lauri.Watts; &Lauri.Watts.mail;</author> <date>June 07, 2005</date> <productname>K Desktop Environment</productname> </refentryinfo> <refmeta> <refentrytitle><command>kate</command></refentrytitle> <manvolnum>1</manvolnum> </refmeta> <refnamediv> <refname><command>kate</command></refname> <refpurpose>Advanced text editor for &kde;</refpurpose> </refnamediv> <refsynopsisdiv> <cmdsynopsis> <command>kate</command> <group choice="opt"><option>-s, --start</option> <replaceable> name</replaceable> </group> <group choice="opt"><option>-u, --use</option></group> <group choice="opt"><option>-p, --pid</option><replaceable> pid</replaceable></group> <group choice="opt"><option>-e, --encoding</option> <replaceable> name</replaceable></group> <group choice="opt"><option>-l, --line</option> <replaceable> line</replaceable></group> <group choice="opt"><option>-c, --column</option> <replaceable> column</replaceable></group> <group choice="opt"><option>-i, --stdin</option></group> <arg choice="opt">KDE Generic Options</arg> <arg choice="opt">Qt Generic Options</arg> </cmdsynopsis> </refsynopsisdiv> <refsect1> <title>Description</title> <para>&kate; is the &kde; Advanced Text Editor. </para> <para>&kate; also provides the editor part for various applications, under the name &kwrite;.</para> <para>Some of &kate;'s many features include configurable syntax highlighting for languages ranging from C and C++ to <acronym>HTML</acronym> to bash scripts, the ability to create and maintain projects, a multiple document interface (<acronym>MDI</acronym>), and a self-contained terminal emulator. </para> <para> But &kate; is more than a programmer's editor. Its ability to open several files at once makes it ideal for editing &UNIX;'s many configuration files. This document was written in &kate;. </para> </refsect1> <refsect1> <title>Options</title> <variablelist> <varlistentry> <term><option>-s</option>, <option>--start</option> <replaceable>name</replaceable></term> <listitem><para>Start &kate; with a given session.</para></listitem> </varlistentry> <varlistentry> <term><option>-u, --use</option></term> <listitem><para>Use an already running &kate;</para></listitem> </varlistentry> <varlistentry> <term><option>-p, --pid</option> <replaceable> pid</replaceable></term> <listitem><para>Only try to reuse kate instance with this <replaceable>pid</replaceable></para></listitem> </varlistentry> <varlistentry> <term><option>-e, --encoding</option> <replaceable> name</replaceable></term> <listitem><para>Set encoding for the file to open</para><para>You can use this to force a file opened in utf-8 format, for instance. (The command <command>iconv -l</command> provides a list of encodings, which may be helpful to you.)</para></listitem> </varlistentry> <varlistentry> <term><option>-l, --line</option> <replaceable> line</replaceable></term> <listitem><para>Navigate to this line</para></listitem> </varlistentry> <varlistentry> <term><option>-c, --column</option> <replaceable> column</replaceable></term> <listitem><para>Navigate to this column</para></listitem> </varlistentry> <varlistentry> <term><option>-i, --stdin</option></term> <listitem><para>Read the contents of <filename>stdin</filename></para></listitem> </varlistentry> </variablelist> </refsect1> <refsect1> <title>See Also</title> <para>kwrite(1)</para> <para>More detailed user documentation is available from <ulink url="help:/kate">help:/kate</ulink> (either enter this <acronym>URL</acronym> into &konqueror;, or run <userinput><command>khelpcenter</command> <parameter>help:/kate</parameter></userinput>).</para> <para>There is also further information available at <ulink url="http://kate.kde.org/">the &kate; website</ulink>.</para> </refsect1> <refsect1> <title>Examples</title> <para>To open a file named <filename>source.cpp</filename> at column 15, line 25, in an existing &kate; window, you could use:</para> <screen><userinput><command>kate</command> <option>-c 15</option> <option>-l 25</option> <option>-u</option> <filename>source.cpp</filename></userinput> </screen> <para>If you have an active internet connection, you can take advantage of &kde;'s network transparency to open a file from an ftp site. If you do not have write permission on the remote server, the file will be opened read only and you will be prompted for a local filename to save to if you make changes. If you do have write permission, changes will be saved transparently over the network.</para> <screen><userinput><command>kate</command> <option><replaceable>ftp://ftp.kde.org/pub/kde/README_FIRST</replaceable></option></userinput></screen> <!-- FIXME: Some more useful examples would be cool, how about this snagged --> <!-- from a mail of anders (slightly edited /line/l to remove the double --> <!-- dashes: > /some/file/path/file.name:lineno > it would rock if Kate could understand that and not only open up file.name, > but jump to lineno after the file is opened. How bad is it to have to convert that into -l lineno /some/file/path/file.name sed s,([^:]*):(\d+),-l \2 \1, will do that, for example.--> </refsect1> <refsect1> <title>Authors</title> <para>The maintainer of &kate; is &Christoph.Cullmann; &Christoph.Cullmann.mail;. A comprehensive list of authors and contributors is available in the complete user manual mentioned above.</para> </refsect1> </refentry>