[kde-doc-english] [Bug 112580] New: kmouth missing shortcuts and other errors in documentation

[Burkhard Lück]

------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
         
http://bugs.kde.org/show_bug.cgi?id=112580         
           Summary: kmouth missing shortcuts and other errors in
                    documentation
           Product: docs
           Version: unspecified
          Platform: Compiled Sources
        OS/Version: Linux
            Status: NEW
          Severity: wishlist
          Priority: NOR
         Component: general
        AssignedTo: kde-doc-english kde org
        ReportedBy: lueck hube-lueck de


Version:            (using KDE Devel)
Installed from:    Compiled sources

1. some shortcuts are missing in the chapter command reference, some guilabels and guimenuitems do not match the text on screen.
This is fixed in the following diff

2. The chapter The Configuration Dialog is including the screenshots is not up to date 
This is not fixed in the diff

--- svn/kdeaccessibility/doc/kmouth/index.docbook	2005-05-13 08:30:30.000000000 +0200
+++ /home/kdedev/kmouth/index.docbook	2005-09-14 08:51:09.000000000 +0200
 @ -249,13 +249,13  @
         &kmouth; in certain situations.
       </para>
       <para>
-        With the first combo box, <guilabel>Selection of phrases in the phrase book</guilabel>,
+        With the first combo box, <guilabel>Selection of phrases in the phrase book:</guilabel>,
         you specify which action is triggered by typing the shortcut of a
         phrase or by selecting a phrase in the <guimenu>Phrase Book</guimenu>
         menu or in the phrase book bar.
       </para>
       <para>
-        By selecting <guilabel>Speak immediately</guilabel> the
+        By selecting <guilabel>Speak Immediately</guilabel> the
         selected phrase gets immediately spoken and is entered into
         the history. If you select <guilabel>Insert Into Edit
         Field</guilabel> the selected phrase is just inserted into the
 @ -263,14 +263,14  @
       </para>
       <para>
         With the second combo box, <guilabel>Closing the phrase book
-        edit window</guilabel>, you specify whether the phrase book
+        edit window:</guilabel>, you specify whether the phrase book
         gets saved if you just close the phrase book edit window.
       </para>
       <para>
         By selecting <guilabel>Save Phrase Book</guilabel> the phrase
         book gets saved. If you select <guilabel>Discard
         changes</guilabel> the changes are discarded and the phrase 
-        book is not saved. If you select <guilabel>Ask whether to
+        book is not saved. If you select <guilabel>Ask Whether to
         Save</guilabel> &kmouth; will ask you whether it shall save
         the phrase book.
       </para>
 @ -442,7 +442,7  @
                 <keycombo>&Ctrl;<keycap>S</keycap></keycombo>
               </shortcut>
               <guimenu>File</guimenu>
-              <guimenuitem>Save History as...</guimenuitem>
+              <guimenuitem>Save History As...</guimenuitem>
             </menuchoice></term>
             <listitem><para><action>Saves the history into a text file.</action></para></listitem>
           </varlistentry>
 @ -549,6 +549,9  @
         <variablelist>
           <varlistentry>
             <term><menuchoice>
+              <shortcut>
+                <keycombo>&Ctrl;<keycap>M</keycap></keycombo>
+              </shortcut>
               <guimenu>Settings</guimenu>
               <guimenuitem>Show Menubar</guimenuitem>
             </menuchoice></term>
 @ -633,7 +636,7  @
           </varlistentry>
           <varlistentry>
             <term><menuchoice>
-              <guimenuitem>Remove</guimenuitem>
+              <guimenuitem>Delete</guimenuitem>
             </menuchoice></term>
             <listitem><para><action>
               The selected sentences are removed from the history.
 @ -657,7 +660,7  @
           </varlistentry>
           <varlistentry>
             <term><menuchoice>
-              <guimenuitem>Select all entries</guimenuitem>
+              <guimenuitem>Select All Entries</guimenuitem>
             </menuchoice></term>
             <listitem><para><action>
               All history entries are selected.
 @ -665,16 +668,16  @
           </varlistentry>
           <varlistentry>
             <term><menuchoice>
-              <guimenuitem>De-select all entries</guimenuitem>
+              <guimenuitem>Deselect All Entries</guimenuitem>
             </menuchoice></term>
             <listitem><para><action>
-              All history entries are de-selected.
+              All history entries are deselected.
             </action></para></listitem>
           </varlistentry>
           <varlistentry>
             <term><menuchoice>
               <shortcut><keycombo>&Ctrl;<keycap>O</keycap></keycombo></shortcut> 
-              <guimenuitem>Open as history...</guimenuitem>
+              <guimenuitem>Open as History...</guimenuitem>
             </menuchoice></term>
             <listitem><para><action>
               Opens a text file into as history of spoken sentences.
 @ -683,7 +686,7  @
           <varlistentry>
             <term><menuchoice>
 <shortcut><keycombo>&Ctrl;<keycap>S</keycap></keycombo></shortcut> 
-              <guimenuitem>Save history as...</guimenuitem>
+              <guimenuitem>Save History As...</guimenuitem>
             </menuchoice></term>
             <listitem><para><action>
               Saves the history into a text file.
 @ -857,6 +860,9  @
           </varlistentry>
           <varlistentry>
             <term><menuchoice>
+              <shortcut>
+                <keycombo>&Ctrl;<keycap>X</keycap></keycombo>
+              </shortcut>
               <guimenuitem>Cut</guimenuitem>
             </menuchoice></term>
             <listitem><para><action>
 @ -865,6 +871,9  @
           </varlistentry>
           <varlistentry>
             <term><menuchoice>
+              <shortcut>
+                <keycombo>&Ctrl;<keycap>C</keycap></keycombo>
+              </shortcut>
               <guimenuitem>Copy</guimenuitem>
             </menuchoice></term>
             <listitem><para><action>
 @ -873,6 +882,9  @
           </varlistentry>
           <varlistentry>
             <term><menuchoice>
+              <shortcut>
+                <keycombo>&Ctrl;<keycap>V</keycap></keycombo>
+              </shortcut>
               <guimenuitem>Paste</guimenuitem>
             </menuchoice></term>
             <listitem><para><action>
 @ -909,9 +921,9  @
           Most likely you did not configure correctly (or not at all?) the
           text-to-speech command. Use
           <menuchoice>
-            <guimenu>Settings</guimenu><guimenuitem>Text-to-speech conversion</guimenuitem>
-          </menuchoice>
-          and enter the command for speaking texts.
+            <guimenu>Settings</guimenu><guimenuitem>Configure &kmouth;...</guimenuitem>
+          </menuchoice>, open the page <guilabel>General Options</guilabel>
+          and enter the command for speaking texts on the tab <guilabel>Text-to-Speech</guilabel>.
           (See section about the <link linkend="tts-config">configuration
           dialog for the speech synthesizer</link> for more details.)
         </para>