Bug 112579

the following patch (checked with meinproc) fixes this bug #112579 and also
bug #96464: KMagnifier: No menu reference, Command reference should be updated

Index: svn/kdeaccessibility/doc/kmag/index.docbook
===================================================================
--- svn/kdeaccessibility/doc/kmag/index.docbook	(Revision 459418)
+++ svn/kdeaccessibility/doc/kmag/index.docbook	(Arbeitskopie)
@@ -184,6 +184,304 @@
 </sect1>
 </chapter>
 
+<chapter id="menus">
+<title>Menu Reference</title>
+
+<sect1 id="the-file-menu">
+<title>The <guimenu>File</guimenu> Menu</title>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;
+<keycap>N</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>New Window</guimenuitem>
+</menuchoice></term>
+<listitem><para>Opens a new &kmag; window.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;
+<keycap>S</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Save Snapshot As...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Saves the zoomed view to an image file.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;
+<keycap>P</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Print...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Prints the current zoomed view.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;
+<keycap>Q</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Quit</guimenuitem>
+</menuchoice></term>
+<listitem><para>Quits the application</para></listitem>
+</varlistentry>
+</variablelist>
+</sect1>
+
+<sect1 id="the-edit-menu">
+<title>The <guimenu>Edit</guimenu> Menu</title>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;
+<keycap>C</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Copy</guimenuitem>
+</menuchoice></term>
+<listitem><para>Copy the current zoomed view to the clipboard which 
+you can paste in other applications.</para></listitem>
+</varlistentry>
+</variablelist>
+</sect1>
+
+<sect1 id="the-view-menu">
+<title>The <guimenu>View</guimenu> Menu</title>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">
+<keycap>F5</keycap></keycombo>
+</shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Start/Stop</guimenuitem>
+</menuchoice></term>
+<listitem><para>Start/Stop updating of the display. 
+Stopping the update will zero the processing power required (CPU 
+usage)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Zoom</guimenuitem>
+</menuchoice></term>
+<listitem><para>Select the zoom factor.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;
+<keycap>-</keycap></keycombo>
+</shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Zoom Out</guimenuitem>
+</menuchoice></term>
+<listitem><para>Click on this button to zoom-out on the selected region.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;
+<keycap>+</keycap></keycombo>
+</shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Zoom In</guimenuitem>
+</menuchoice></term>
+<listitem><para>Click on this button to zoom-in on the selected region.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">
+<keycap>F6</keycap></keycombo>
+</shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Invert Colors</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Inverts</action> colors on the view, i.e. black things will be shown white.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Rotation</guimenuitem>
+</menuchoice></term>
+<listitem><para>Select the rotation degree. -> No Rotation (0°), Left (90°), Upside Down (180°), Right (270°)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Refresh</guimenuitem>
+</menuchoice></term>
+<listitem><para>Select the refresh rate (Very Low, Low, Medium, High, Very High).
+The higher the rate, the more computing power (CPU) 
+will be needed.</para></listitem>
+</varlistentry>
+</variablelist>
+</sect1>
+
+<sect1 id="the-settings-menu">
+<title>The <guimenu>Settings</guimenu> Menu</title>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;
+<keycap>M</keycap></keycombo>
+</shortcut>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Menu</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggles the menubar on/off.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Main Toolbar</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggles the main toolbar on/off.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide View Toolbar</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggles the view toolbar on/off.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Settings Toolbar</guimenuitem>
+</menuchoice></term>
+<listitem><para></para>Toggles the settings toolbar on/off.</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">
+<keycap>F1</keycap></keycombo>
+</shortcut>
+<guimenu>Settings</guimenu>
+<guimenuitem>Follow Mouse Mode</guimenuitem>
+</menuchoice></term>
+<listitem><para>In this mode the area around the mouse cursor is shown in a normal window.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">
+<keycap>F2</keycap></keycombo>
+</shortcut>
+<guimenu>Settings</guimenu>
+<guimenuitem>Selection Window Mode</guimenuitem>
+</menuchoice></term>
+<listitem><para>In this mode a selection window is opened. The selected area is shown in a normal window.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Top Screen Edge Mode</guimenuitem>
+</menuchoice></term>
+<listitem><para>In this mode the area around the mouse is magnified to the top screen edge.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Left Screen Edge Mode</guimenuitem>
+</menuchoice></term>
+<listitem><para>In this mode the area around the mouse is magnified to the left screen edge.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Right Screen Edge Mode</guimenuitem>
+</menuchoice></term>
+<listitem><para>In this mode the area around the mouse is magnified to the right screen edge.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Bottom Screen Edge Mode</guimenuitem>
+</menuchoice></term>
+<listitem><para>In this mode the area around the mouse is magnified to the bottom screen edge.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">
+<keycap>F4</keycap></keycombo>
+</shortcut>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Mouse Cursor</guimenuitem>
+</menuchoice></term>
+<listitem><para>Show or hide the mouse cursor in the magnified image.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure Shortcuts...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Opens a window that lets you configure the keyboard
+shortcuts for many menu commands.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure Toolbars...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Opens a window that lets you choose which icons are visible
+in the toolbar.</para></listitem>
+</varlistentry>
+</variablelist>
+</sect1>
+
+<sect1 id="the-help-menu">
+<title>The <guimenuitem>Help</guimenuitem> Menu</title>
+
+&help.menu.documentation;
+
+</sect1>
+</chapter>
+
 <chapter id="commands">
 <title>Command Reference</title>
 
@@ -224,6 +522,15 @@
 </entry>
 </row>
 <row>
+<entry><keycap>F6</keycap></entry>
+<entry><para>Invert Colors</para>
+</entry>
+</row>
+<row>
+<entry><keycombo>&Ctrl;<keycap>N</keycap></keycombo></entry>
+<entry><para>This will open a new KMagnifier window.</para></entry>
+</row>
+<row>
 <entry><keycombo>&Ctrl;<keycap>P</keycap></keycombo></entry>
 <entry><para>This will open the print dialog for printing the contents
 of the zoom window.</para></entry>
@@ -235,13 +542,22 @@
 </entry>
 </row>
 <row>
+<entry><keycombo>&Ctrl;<keycap>M</keycap></keycombo></entry>
+<entry><para>Show/Hide the menubar.</para>
+</entry>
+</row>
+<row>
 <entry><keycombo>&Ctrl;<keycap>-</keycap></keycombo></entry>
 <entry><para>Zoom out</para></entry>
 </row>
 <row>
-<entry><keycombo>&Ctrl;&Shift;<keycap>+</keycap></keycombo></entry>
+<entry><keycombo>&Ctrl;<keycap>+</keycap></keycombo></entry>
 <entry><para>Zoom in</para></entry>
 </row>
+<row>
+<entry><keycombo>&Ctrl;<keycap>Q</keycap></keycombo></entry>
+<entry><para>Quits the application.</para></entry>
+</row>
 </tbody>
 </tgroup>
 

SVN commit 489584 by lueck:

documentation update (menus, checked guiitems, sanitized)
BUG:96464 
BUG:112579 
BUG:112580 
CCMAIL:gunnar@schmi-dt.de


 M  +322 -5    kmag/index.docbook  
 M  +4 -4      kmag/man-kmag.1.docbook  
 M  +16 -15    kmousetool/index.docbook  
 M  +4 -4      kmousetool/man-kmousetool.1.docbook  
 M  +60 -41    kmouth/index.docbook  
 M  +4 -4      kmouth/man-kmouth.1.docbook