[kde-doc-english] [kate/KDE/4.10] doc/kate: updates to menus and config for 4.10

T.C. Hollingsworth tchollingsworth at gmail.com
Sun Feb 10 18:38:11 UTC 2013


Git commit 5814ce396a32db81351b4f029ca3abb1248f7977 by T.C. Hollingsworth.
Committed on 03/02/2013 at 01:21.
Pushed by hollingsworth into branch 'KDE/4.10'.

updates to menus and config for 4.10

still needs a few items addressed, like one new color scheme option
I don't know what's for and all the new scripts still need to be
documented
(cherry picked from commit 28fc3e0655ed8e4dfa88a5226a9cd298b337f20b)

M  +25   -69   doc/kate/configuring-part.docbook
M  +34   -23   doc/kate/configuring.docbook
M  +142  -126  doc/kate/menus.docbook

http://commits.kde.org/kate/5814ce396a32db81351b4f029ca3abb1248f7977

diff --git a/doc/kate/configuring-part.docbook b/doc/kate/configuring-part.docbook
index cb7cbd2..5a6378b 100644
--- a/doc/kate/configuring-part.docbook
+++ b/doc/kate/configuring-part.docbook
@@ -6,7 +6,7 @@
 <link linkend="pref-open-save-modes-filetypes">defining a filetype</link>,
 by <ulink url="help:/kate/config-variables.html">Document Variables</ulink> or
 by changing them per document during an editing session.</para>
-<sect2 id="appearance"> <!-- updated to 4.7 + synced with kwrite -->
+<sect2 id="appearance"> <!-- updated to 4.10 -->
 <title>Appearance</title>
 
 <sect3 id="appearance-general">
@@ -125,12 +125,16 @@ will show marks on the vertical scrollbar. These marks will
 for instance show bookmarks.</para></listitem>
 </varlistentry>
 <varlistentry>
-<term><guilabel>Show Mini-Map
-</guilabel></term>
+<term><guilabel>Show scrollbar mini-map</guilabel></term>
 <listitem><para>If this option is checked, every new view will show a mini map of the 
 <!--FIXME remove when next option is enabled-->whole<!--FIXME--> 
 document on the vertical scrollbar.</para></listitem>
 </varlistentry>
+<varlistentry>
+<term><guilabel>Minimap Width</guilabel></term>
+<listitem><para>Adjusts the width of the scrollbar mini-map, defined in pixels.
+</para></listitem>
+</varlistentry>
 <!--FIXME disabled in 4.10/master
 <varlistentry>
 <term><guilabel>Map the whole document
@@ -237,15 +241,6 @@ from the Normal text background helps to keep focus on the current line.
 operation.</para></listitem>
 </varlistentry>
 
-<!--<varlistentry id="variable-pref-colors-marks">
-<term><guilabel>Bookmark</guilabel></term>
-<listitem><para>This combobox lets you set overlay colors for various mark types.
-The color is mixed into the background color of a marked line, so that a line
-with more marks or a marked line that is current has a background that is a mix
-of more colors. The mark colors are also used if you enable display of scrollbar
-marks.</para></listitem>
-</varlistentry>-->
-
 </variablelist>
 </listitem>
 </varlistentry>
@@ -268,6 +263,8 @@ marker borders in the left side of the editor view when they are displayed.
 the view when displayed.</para></listitem>
 </varlistentry>
 
+<!--FIXME: Missing Seperator - not sure what that is-->
+
 <varlistentry>
 <term><guilabel>Word Wrap Marker</guilabel></term>
 <listitem><para>This color is used to draw a pattern to the left of dynamically
@@ -319,6 +316,12 @@ enabled.</para></listitem>
 </varlistentry>
 
 <varlistentry>
+<term><guilabel>Indentation Line</guilabel></term>
+<listitem><para>This color is used to draw a line to the left of indented blocks,
+if <link linkend="appearance-general">that feature is enabled</link>.</para></listitem>
+</varlistentry>
+
+<varlistentry>
 <term><guilabel>Bracket Highlight</guilabel></term>
 <listitem><para>This color is used to draw the background of matching brackets.
 </para></listitem>
@@ -443,6 +446,9 @@ Here you can choose the font for the schema.  You can choose from
 any font available on your system, and set a default size. A sample text
 displays at the bottom of the dialog, so you can see the effect of your choices.
 </para>
+<para>For more information about selecting a font, see the 
+<ulink url="help:/funadmentals/fonts.html"><emphasis>Choosing Fonts</emphasis>
+section of the <emphasis>&kde; Fundamentals</emphasis> documentation</ulink>.</para>
 </sect3>
 
 <sect3 id="prefcolors-normal-text-styles">
@@ -863,7 +869,7 @@ commands.</para>
 <variablelist>
 
 <varlistentry>
-<term><guilabel>Encoding:</guilabel></term>
+<term><guilabel>Encoding</guilabel></term>
 <listitem>
 <para>This defines the standard encoding to use to open/save files, if not changed
 in the open/save dialog or by using a command line option.</para>
@@ -897,7 +903,7 @@ detection will run, if both fail fallback encoding will be tried.</para>
 </varlistentry>
 
 <varlistentry>
-<term><guilabel>End of line:</guilabel></term>
+<term><guilabel>End of line</guilabel></term>
 <listitem>
 <para>Choose your preferred end of line mode for your active
 document. You have the choice between &UNIX;, DOS/&Windows; or Macintosh.</para>
@@ -1154,65 +1160,15 @@ from the &kappname; website.
 </sect2>
 
 <sect2 id="pref-plugins">
-<title>Extensions</title> <!-- updated to 4.7 + synced with kwrite -->
-<para>The <guilabel>Plugins</guilabel> tab lists all available plugins and you can check those you
+<title>Extensions</title> <!-- updated to 4.10 -->
+<para>The <guilabel>Extensions</guilabel> tab lists all available plugins and you can check those you
 want to use. Click on the <guibutton>Information</guibutton> button to open the
 <guilabel>About</guilabel> dialog of this plugin.</para>
 <para>Once a configurable plugin is checked, the
 <guibutton>Configure</guibutton> button is enabled and you can click it
 in order to configure the highlighted plugin.</para>
-<!--FIXME duplicated content also in plugins.docbook-->
-<variablelist>
-<title>Editor Component Plugins</title>
-<!-- not released with 4.7
-<varlistentry>
-<term><guilabel>Artistic Comment</guilabel></term>
-<listitem><para>Format long source-code comments like license-headers
-or descriptions using different style.</para></listitem>
-</varlistentry>
--->
-<varlistentry>
-<term><guilabel>AutoBrace</guilabel></term>
-<listitem><para>The autobrace plugin supersedes the &kappname; internal
-<quote>Auto Brackets</quote> feature.
-It automatically inserts a closing brace <keycap>}</keycap> at the beginning
-of the next line after ending a line with an opening one <keycap>{</keycap>
-and pressing the &Enter; key.</para></listitem>
-</varlistentry>
-<!--http://jakob.petsovits.at/topic/kate-->
-<!--Right, it's the automatic insertion of a closing brace ("}") after you ended a line with an opening one ("{"). Kate's standard insertion of parentheses, brackets and braces is simply too obtrusive for me, so even if I tried it several times I always had to disable it again because I can't stand it. So here's how AutoBrace works.
-You, the developer, are writing a line of code, and want to open a new block delimited by braces. Looks like this:
-If you press Enter and AutoBrace is enabled, it will insert your favorite new brace where it belongs. Looks like this:
--->
-<varlistentry>
-<term><guilabel>Exporter</guilabel></term>
-<listitem><para>This command allows you to export the current document with all highlighting
-information into a HTML document using <menuchoice><guimenu>File</guimenu><guimenuitem>Export
-as HTML</guimenuitem></menuchoice>. Additionally you can use <menuchoice><guimenu>Edit</guimenu>
-<guimenuitem>Copy as HTML</guimenuitem></menuchoice> to copy the currently selected text
-as HTML to the system clipboard.</para></listitem>
-</varlistentry>
-<!--FIXME not in master, but in 4.10 ??-->
-<varlistentry>
-<term><guilabel>Highlight Selection</guilabel></term>
-<!--http://kate-editor.org/2010/11/14/highlight-selected-text/-->
-<listitem><para>Highlights all words that match the currently selected text.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term><guilabel>IconInserter</guilabel></term>
-<listitem><para>The icon inserter plugin is only of use for &kde; developers: It adds an item
-<guimenuitem>Insert KIcon-Code</guimenuitem> into the context menu of the editor.
-If activated, the &kde;'s icon chooser opens (showing application icons, action icons &etc;..).
-If you click on it, the file name without file extension will be inserted as
-text. Useful only for setting icons via &kde;'s framework through the KIcon() class.
-</para></listitem>
-</varlistentry>
-<varlistentry>
-<term><guilabel>Insert File</guilabel></term>
-<listitem><para>This plugin allows you to insert any readable file at the cursor position.
-If enabled, the <guimenu>Tools</guimenu> menu has an additional menu item
-<guimenuitem>Insert File</guimenuitem>.</para></listitem>
-</varlistentry>
-</variablelist>
+
+<para>For more information on the available plugins, see 
+<xref linkend="plugins"/>.</para>
 </sect2>
 </sect1>
diff --git a/doc/kate/configuring.docbook b/doc/kate/configuring.docbook
index e578765..a768cfe 100644
--- a/doc/kate/configuring.docbook
+++ b/doc/kate/configuring.docbook
@@ -134,14 +134,6 @@ reasonably sized.</para></listitem>
 </listitem>
 </varlistentry><!-- /meta data group -->
 
-<varlistentry>
-<term><anchor id="config-general-default-text-editing-component"/>
-<guilabel>Default text-editing component</guilabel></term>
-<listitem><para>Select the text-editing component used by &kate;.  By
-default, it is configured to use the system default text-editing component as
-configured in &systemsettings;.</para></listitem>
-</varlistentry>
-
 </variablelist>
 </sect2>
 
@@ -203,6 +195,22 @@ window configuration) will always be saved.</para>
 
 </sect2>
 
+<sect2 id="config-dialog-plugins">
+<title>Plugins</title>
+
+<para>This page provides a list of installed plugins for the &kate;
+application. Each plug-in is represented with its name and a short description.
+You can check the checkbox with an item to enable the plug-in it represents.
+</para>
+
+<para>If a plug-in provides configuration options, a section to access those
+will appear as a child of this page.</para>
+
+<para>For more information about the available plugins, see 
+<xref linkend="plugins"/>.</para>
+
+</sect2>
+
 <sect2 id="config-dialog-treeview">
 <title>Documents</title> <!-- Tree View was renamed to Documents - http://commit-digest.org/issues/2011-08-28/ -->
 <!-- Tree View plugin http://kate-editor.org/2010/09/10/tree-view-plugin-introduction/ -->
@@ -215,34 +223,37 @@ enabled. See the section about <link
 linkend="kate-mdi-tools-file-list">The Document List</link> for more about
 this feature.</para></listitem>
 </varlistentry>
+
 <varlistentry>
 <term><guilabel>Sort By</guilabel></term>
 <listitem><para>Set how you want the document list sorted. This can be set
 from the &RMB; menu in the document list as well.</para></listitem>
 </varlistentry>
-<!--
-View Mode - Tree View / List View missing
-  -->
+
 <varlistentry>
 <term><guilabel>Show Full Path</guilabel></term>
 <listitem><para>When enabled, in tree mode, top level folders will show up
 with their full path rather than just the last folder name.</para></listitem>
 </varlistentry>
 
-</variablelist>
-
-</sect2>
-
-<sect2 id="config-dialog-plugins">
-<title>Plugins</title>
+<varlistentry>
+<term><guilabel>View Mode</guilabel></term>
+<listitem><para>This provides two options that effect the display of the
+Documents tool view.  The <guilabel>Tree View</guilabel> option will display
+the documents in a tree underneath the folders they are in, while the
+<guilabel>List View</guilabel> option will display a flat list of documents.
+</para></listitem>
+</varlistentry>
 
-<para>This page provides a list of installed plugins for the &kate;
-application. Each plug-in is represented with its name and a short description.
-You can check the checkbox with an item to enable the plug-in it represents.
-</para>
+<varlistentry>
+<term><guilabel>Show Full Path</guilabel></term>
+<listitem><para>When Tree View and this option are enabled, the folder entries
+displayed in the Documents tool view will display the full filesystem path to 
+the folder in addition to the name of the folder.  It has no effect in List
+View.</para></listitem>
+</varlistentry>
 
-<para>If a plug-in provides configuration options, a section to access those
-will appear as a child of this page.</para>
+</variablelist>
 
 </sect2>
 
diff --git a/doc/kate/menus.docbook b/doc/kate/menus.docbook
index d843545..a0fe2c7 100644
--- a/doc/kate/menus.docbook
+++ b/doc/kate/menus.docbook
@@ -7,6 +7,8 @@
 </chapterinfo>
 <title>Menu Entries</title>
 
+<!--FIXME: use formatting and anchors consistently throughout this docbook-->
+
 <sect1 id="file-menu">
 <title>The File Menu</title>
 
@@ -370,10 +372,22 @@ all to work with the currently active document.</para>
 <note><para>If Overwrite Selection is enabled, the pasted text will overwrite the selection, if any.</para></note>
  </listitem>
 </varlistentry>
-<!--FIXME
-Clipboard history
-list of items copied to clipboard
-  -->
+
+<varlistentry>
+<term>
+<anchor id="edit-clipboard-history"/>
+<menuchoice>
+<guimenu>Edit</guimenu>
+<guisubmenu>Clipboard History</guisubmenu>
+</menuchoice>
+</term>
+<listitem>
+<para>This submenu will display the beginning of portions of text recently
+copied to the clipboard.  Select an item from this menu to paste it in the
+currently open file.</para>
+</listitem>
+</varlistentry>
+
 <varlistentry>
 <term>
 <anchor id="edit-select-all"/>
@@ -721,9 +735,63 @@ the File List.</para> <para>See also <link linkend="kate-mdi">Working with the
 &kate; MDI</link></para>
 </listitem>
 </varlistentry>
-<!-- FIXME missing
-Split View -> Move Splitter Left/Right/Up/Down
-  -->
+
+<varlistentry>
+<term>
+<anchor id="view-move-splitter-left"/>
+<menuchoice>
+<guimenu>View</guimenu><guisubmenu>Split View</guisubmenu>
+<guimenuitem>Move Splitter Left</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>When Split View is enabled, this will move the border in between two
+vertically split documents further left.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<anchor id="view-move-splitter-right"/>
+<menuchoice>
+<guimenu>View</guimenu><guisubmenu>Split View</guisubmenu>
+<guimenuitem>Move Splitter Right</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>When Split View is enabled, this will move the border in between two
+vertically split documents further right.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<anchor id="view-move-splitter-up"/>
+<menuchoice>
+<guimenu>View</guimenu><guisubmenu>Split View</guisubmenu>
+<guimenuitem>Move Splitter Up</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>When Split View is enabled, this will move the border in between two
+horizontally split documents further up.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<anchor id="view-move-splitter-down"/>
+<menuchoice>
+<guimenu>View</guimenu><guisubmenu>Split View</guisubmenu>
+<guimenuitem>Move Splitter Down</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>When Split View is enabled, this will move the border in between two
+horizontally split documents further down.</para>
+</listitem>
+</varlistentry>
+
 <varlistentry>
 <term><menuchoice><guimenu>View</guimenu><guisubmenu>Tool Views</guisubmenu>
 </menuchoice></term>
@@ -775,7 +843,7 @@ change to the directory of the active document, if it is a local file.</para>
 enabled by default.</para>
 </listitem>
 </varlistentry>
-<!--FIXME depending on selected plugins more items here e.g. Show Snippets -->
+
 </variablelist>
 </listitem>
 </varlistentry>
@@ -802,8 +870,8 @@ interactively. For more information, see
 <varlistentry>
 <term><menuchoice><guimenu>View</guimenu><guisubmenu>Schema</guisubmenu>
 </menuchoice></term>
-<listitem><para>This menu lists the available schemas. You can change the schema
-for the current view here, to change the default schema you need to
+<listitem><para>This menu lists the available color schemes. You can change the 
+schema for the current view here, to change the default schema you need to
 use the <link linkend="prefcolors">Fonts & Colors</link> page
 of the config dialog.</para>
 </listitem>
@@ -883,7 +951,24 @@ 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.</para></listitem>
 </varlistentry>
-<!--FIXME Show Mini-Map missing-->
+
+<varlistentry>
+<term><menuchoice><guimenu>View</guimenu><guimenuitem>Show Scrollbar
+Minimap</guimenuitem></menuchoice></term>
+<listitem><para>This will replace the scrollbar with a visualization of the
+current document. <!--FIXME: describe this functionality in detail in on of the
+other sections and link to it here--></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>View</guimenu><guimenuitem>Show Scrollbar
+Marks</guimenuitem></menuchoice></term>
+<listitem><para>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.</para></listitem>
+</varlistentry>
+
 <varlistentry>
 <term><menuchoice><shortcut><keycombo action="simul"><keycap>F9</keycap>
 </keycombo></shortcut>
@@ -903,6 +988,7 @@ Code Folding</link>.</para></listitem>
 <listitem><para>These options pertain to
 <link linkend="advanced-editing-tools-code-folding">code folding</link>:</para>
 <variablelist>
+
 <varlistentry>
 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;
 <keycap>-</keycap></keycombo></shortcut>
@@ -910,6 +996,7 @@ Code Folding</link>.</para></listitem>
 </term>
 <listitem><para>Collapse the region that contains the cursor.</para></listitem>
 </varlistentry>
+
 <varlistentry>
 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;
 <keycap>+</keycap></keycombo></shortcut>
@@ -917,13 +1004,23 @@ Code Folding</link>.</para></listitem>
 </term>
 <listitem><para>Expand the region that contains the cursor.</para></listitem>
 </varlistentry>
+
 <varlistentry>
 <term><menuchoice>
 <guimenuitem>Unfold All Nodes</guimenuitem></menuchoice>
 </term>
 <listitem><para>Expand all regions in the document.</para></listitem>
 </varlistentry>
-<!--FIXME Fold Multiline Comments missing -->
+
+<varlistentry>
+<term><menuchoice>
+<guimenuitem>Fold Multiline Comments</guimenuitem></menuchoice>
+</term>
+<listitem><para>Fold all multiline comments in the document.  (For example,
+this will fold all comments that use <code>/* comment */</code> syntax in C-like
+programming languages.)</para></listitem>
+</varlistentry>
+
 <varlistentry>
 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;
 &Shift;<keycap>-</keycap></keycombo></shortcut>
@@ -931,24 +1028,28 @@ Code Folding</link>.</para></listitem>
 </term>
 <listitem><para>Collapse all toplevel regions in the document.</para></listitem>
 </varlistentry>
+
 <varlistentry>
 <term><menuchoice>
 <guimenuitem>Fold Nodes in Level 2</guimenuitem></menuchoice>
 </term>
 <listitem><para>Collapse all level 2 nodes in the document.</para></listitem>
 </varlistentry>
+
 <varlistentry>
 <term><menuchoice>
 <guimenuitem>Fold Nodes in Level 3</guimenuitem></menuchoice>
 </term>
 <listitem><para>Collapse all level 3 nodes in the document.</para></listitem>
 </varlistentry>
+
 <varlistentry>
 <term><menuchoice>
 <guimenuitem>Fold Nodes in Level 4</guimenuitem></menuchoice>
 </term>
 <listitem><para>Collapse all level 4 nodes in the document.</para></listitem>
 </varlistentry>
+
 <varlistentry>
 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;
 &Shift;<keycap>+</keycap></keycombo></shortcut>
@@ -956,25 +1057,30 @@ Code Folding</link>.</para></listitem>
 </term>
 <listitem><para>Expand all toplevel regions in the document.</para></listitem>
 </varlistentry>
+
 <varlistentry>
 <term><menuchoice>
 <guimenuitem>Unfold Nodes in Level 2</guimenuitem></menuchoice>
 </term>
 <listitem><para>Expand all level 2 nodes in the document.</para></listitem>
 </varlistentry>
+
 <varlistentry>
 <term><menuchoice>
 <guimenuitem>Unfold Nodes in Level 3</guimenuitem></menuchoice>
 </term>
 <listitem><para>Expand all level 3 nodes in the document.</para></listitem>
 </varlistentry>
+
 <varlistentry>
 <term><menuchoice>
 <guimenuitem>Unfold Nodes in Level 4</guimenuitem></menuchoice>
 </term>
 <listitem><para>Expand all level 4 nodes in the document.</para></listitem>
 </varlistentry>
-</variablelist></listitem>
+</variablelist>
+
+</listitem>
 </varlistentry>
 
 <varlistentry>
@@ -1128,9 +1234,7 @@ and delete sessions.</para></listitem>
 <title>The Tools Menu</title>
 
 <variablelist>
-  <!-- the  first 4 items are only in the menu if the plugin is enabled
-  add this info (different variablelists one for terminal + one for main items?
-  -->
+
 <varlistentry>
 <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Pipe to
 Terminal</guimenuitem></menuchoice></term>
@@ -1371,113 +1475,15 @@ is underlined in the document on-the-fly.</para>
 <guimenu>Tools</guimenu><guisubmenu>Spelling</guisubmenu><guimenuitem>Spelling...</guimenuitem></menuchoice>
 </term>
 
-<!--para>These options are described in the documentation for the
-<ulink url="help:/sonnet/index.html">Check Spelling Dialog</ulink>.</para
-Move / merge the following into kdelibs/doc/sonnet/index.docbook and replace it with the para above
--->
-
 <listitem><para><action>This initiates the spellchecking program - a program
-designed to help the user catch and correct any spelling errors.</action>
-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:</para>
-
-<variablelist>
-<varlistentry>
-<term><guilabel>Unknown word:</guilabel></term>
-<listitem><para>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.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term><guilabel>Replace with:</guilabel></term>
-<listitem><para> 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.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term><guilabel>Language:</guilabel></term>
-<listitem><para> If you have installed multiple dictionaries, here you can
-select which dictionary/language should be used.</para></listitem>
-</varlistentry>
-</variablelist>
+designed to help the user catch and correct any spelling errors.</action></para>
 
-<para>On the right side of the dialog box are 6 buttons that allow the user to
-control the spellcheck process.  They are:</para>
-
-<variablelist>
-<varlistentry>
-<term><guibutton>Add to Dictionary</guibutton></term>
-<listitem><para>Pressing this button adds the <guilabel>Unknown word
-</guilabel> to the checker's dictionary. This means that in the future
-the checker will always consider this word to be correctly
-spelled.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term><guilabel>Suggest</guilabel></term>
-<listitem><para> 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 <guilabel>Replace with</guilabel> box,
-above.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term><guibutton>Replace</guibutton></term>
-<listitem><para> This button has the checker replace the word under
-consideration in the document with the word in the
-<guilabel>Replace with</guilabel> box.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term><guibutton>Replace All</guibutton></term>
-<listitem><para> This button causes the checker to replace not only the current
-<guilabel>Unknown word:</guilabel> but to automatically make the same
-substitution for any other occurrences of this <guilabel>Unknown word</guilabel>
-in the document.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term><guibutton>Ignore</guibutton></term>
-<listitem><para>Activating this button will have the checker move on without
-making any changes.</para></listitem>
-</varlistentry>
-<varlistentry>
-<term><guibutton>Ignore All</guibutton></term>
-<listitem><para> This button tells the checker to do nothing with the current
-<guilabel>Unknown word:</guilabel> and to pass over any other instances of
-the same word.</para> <note><para>This only applies to the current spellcheck
-run.  If the checker is run again later it will stop on this same
-word.</para></note></listitem>
-</varlistentry>
-</variablelist>
-
-<para>Three more buttons are located horizontally along the bottom of the
-spellcheck dialog.  They are:</para>
-
-<variablelist>
-<varlistentry>
-<term><guibutton>Help</guibutton></term>
-<listitem><para> This invokes the &kde; help system with the help page
-for this dialog.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guibutton>Finished</guibutton></term>
-<listitem><para> This button ends the spellcheck process, and returns to the
-document.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guibutton>Cancel</guibutton></term>
-<listitem><para> This button cancels the spellcheck process, all modifications
-are reverted, and you will return to your document.</para></listitem>
-</varlistentry>
-</variablelist>
-</listitem>
+<para>For more information on how to use the &kde; spellchecking program, see the
+<ulink url="help:/fundamentals/spellcheck.html"><emphasis>Check Spelling</emphasis>
+section of the <emphasis>&kde; Fundamentals</emphasis> documentation</ulink>.
+</para></listitem>
 </varlistentry>
-</variablelist>
 
-<variablelist>
 <varlistentry>
 <term><anchor id="tools-spelling-from-cursor"/><menuchoice>
 <guimenu>Tools</guimenu><guisubmenu>Spelling</guisubmenu>
@@ -1485,6 +1491,10 @@ are reverted, and you will return to your document.</para></listitem>
  <listitem>
 <para>This initiates the spellchecking program but it starts where your cursor
 is instead of at the beginning of the document.</para>
+
+<para>For more information on how to use the &kde; spellchecking program, see the
+<ulink url="help:/fundamentals/spellcheck.html"><emphasis>Check Spelling</emphasis>
+section of the <emphasis>&kde; Fundamentals</emphasis> documentation</ulink>.</para>
  </listitem>
 </varlistentry>
 
@@ -1494,6 +1504,9 @@ is instead of at the beginning of the document.</para>
 <guimenuitem>Spellcheck Selection...</guimenuitem></menuchoice></term>
  <listitem>
 <para>Spellchecks the current selection.</para>
+<para>For more information on how to use the &kde; spellchecking program, see the
+<ulink url="help:/fundamentals/spellcheck.html"><emphasis>Check Spelling</emphasis>
+section of the <emphasis>&kde; Fundamentals</emphasis> documentation</ulink>.</para>
  </listitem>
 </varlistentry>
 
@@ -1642,11 +1655,7 @@ in the Editing tab in <menuchoice>
 <guimenu>Settings</guimenu><guimenuitem>Configure
 Editor...</guimenuitem></menuchoice></para></listitem>
 </varlistentry>
-<!--FIXME
-Create Snippets
-Snippets... -> Snippets tool view as separate window
-missing
-  -->
+
 </variablelist>
 <para>Menu items for the selected <link linkend="pref-plugins">plugins</link>
 are displayed at the end of this menu
@@ -1720,7 +1729,10 @@ Mode</guimenuitem></menuchoice></term>
 </term>
 <listitem>
 <para>Display the familiar &kde; Keyboard Shortcut Configuration
-Dialog.</para>
+Dialog.  For more information on using this, see the
+<ulink url="help:/fundamentals/shortcuts.html"><emphasis>Using and Customizing
+Shortcuts</emphasis> section of the <emphasis>&kde; Fundamentals</emphasis>
+documentation</ulink>.</para>
 </listitem>
 </varlistentry>
 
@@ -1734,7 +1746,11 @@ Dialog.</para>
 </menuchoice>
 </term>
 <listitem>
-<para>Display the familiar &kde; Toolbar Configuration Dialog.</para>
+<para>Display the familiar &kde; Toolbar Configuration Dialog.  For more
+information on using this, see the 
+<ulink url="help:/fundamentals/config.html#toolbars"><emphasis>Customizing
+Toolbars</emphasis> section of the <emphasis>&kde; Fundamentals</emphasis>
+documentation</ulink>.</para>
 </listitem>
 </varlistentry>
 



More information about the kde-doc-english mailing list