From 4aed2c8219774f5d797760606b8489a92ddc5163 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/kate/menus.docbook | 1438 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 1438 insertions(+) create mode 100644 doc/kate/menus.docbook (limited to 'doc/kate/menus.docbook') diff --git a/doc/kate/menus.docbook b/doc/kate/menus.docbook new file mode 100644 index 000000000..26ae7551e --- /dev/null +++ b/doc/kate/menus.docbook @@ -0,0 +1,1438 @@ + + + + + + + +Menu Entries + + +The <guimenu>File</guimenu> Menu + + + + + + + +&Ctrl;N + +File +New + + + + +This command starts a new document in the editing +window. In the Documents list on the left the new file +is named Untitled. + + + + + + + + + +&Ctrl;O + +File +Open... + + + +Launches &kde;'s open file dialog box to let you open one or more files. + + + + + + + + + +File +Open Recent + + + + +This command allows you to open a file from a submenu +that contains a list of recently edited files. + + + + + + + + +File +Open With + + + + +This submenu presents a list of applications known to handle the mime type +of your current document. Activating an entry will open the current document +with that application. +In addition, a entry Other... command launches +the open with dialog box that allows you to select another application +to open the active file. Your file will still be open in &kate;. + + + + + + + + + +&Ctrl;S + +File +Save + + + + +This command saves your file. Use it often. If the file is +Untitled then +Save becomes +Save As. + + + + + + + + +File +Save As... + + + + +Name and rename files with this command. +It launches the save file dialog box. This dialog works just as +the open file dialog box does. You can use it to navigate through +your file system, preview existing files, or filter your file +view with file masks. + + + +Type the name you want to give the file you are saving in the +Location combo box and press the +OK button. + + + + + + + + + +&Ctrl;L + +File +Save All + + + + +This command saves all modified open files. + + + + + + + + + +F5 + +File +Reload + + + + +Reloads the active file. This command is +useful if another program or process has changed the file while you have +it open in &kate; + + + + + + + + + +&Ctrl;P + +File +Print... + + + + +Print the active file. + + + + + + + +File +Export as HTML... + + + + +Export your file in HTML format so your document can be viewed as a +web page. + + + + + + + +File +Mail... + + + + +Open your mail client and attach the file in the mail. + + + + + + + + + +&Ctrl;W + +File +Close + + + + +Close the active file with this command. If you +have made unsaved changes, you will be prompted to save +the file before &kate; closes it. + + + + + + + + +File +Close All + + + + +This command closes all the files you have open +in &kate;. + + + + + + + + + +&Ctrl;Q + +File +Quit + + + + +This command closes &kate; and any files you were +editing. If you have made unsaved changes to any of the files you were +editing, you will be prompted to save them. + + + + + + + +The <guimenu>Edit</guimenu> Menu +The Edit menu contains a host of commands, +all to work with the currently active document. + + +Menu Entries + + + + +&Ctrl;Z +Edit +Undo + + + +Undo the last editing command (typing, copying, cutting etc.) +If grouped undo is enabled, this may undo several editing commands of the same type, like typing in characters. + + + + + + + +&Ctrl;&Shift;Z +Edit +Redo + + + +Redo the last undo step. + + + + + + + +&Ctrl;X +Edit +Cut + + + +Removes selected text if any, and places a copy of the removed text in the clipboard. + + + + + + + +&Ctrl;C +Edit +Copy + + + +Copies selected text, if any, to the clipboard. + + + + + + + +Edit +Copy as HTML + + + +Copies selected text with the syntax highlight as HTML text. + + + + + + + +&Ctrl;V +Edit +Paste + + + +Copies the first item in the clipboard into the editor at cursor position. +If Overwrite Selection is enabled, the pasted text will overwrite the selection, if any. + + + + + + + +&Ctrl;A +Edit +Select All + + + +Selects all text in the editor. + + + + + + + +&Ctrl;&Shift;A +Edit +Deselect + + + +Deselects the selected text in the editor if any. + + + + + + + +&Ctrl;Shift +B +Edit +Block Selection Mode + + + +Toggles Selection Mode. When the Selection Mode is BLOCK, you can make vertical selections, +ie select column 5 to 10 in lines 9 to 15. +The status bar shows the current state of the Selection Mode, either NORM or BLK. + + + + + + + +&Ctrl;F +Edit +Find... + + + +Launch the Find Dialog to allow you to search for text in the edited document. + + + + + + + +F3 +Edit +Find Next + + + +Go to the nearest downwards match of the last text or regular expression searched for, starting from cursor position + + + + + + + +&Shift;F3 +Edit +Find Previous + + + +Go to the nearest upwards match of the last text or regular expression searched for, starting from cursor position + + + + + + + +&Ctrl;R +Edit +Replace... + + + +Launch the Replace Dialog to replace one or more instances of a defined text with something else. + + + + + + + +&Ctrl;G +Edit +Go to line... + + + +Launches the Go To Line Dialog, allowing you to enter the number of a line to find in +the document + + + + + + + + +The <guimenu>Document</guimenu> Menu +The Document menu provides a menu entry for each open document. +Clicking one of these will bring the requested document to focus. If you have +multiple frames, an editor for that document will be displayed in the currently +active frame. +In addition, commands to browse your open documents are provided: + +Menu items + + + + + +&Alt;Left +Document +Back + + + +This will bring the previous document in the stack in focus. If you have +multiple frames, an editor for the document will be displayed in the currently +active frame. The order is the order in which documents were +opened, rather than a logical history. This behavior may change in future +versions of &kate;. + + + + + + + +&Alt;Right +Document +Forward + + + +This will bring the next document in the stack in focus. If you have +multiple frames, an editor for the document will be displayed in the currently +active frame. +The order is the order in which the documents were opened, +rather than a logical history. This behavior may change in future versions of +&kate;. + + + + + + + +The <guimenu>View</guimenu> menu + +The View menu allows you to manage settings +specific to the active editor, and to manage frames. + + +Menu Items + + +F7 +ViewSwitch to Command Line + +This command will toggle the display of the +built in command line. + + + + +ViewSchema + +This menu lists the available schemas. You can change the schema +for the current view here, to change the default schema you need to +use the config dialog + + + + +F10 + +ViewDynamic Word Wrap + +Toggles dynamic word wrap in the current view. Dynamic word +wrap makes all the text in a view visible without the need for horizontal +scrolling by rendering one actual line on more visual lines as needed. + + + + +ViewShow/Hide Static Word +Wrap Marker +Toggles the display of a vertical line indicating the position +of the wrap width as configured in the config dialog. This +feature requires that you use a true fixed-width font. + + + + + + + +F6 +View +Show/Hide Icon Border + + + +This is a toggle item. Setting it on checked will make the Icon Border +visible in the left side of the active editor, and vice versa. + + + + + + + +F11 +View +Show/Hide Line Numbers + + + +This is a toggle Item. Setting it on checked will make a pane displaying +the line numbers of the document visible in the left border of the active editor, +and vice versa. + + + + +ViewShow/Hide Scrollbar +Marks +Toggles the visualization of bookmarks (and other marks) on the +vertical scrollbar. When enabled, marks are represented by a thin line in the +mark color at the scrollbar, middleclicking on the lines will scroll the view +to a position near the mark. + + + +F9 + +ViewShow/Hide Folding Markers + +Toggles the display of the folding marker pane in the left +side of the view. See Using +Code Folding. + + + + + + +Code Folding + + + + + + +&Ctrl; +Shift- +Collapse Toplevel + +Collapse all toplevel regions in the document. + + +&Ctrl; +Shift+ +Expand Toplevel + +Expand all toplevel regions in the document. + + +&Ctrl; +- +Collapse One Local Level + +Collapse the region closest to the cursor. + + +&Ctrl; ++ +Expand One Local Level + +Expand the region closest to the cursor. + + + + + + + + + + + +The <guimenu>Bookmarks</guimenu> Menu + +The Bookmarks menu allows you to work with +the bookmarks in the currently active document. + +Below the entries described here, one entry for each bookmark in +the active document will be available. The text will be the first few +words of the marked line. Choose an item to move the cursor to the +start of that line. The editor will scroll as necessary to make that +line visible. + + + +Menu Items + + + + + +&Ctrl;B +Bookmarks +Set/Clear Bookmark + + + +Sets or removes a bookmark in the current line of the active document. +(If it's there, it is removed, otherwise one is set.) + + + + + + + +Bookmarks +Clear All Bookmarks + + + +Clears (removes) all bookmarks in the active document. + + + + +&Alt; +Page Up +BookmarksPrevious + +This will move the cursor to beginning of the first above line +with a bookmark. The menuitem text will include the line number and the first +piece of text on the line. This item is only available when there is a bookmark +in a line above the cursor. + + + +&Alt; +Page Down +BookmarksNext +This will move the cursor to beginning of the next line with a +bookmark. The menuitem text will include the line number and the first piece of +text on the line. This item is only available when there is a bookmark in a line +below the cursor. + + + + + + + + +The <guimenu>Tools</guimenu> Menu + + + + +ToolsPipe to +Console +Feed the currently selected text ito the built in terminal +emulator. No newline is added after the text. + + + +ToolsExternal +Tools +This submenu contains all the external toolsyou have +configured. + + + + +Tools +Read Only Mode + +Set the current document to Read Only mode. This prevents any text +addition and any changes in the document formatting. + + + + + +Tools +Filletype + +Choose the filetype scheme you prefer for the active document. This +overwrites the global filetype +mode set in Settings Configure +Editor... in the Filetypes tab for your current +document only. + + + + + +Tools +Highlighting + +Choose the Highlighting scheme you prefer for the active document. This +overwrites the global highlighting mode set in +Settings Configure Editor... + for your current document only. + + + + + +Tools +Indentation + +Choose the style of +indentation you want for your active document. +This overwrites the global indentation mode set in +Settings Configure Editor... + for your current document only. + + + + + +Tools +Encoding + +You can overwrite the default encoding set in +Settings +Configure +Editor... in the Open/Save tab +to set a different encoding for your current document. The encoding you +set here will be only valid for your current document. + + + + + +Tools +End of Line + +Choose your prefered end of line mode for your active +document. This overwrites the global end of line mode set in +Settings Configure Editor... + for your current document only. + + + + + +ToolsSpelling... + + +This initiates the spellchecking program - a program +designed to help the user catch and correct any spelling errors. +Clicking on this entry will start the checker and bring up the speller dialog +box through which the user can control the process. There are four settings +lined up vertically in the center of the dialog with their corresponding labels +just to the left. Starting at the top they are: + + + +Unknown word: +Here, the spellchecker indicates the word currently under +consideration. This happens when the checker encounters a word not in its +dictionary - a file containing a list of correctly spelled words against which +it compares each word in the editor. + + +Replace with: + If the checker has any similar words in its dictionary the +first one will be listed here. The user can accept the suggestion, type in his +or her own correction, or choose a different suggestion from the next +box. + + +Suggested Words: + The checker may list here a number of possible replacements for +the word under consideration. Clicking on any one of the suggestions will cause +that word to be entered in the Replacement: box, +above. + + +Language: + If you have installed multiple dictionaries, here you can +select which dictionary/language should be used. + + + +On the right side of the dialog box are 5 buttons that allow the user to +control the spellcheck process. They are: + + + +Add to Dictionary +Pressing this button adds the word in the Misspelled +Word: box to the checker's dictionary. This means that in the future +the checker will always consider this word to be correctly +spelled. + + +Replace + This button has the checker replace the word under +consideration in the document with the word in the +Replacement: box. + + +Replace All + This button causes the checker to replace not only the current +Unknown word: but to automatically make the same +substitution for any other occurrences of this Misspelled +Word: in the document. + + +Ignore +Activating this button will have the checker move on without +making any changes. + + +Ignore All + This button tells the checker to do nothing with the current +Unknown word: and to pass over any other instances of +the same word. This only applies to the current spellcheck +run. If the checker is run again later it will stop on this same +word. + + + +Three more buttons are located horizontally along the bottom of the +spellcheck dialog. They are: + + + +Help + This invokes the &kde; help system starting at the &kate; help +pages (this document). + + + +Finished + This button ends the spellcheck process, and returns to the +document. + + + +Cancel + This button cancels the spellcheck process, all modifications +are reverted, and you will return to your document. + + + + + + + + + +Tools +Spelling (from cursor)... + +This initiates the spellchecking program but it starts where your cursor +is instead of at the beginning of the document. + + + + + +Tools +Spellcheck Selection... + +Spellchecks the current selection. + + + + + + +&Ctrl;I + +ToolsIndent + +This increases the paragraph's indentation by one step. The size of the +step depends on the indentation +settings. + + + + + + +&Ctrl;&Shift;I + +ToolsUnindent + + +This reduces the paragraph's indentation by one step. The size of the step + +depends on the indentation settings. + + + + + + +ToolsClean +Indentation +This cleans the indentation for the current selection or for the +line the cursor is currently in. Cleaning the indentation ensures that +all your selected text follows the indentation mode you choose. + + + + + +Tools +Align + + +Causes a realign of the current line or selected lines using the +indentation mode and indentation settings in the doucment. + + + + + + +&Ctrl;D + +Tools +Comment + +This adds one space to the beginning of the line +where the text cursor is located or to the beginning of any +selected lines. + + + + + + +&Ctrl;&Shift;D + +Tools +Uncomment + +This removes one space (if any exist) from the beginning of the +line where the text cursor is located or from the beginning of any +selected lines. + + + + + +&Ctrl;U + +Tools +Uppercase + +Put the selected text or the letter after the cursor in +uppercase. + + + + + +&Ctrl;&Shift;U + +Tools +Lowercase + +Put the selected text or the letter after the cursor in +lowercase. + + + + + +&Alt;&Ctrl;U + +Tools +Capitalize + +Capitalize the selected text or the current +word. + + + + + +&Ctrl;J + +Tools +Join Lines + +Joins the selected lines, or the current line and the line below +with one white space character as a separator. Leading/trailing white space on +joined lines is removed in the affected ends. + + + + +Tools +Word Wrap Document + +Apply static word wrapping on all the document. That means that +a new line of text will automatically start when the current +line exceeds the length specified by the Wrap words at: option +in the Editing tab in +SettingsConfigure +Editor... + + + + + + + + +The <guimenu>Sessions</guimenu> Menu + +This menu contains entries for using and managing &kate; sessions. +For more information, read Using Sessions. + + + + +Sessions +New +Creates a new empty session. All currently open files will +be closed. + + + + +SessionsOpen... + +Open an existing session. The Session Chooser dialog is +displayed to let you choose one. + + + +SessionsQuick Open + +This submenu lets you open an existing session. + + + + +SessionsSave + +Save the current session. If the session is anonymous, you will +be prompted for a session name. + + + +SessionsSave +As... +Save the current session under a new name. You are prompted for +a name to use. + + + +SessionsManage... + +Displays the Session Manager dialog which allows you to rename +and delete sessions. + + + + + + + + + +The <guimenu>Settings</guimenu> Menu + +The Settings menu allows you to change the properties +of the main window, such as showing/hiding toolbars, and provides +access to the configuration dialogs. + + + + + + + +Settings +Toolbars + + + +This submenu lists the available toolbars, each item toggles the display +of the associated toolbar. + + + + +SettingsFull Screen +Mode +Toggles full screen display. +This commmand will be moved to the Window menu in a future +version of &kate; + + + + + + + +Settings +Configure Shortcuts... + + + +Display the familiar &kde; Keyboard Shortcut Configuration +Dialog. + + + + + + + + +Settings +Configure Toolbars... + + + +Display the familiar &kde; Toolbar Configuration Dialog. + + + + + + + +Settings +Configure &kate;... + + + +Launch the Main Configuration Dialog + + + + + + + + +the <guimenu>Window</guimenu> Menu + + + + + + +Window +New Window + + + + +Opens another instance of &kate;. +The new instance will be identical to your previous instance. + + + + + + + + +&Ctrl;&Shift;L +Window +Split Vertical + + + +This will split the frame (which may be the main editing area) in two equally sized frames, +the new one to the left of the current one. The new frame gets the focus, and will display the +same document as the old one. +See also Working with the &kate; MDI + + + + + + + +&Ctrl;&Shift;T +Window +Split Horizontal + + + +Splits the current frame (which may be the main editing area) in two equally sized frames, +the new one at the bottom half. The new frame gets the focus, and displays the same document as +the old one. +See also Working with the &kate; MDI + + + + + + + +&Ctrl;&Shift;R +Window +Close Current + + + +Closes the active frame. This is disabled, if there is only one frame +(the main editing area). No documents get closed by closing a +frame – they will still be available in the Documents Menu as well as in +the File List. See also Working with the +&kate; MDI + + + + +F8 +WindowNext +View +Focus the next document view, if you have split the editor area +in more views. + + + +&Shift;F8 +WindowPrevious +View +Focus the previous document view, if you have split the editor +area in more views. + + + +WindowTool Views + + + + + +WindowTool Views +Show/Hide Sidebars +Toggles the display of the sidebar button rows. This command +does not affect the display of the sidebar content widgets, any sidebar that +is visible will stay visible, and if you assigned shortcuts to the below +commands those will of course continue to work. + + + + + + +WindowTool Views +Show Documents + + + +Toggle the display of &kate;'s Documents list + + + + + + + +WindowTool Views +Show/Hide Filesystem Browser + + + +Toggle the display of &kate;'s Filesystem Browser + + + + + + + +WindowTool Views +Show/Hide Find in Files + + + +Toggle the display of &kate;'s Find in Files tool. + + + + + + + + +WindowTool Views +Show/Hide Terminal + + + +Toggles the display of the built in terminal emulator. +When activated the first time, the terminal will be created. +When the terminal emulator is displayed, it will get the focus, so that +you can start typing in commands immediately. If the Sync Konsole with Active +Document option is enabled in the General Page of the Main configuration dialog the shell session will +change to the directory of the active document, if it is a local file. + + + + + + + + + + + + + + +The <guimenu>Help</guimenu> Menu + +Apart from standard &kde; Help menu items +described below you will have menu entries to show the +Plugins User Manuals for installed plugins. + +&help.menu.documentation; + + + + -- cgit v1.2.1