From 2b062a105808bf0c830e7e8432e6d0dcf00b6d97 Mon Sep 17 00:00:00 2001 From: Michele Calgaro Date: Sun, 19 Jan 2014 23:29:24 +0900 Subject: Kate handbook review - chapter 2 --- doc/kate/fundamentals.docbook | 198 ++++++++++++++++++++---------------------- 1 file changed, 94 insertions(+), 104 deletions(-) (limited to 'doc/kate/fundamentals.docbook') 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 @@ If you have ever used a text editor, you will have no problem using &kate;. In the next two sections, Starting -&kate; and in Working with -&kate;, we'll show you everything you need to get up and running +&kate; and Working with +&kate;, you will find everything you need to get up and running quickly. @@ -27,7 +27,7 @@ command line. From the Menu Open the &tde; program menu by clicking on the -big K icon on the toolbar at the bottom left of your +big T icon on the toolbar at the bottom left of your screen. This will raise the program menu. Move your cursor up the menu to the Utilities Editors menu item. A list @@ -59,19 +59,19 @@ file. -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. -%kate +%kate Command Line Options -&kate; accepts following command line options: +&kate; accepts the following command line options: @@ -88,22 +88,70 @@ This lists the most basic options available at the command line. -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;. -kate +kate -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;. + + + + + +kate + + +This lists the available &tde;-tempfile specific options. + + + + + +kate + + + +This lists all of the command line options. + + + + + +kate + + + +Lists &kate;'s authors in the terminal window. + +kate + + + +Lists version information for &Qt;, &tde;, and &kate;. + + + + + +kate + + + +Shows license information. + + + + + kate name @@ -125,12 +173,23 @@ well. 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. + +kate + + + +If the multiple document interface (MDI) setting is enabled, forces &kate; to +use the single document interface (SDI) mode. + + + + kate PID @@ -144,7 +203,7 @@ Only reuses an instance with the specified PID (Process ID). Used with the kate - encoding + encoding URL Uses the specified encoding for the document. @@ -152,7 +211,7 @@ Only reuses an instance with the specified PID (Process ID). Used with the kate - line + line URL Navigates to the specified line after opening the document. @@ -160,7 +219,7 @@ Only reuses an instance with the specified PID (Process ID). Used with the kate - column + column URL Navigates to the specified column after opening the document. @@ -168,7 +227,7 @@ Only reuses an instance with the specified PID (Process ID). Used with the kate - + Reads the document content from STDIN. This is similar to the common option used in many command line programs, and allows you to pipe command output into &kate;. @@ -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. - -kate - - - -This lists all of the command line options. - - - - - -kate - - - -Lists &kate;'s authors in the terminal window. - - - - - -kate - - - -Lists version information for &Qt;, &tde;, and &kate;. - - - - - -kate - - - -Shows license information. - - - - @@ -288,21 +307,8 @@ flexibility. In this section we'll look at three items: -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. - - - - -If you have grabbed the two parallel lines successfully your mouse -pointer will turn into two crossed arrows as you drag. - - +Toggles the Documents on and off. If the Documents/Filesystem Browser side bar +window is not open, &kate; will open the side bar window. @@ -411,11 +417,11 @@ text) &Ctrl;F - Find +Find F3 - Find again +Find again &Ctrl;B @@ -441,7 +447,7 @@ text) &Ctrl;R - Replace +Replace &Ctrl;S @@ -458,11 +464,11 @@ text) &Ctrl;Z -Undo +Undo &Ctrl;&Shift;Z -Redo +Redo @@ -514,14 +520,14 @@ the start of the window title, which then have the form When opening files on the command line with 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 with an empty string: ''. Since &kate; 2.5.1 the PID of the current instance is exported to the environment variable KATE_PID. 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. @@ -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: -Make kate allways start with the +Make &kate; always start with the parameter by adding that to the command in the application preferences, and additionally using a shell alias. Configure &kate; to load the last used session at startup. @@ -552,9 +558,6 @@ and additionally using a shell alias. Getting Help - - -With &kate; @@ -562,13 +565,13 @@ and additionally using a shell alias. 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. Press F1 or use the -Help -Contents menu topic to view this +Help +Kate handbook menu topic to view this manual. @@ -576,19 +579,19 @@ manual. What's This Help -What's This help offers immediate help with single elements of +What's This Help offers immediate help with single elements of graphical windows, such as buttons or other window areas. -We strive to provide What's This help for any elements for which +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. -To employ What's This help, press +To employ What's This Help, press &Shift;F1 or use the HelpWhat's This 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. @@ -603,19 +606,6 @@ documentation. - - - -With Your Text Files - -&kate; does not (yet!) provide any means for reading document -related documentation. Depending on the file you are editing, you may -find the Built in -&konsole; helpful for viewing related &UNIX; manual pages or -info documentation, or you can use &konqueror;. - - - -- cgit v1.2.1