diff options
author | Michele Calgaro <[email protected]> | 2014-01-19 23:29:24 +0900 |
---|---|---|
committer | Michele Calgaro <[email protected]> | 2014-01-19 23:30:09 +0900 |
commit | 2b062a105808bf0c830e7e8432e6d0dcf00b6d97 (patch) | |
tree | e39962f41987afff1abf787056c2903815de571f /doc/kate | |
parent | 32f7a85c9df5f48a6c9b4d73f0323c490a6ae95f (diff) | |
download | tdebase-2b062a105808bf0c830e7e8432e6d0dcf00b6d97.tar.gz tdebase-2b062a105808bf0c830e7e8432e6d0dcf00b6d97.zip |
Kate handbook review - chapter 2
Diffstat (limited to 'doc/kate')
-rw-r--r-- | doc/kate/fundamentals.docbook | 198 | ||||
-rw-r--r-- | doc/kate/index.docbook | 7 |
2 files changed, 98 insertions, 107 deletions
diff --git a/doc/kate/fundamentals.docbook b/doc/kate/fundamentals.docbook index f00c4a8e1..fe8167625 100644 --- a/doc/kate/fundamentals.docbook +++ b/doc/kate/fundamentals.docbook @@ -10,8 +10,8 @@ <para> If you have ever used a text editor, you will have no problem using &kate;. In the next two sections, <link linkend="starting-kate">Starting -&kate; </link> and in <link linkend="working-with-kate">Working with -&kate;</link>, we'll show you everything you need to get up and running +&kate; </link> and <link linkend="working-with-kate">Working with +&kate;</link>, you will find everything you need to get up and running quickly. </para> @@ -27,7 +27,7 @@ command line. <title>From the Menu</title> <para> Open the &tde; program menu by clicking on the -<guiicon>big K</guiicon> icon on the toolbar at the bottom left of your +<guiicon>big T</guiicon> icon on the toolbar at the bottom left of your screen. This will raise the <guimenu>program menu</guimenu>. Move your cursor up the menu to the <menuchoice><guimenu>Utilities</guimenu> <guimenuitem>Editors</guimenuitem></menuchoice> menu item. A list @@ -59,19 +59,19 @@ file. </informalexample> <para> -If you have an active connection, and permission, you can take advantage +If you have an active connection and permission, you can take advantage of &tde;'s network transparency to open files on the internet. </para> <informalexample> <screen> -<prompt>%</prompt><userinput><command>kate</command> <option><replaceable>ftp://ftp.kde.org/pub/kde/README_FIRST</replaceable></option></userinput> +<prompt>%</prompt><userinput><command>kate</command> <option><replaceable>http://git.trinitydesktop.org/cgit/tdebase/plain/doc/kate/index.docbook</replaceable></option></userinput> </screen> </informalexample> <sect3 id="command-line-options"> <title>Command Line Options</title> -<para>&kate; accepts following command line options:</para> +<para>&kate; accepts the following command line options:</para> <variablelist> <varlistentry> @@ -88,24 +88,72 @@ This lists the most basic options available at the command line. <option>--help-qt</option></userinput></term> <listitem> <para> -This lists the options available for changing the way &kate; interacts -with &Qt;. +This lists the options available for changing the way &kate; interacts with &Qt;. </para> </listitem> </varlistentry> <varlistentry> -<term><userinput><command>kate</command> <option>--help-kde</option></userinput></term> +<term><userinput><command>kate</command> <option>--help-tde</option></userinput></term> <listitem> <para> -This lists the options available for changing the way &kate; interacts -with &tde;. +This lists the options available for changing the way &kate; interacts with &tde;. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><userinput><command>kate</command> <option>--help-tde-tempfile</option></userinput></term> +<listitem> +<para> +This lists the available &tde;-tempfile specific options. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><userinput><command>kate</command> +<option>--help-all</option></userinput></term> +<listitem> +<para> +This lists all of the command line options. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><userinput><command>kate</command> +<option>--author</option></userinput></term> +<listitem> +<para> +Lists &kate;'s authors in the terminal window. </para> </listitem> </varlistentry> <varlistentry> <term><userinput><command>kate</command> +<option>-v</option> <option>--version</option></userinput></term> +<listitem> +<para> +Lists version information for &Qt;, &tde;, and &kate;. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><userinput><command>kate</command> +<option>--license</option></userinput></term> +<listitem> +<para> +Shows license information. +</para> +</listitem> +</varlistentry> +</variablelist> + +<varlistentry> +<term><userinput><command>kate</command> <option>-s</option> <option>--start</option> <parameter>name</parameter></userinput></term> <listitem> <para> @@ -125,7 +173,7 @@ well. <para> Causes &kate; to use and existing instance if there is one. If you want all documents to open in one kate instance, you can add this option to the default -command in your kde application configuration, as well as create a shell alias +command in your &tde; application configuration, as well as create a shell alias in your command intepreter if it supports that. </para> </listitem> @@ -133,6 +181,17 @@ in your command intepreter if it supports that. <varlistentry> <term><userinput><command>kate</command> +<option>-f</option> <option>--force-sdi</option> </userinput></term> +<listitem> +<para> +If the multiple document interface (MDI) setting is enabled, forces &kate; to +use the single document interface (SDI) mode. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><userinput><command>kate</command> <option>-p</option> <option>--pid</option> <parameter>PID</parameter></userinput></term> <listitem> <para> @@ -144,7 +203,7 @@ Only reuses an instance with the specified PID (Process ID). Used with the <varlistentry> <term><userinput><command>kate</command> -<option>--encoding</option> <parameter>encoding</parameter> +<option>-e</option> <option>--encoding</option> <parameter>encoding</parameter> <parameter>URL</parameter></userinput></term> <listitem><para>Uses the specified encoding for the document. </para></listitem> @@ -152,7 +211,7 @@ Only reuses an instance with the specified PID (Process ID). Used with the <varlistentry> <term><userinput><command>kate</command> -<option>--line</option> <parameter>line</parameter> +<option>-l</option> <option>--line</option> <parameter>line</parameter> <parameter>URL</parameter></userinput></term> <listitem><para>Navigates to the specified line after opening the document. </para></listitem> @@ -160,7 +219,7 @@ Only reuses an instance with the specified PID (Process ID). Used with the <varlistentry> <term><userinput><command>kate</command> -<option>--column</option> <parameter>column</parameter> +<option>-c</option> <option>--column</option> <parameter>column</parameter> <parameter>URL</parameter></userinput></term> <listitem><para>Navigates to the specified column after opening the document. </para></listitem> @@ -168,7 +227,7 @@ Only reuses an instance with the specified PID (Process ID). Used with the <varlistentry> <term><userinput><command>kate</command> -<option>--stdin</option></userinput></term> +<option>-i</option> <option>--stdin</option></userinput></term> <listitem><para>Reads the document content from STDIN. This is similar to the common option <option>-</option> used in many command line programs, and allows you to pipe command output into &kate;.</para></listitem> @@ -183,46 +242,6 @@ deleted (if they are local files and you have sufficient permissions) when closed, unless they are modified since they were opened.</para></listitem> </varlistentry> -<varlistentry> -<term><userinput><command>kate</command> -<option>--help-all</option></userinput></term> -<listitem> -<para> -This lists all of the command line options. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><userinput><command>kate</command> -<option>--author</option></userinput></term> -<listitem> -<para> -Lists &kate;'s authors in the terminal window. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><userinput><command>kate</command> -<option>-v</option> <option>--version</option></userinput></term> -<listitem> -<para> -Lists version information for &Qt;, &tde;, and &kate;. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><userinput><command>kate</command> -<option>--license</option></userinput></term> -<listitem> -<para> -Shows license information. -</para> -</listitem> -</varlistentry> -</variablelist> </sect3> </sect2> @@ -288,21 +307,8 @@ flexibility. In this section we'll look at three items: </term> <listitem> <para> -Toggles the Documents on and off. If the Documents/Filesystem Browser window is -not open, &kate; launches the side bar as a separate, undocked, -window. To dock the window grab the two thin parallel lines above the -tabs by clicking on them with your &LMB; and holding the button -down. Drag the the window into &kate;'s editing window and release the -&LMB; when you have positioned the Documents/Filesystem Browser window as you -prefer. -</para> - -<tip> -<para> -If you have grabbed the two parallel lines successfully your mouse -pointer will turn into two crossed arrows as you drag. -</para> -</tip> +Toggles the Documents on and off. If the Documents/Filesystem Browser side bar +window is not open, &kate; will open the side bar window.</para> </listitem> </varlistentry> @@ -411,11 +417,11 @@ text)</para></entry> </row> <row> <entry><para><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></para></entry> -<entry><para><link linkend="find"> Find</link></para></entry> +<entry><para><link linkend="kate-part-find-replace">Find</link></para></entry> </row> <row> <entry><para><keycombo action="simul"><keycap>F3</keycap></keycombo></para></entry> -<entry><para><link linkend="find-again"> Find again</link></para></entry> +<entry><para>Find again</para></entry> </row> <row> <entry><para><keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo></para></entry> @@ -441,7 +447,7 @@ text)</para></entry> </row> <row> <entry><para><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></para></entry> -<entry><para><link linkend="replace"> Replace</link></para></entry> +<entry><para><link linkend="kate-part-find-replace">Replace</link></para></entry> </row> <row> <entry><para><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></para></entry> @@ -458,11 +464,11 @@ text)</para></entry> </row> <row> <entry><para><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></para></entry> -<entry><para><link linkend="undo">Undo</link></para></entry> +<entry><para><link linkend="edit-undo">Undo</link></para></entry> </row> <row> <entry><para><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></para></entry> -<entry><para><link linkend="redo">Redo</link></para></entry> +<entry><para><link linkend="edit-redo">Redo</link></para></entry> </row> </tbody> </tgroup> @@ -514,14 +520,14 @@ the start of the window title, which then have the form <para>When opening files on the command line with <option>--start <replaceable>name</replaceable></option> or if a session is selected using the session chooser, the specified session is loaded prior to the files specified -on the command line. To open files from the commandline in a new, unnamed -session, configure kate to start a new session pr default in the session page of +on the command line. To open files from the command line in a new, unnamed +session, configure kate to start a new session per default in the session page of the configuration dialog or use <option>--start</option> with an empty string: <replaceable>''</replaceable>.</para> <para>Since &kate; 2.5.1 the <acronym>PID</acronym> of the current instance is exported to the environment variable <envar>KATE_PID</envar>. When opening files -from the built in terminal Kate will automatically select the current instance +from the built in terminal, Kate will automatically select the current instance if nothing else is indicated on the command line.</para> <sect2 id="old-behavior"> @@ -533,7 +539,7 @@ However, if you prefer the old &kate; behavior (one instance opens all files), you can easily achieve that by following this simple strategy: <itemizedlist> -<listitem><para>Make kate allways start with the <option>--use</option> +<listitem><para>Make &kate; always start with the <option>--use</option> parameter by adding that to the command in the application preferences, and additionally using a shell alias.</para></listitem> <listitem><para>Configure &kate; to load the last used session at startup.</para> @@ -552,9 +558,6 @@ and additionally using a shell alias.</para></listitem> <title>Getting Help</title> -<sect2> - -<title>With &kate;</title> <variablelist> <varlistentry> @@ -562,13 +565,13 @@ and additionally using a shell alias.</para></listitem> <listitem> <para>Offers detailed documentation on all menu commands, -configuration options, tools, dialogs, plugins &etc; as well as -descriptions of of the &kate; window, the editor and various concepts +configuration options, tools, dialogs, plugins &etc; as well as a +description of the &kate; window, the editor and various concepts used in the application.</para> <para>Press <keycap>F1</keycap> or use the -<menuchoice><guimenu>Help</guimenu></menuchoice> -<guisubmenu>Contents</guisubmenu> menu topic to view this +<menuchoice><guimenu>Help</guimenu> +<guimenuitem>Kate handbook</guimenuitem></menuchoice> menu topic to view this manual.</para></listitem> </varlistentry> @@ -576,19 +579,19 @@ manual.</para></listitem> <varlistentry id="whats-this"> <term>What's This Help</term> <listitem> -<para>What's This help offers immediate help with single elements of +<para>What's This Help offers immediate help with single elements of graphical windows, such as buttons or other window areas.</para> -<para>We strive to provide What's This help for any elements for which +<para>We strive to provide What's This Help for any element for which it makes sense. It is available throughout the configuration dialog, and in many other dialogs as well.</para> -<para>To employ What's This help, press +<para>To employ What's This Help, press <keycombo>&Shift;<keycap>F1</keycap></keycombo> or use the <menuchoice><guimenu>Help</guimenu><guimenuitem>What's This</guimenuitem></menuchoice> menu item to enable What's This mode. The cursor will turn into an arrow with a question mark, and you -can now click any element in the window to read the What's This help +can now click any element in the window to read the What's This Help for that element, if it is available.</para> </listitem> </varlistentry> @@ -603,19 +606,6 @@ documentation.</para> </varlistentry> </variablelist> -</sect2> - -<sect2> -<title>With Your Text Files</title> - -<para>&kate; does not (yet!) provide any means for reading document -related documentation. Depending on the file you are editing, you may -find the <link linkend="kate-mdi-tools-konsole">Built in -&konsole;</link> helpful for viewing related &UNIX; manual pages or -info documentation, or you can use &konqueror;.</para> - -</sect2> - </sect1> </chapter> diff --git a/doc/kate/index.docbook b/doc/kate/index.docbook index f2bc04f8c..01835025f 100644 --- a/doc/kate/index.docbook +++ b/doc/kate/index.docbook @@ -24,6 +24,7 @@ <author>&Anders.Lund; &Anders.Lund.mail;</author> <author>&Seth.Rothberg; &Seth.Rothberg.mail;</author> <author>&Dominik.Haumann; &Dominik.Haumann.mail;</author> +<author>&tde-authors;</author> <!-- TRANS:ROLES_OF_TRANSLATORS --> </authorgroup> @@ -42,7 +43,7 @@ </copyright> <copyright> <year>&tde-copyright-date;</year> -<holder>The &tde; Team</holder> +<holder>&tde-team;</holder> </copyright> <legalnotice>&FDLNotice;</legalnotice> @@ -123,7 +124,7 @@ configuration files. This document was written in &kate;. &kate;. Program copyright 2000, 2001, 2002 - 2005 by the &kate; developer team. </para> <para> -&kate;. Program copyright &tde-copyright-date; by the &tde; Team. +&kate;. Program copyright &tde-copyright-date; by &tde-team;. </para> <variablelist> @@ -245,7 +246,7 @@ documentation</para></listitem> <para>Documentation copyright 2002, 2003, 2005 &Anders.Lund; &Anders.Lund.mail;</para> -<para>Documentation copyright &tde-copyright-date; The &tde; Team.</para> +<para>Documentation copyright &tde-copyright-date; &tde-team;.</para> <!-- TRANS:CREDIT_FOR_TRANSLATORS --> &underFDL; <!-- FDL: do not remove --> |