mousetweaks r213 - in trunk/help: . C C/figures



Author: frfumanti
Date: Mon Jul 21 17:39:20 2008
New Revision: 213
URL: http://svn.gnome.org/viewvc/mousetweaks?rev=213&view=rev

Log:
2008-07-21 Francesco Fumanti <frfumanti svn gnome org>

	* modified trunk/help/C/mousetweaks.xml
	* modified trunk/help/C/figures/mouse-a11y-dwell-click-type-applet.png

	Updates to reflect the imprisonments done to mousetweaks for GNOME 2.24.



Modified:
   trunk/help/C/figures/mouse-a11y-dwell-click-type-applet.png
   trunk/help/C/mousetweaks.xml
   trunk/help/ChangeLog

Modified: trunk/help/C/figures/mouse-a11y-dwell-click-type-applet.png
==============================================================================
Binary files. No diff available.

Modified: trunk/help/C/mousetweaks.xml
==============================================================================
--- trunk/help/C/mousetweaks.xml	(original)
+++ trunk/help/C/mousetweaks.xml	Mon Jul 21 17:39:20 2008
@@ -34,6 +34,19 @@
 
     <revhistory>
       <revision>
+        <revnumber>version 2.24</revnumber>
+
+        <date>July 2008</date>
+
+        <revdescription>
+          <para role="author">The contents of the manual have been upgraded to
+          integrate the improvements done to mousetweaks for GNOME
+          2.24.<email>Francesco Fumanti
+          &lt;frfumanti svn gnome org&gt;</email></para>
+        </revdescription>
+      </revision>
+
+      <revision>
         <revnumber>version 2.21.5</revnumber>
 
         <date>January 2008</date>
@@ -71,23 +84,22 @@
       </revision>
     </revhistory>
 
-    <releaseinfo>This manual describes version 2.21.5 of mousetweaks and its
-    graphical user interface consisting of the accessibility tab of the mouse
-    control panel and two panel applets.</releaseinfo>
+    <releaseinfo>This manual describes the accessibility tools provided by
+    mousetweaks and its graphical user interfaces consisting of the
+    accessibility tab of the mouse control panel and two panel
+    applets.</releaseinfo>
 
     <contrib>To report a bug or make a suggestion regarding the Mousetweaks
-    application or this manual, please go to GNOME's Bugzilla, where where
-    mousetweaks should soon be available.</contrib>
+    application or this manual, please go to GNOME's Bugzilla.</contrib>
 
     <legalnotice>
       <title>Feedback</title>
 
       <para>To report a bug or make a suggestion regarding <application>the
       mousetweaks module</application> (i.e.: mouse accessibility), its user
-      interface or its manual, please use the facilities provided by the
-      <ulink type="http" url="http://bugzilla.gnome.org/";>GNOME's
-      Bugzilla</ulink>, where the corresponding module should soon be
-      available.</para>
+      interface or its manual, please use the facilities provided by <ulink
+      type="http" url="http://bugzilla.gnome.org/";>GNOME's
+      Bugzilla</ulink>.</para>
     </legalnotice>
   </articleinfo>
 
@@ -102,9 +114,9 @@
   <sect1 id="mouse-a11y-introduction">
     <title>Introduction</title>
 
-    <para>The <application>mousetweaks module</application> provides mouse
-    accessibility enhancements for the GNOME Desktop. Indeed, it offers the
-    following new functions to the user:</para>
+    <para>M<application>ousetweaks</application> provides mouse accessibility
+    enhancements for the GNOME Desktop. Indeed, it offers the following
+    functions to the user:</para>
 
     <itemizedlist>
       <listitem>
@@ -131,7 +143,7 @@
 
     <para>The simulated secondary click and the dwell click depend on the
     mousetweaks process; however the pointer capture applet depends on the
-    gnome panel. Consequently, they have to be started differently.</para>
+    GNOME panel. Consequently, also the methods to start them varies.</para>
 
     <sect2 id="mouse-a11y-start-ssc">
       <title>Starting The Simulated Secondary Click Function</title>
@@ -192,35 +204,40 @@
         </mediaobject>
       </sect3>
 
-      <sect3 id="mouse-a11y-start-ssc-by-cli" label="">
+      <sect3 id="mouse-a11y-start-ssc-by-cli">
         <title>Start From The Command Line</title>
 
         <para>To start the simulated secondary click from the command line,
         open the <application>Terminal</application> and type the
         following:</para>
 
-        <para><command>mousetweaks <parameter>--enable
-        delay</parameter></command></para>
+        <para><command>mousetweaks
+        <parameter>--enable-secondary</parameter></command></para>
       </sect3>
     </sect2>
 
     <sect2 id="mouse-a11y-start-dwell">
       <title>Starting The Dwell Click Function</title>
 
-      <para>You can start the dwell click function in two ways:</para>
+      <para>You can start the dwell click function in three ways:</para>
 
       <itemizedlist>
         <listitem>
-          <para>from the graphical user interface</para>
+          <para>from the Accessibility tab of the Mouse control panel</para>
         </listitem>
 
         <listitem>
           <para>from the command line</para>
         </listitem>
+
+        <listitem>
+          <para>from the On/Off button on the Dwell Click panel applet</para>
+        </listitem>
       </itemizedlist>
 
       <sect3 id="mouse-a11y-start-dwell-by-gui">
-        <title>Start From The Graphical User Interface</title>
+        <title>Start From The Accessibility tab of the Mouse control
+        panel</title>
 
         <para>The graphical user interface to start the dwell click is located
         in the accessibility tab of the mouse control panel. To open it,
@@ -270,9 +287,39 @@
         from the command line, open the <application>Terminal</application>
         and type the following:</para>
 
-        <para><command>mousetweaks <parameter>--enable dwell
+        <para><command>mousetweaks <parameter>--enable-dwell
         --show-ctw</parameter></command></para>
       </sect3>
+
+      <sect3 id="mouse-a11y-start-dwell-by-panel-applet">
+        <title>Start From The On/Off button On The Dwell Click Panel
+        Applet</title>
+
+        <para>It is possible to start the Dwell Click by simply resting
+        (dwelling) for a little delay with the pointer on the On/Off button of
+        the Dwell Click panel applet. The On/Off button provides feedback of
+        the passing dwell time by getting filled with another colour. When it
+        is completely filled, the button turns back to its original color and
+        the dwell click gets started.</para>
+
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="figures/mouse-a11y-dwell-click-type-applet.png" />
+          </imageobject>
+
+          <textobject>
+            <para>Picture showing the click type applet at the right of the
+            GNOME menus</para>
+          </textobject>
+        </mediaobject>
+
+        <remark>For instructions about how to install the Dwell Click applet
+        on the GNOME panel, please have a look at <link
+        linkend="mouse-a11y-start-pointer-capture">Starting The Pointer
+        Capture Function</link> where you can see how it is done for the
+        Pointer Capture panel applet. The procedure for the Dwell Click panel
+        applet is similar.</remark>
+      </sect3>
     </sect2>
 
     <sect2 id="mouse-a11y-start-pointer-capture">
@@ -300,7 +347,8 @@
 
       <para>By double clicking on the <guilabel>Pointer Capture</guilabel>
       item in the Add to Panel window, the pointer capture applet will be
-      added to the panel, and it will be working until removed.</para>
+      added to the panel, and it will run until it is removed from the GNOME
+      panel; even across.</para>
     </sect2>
   </sect1>
 
@@ -350,7 +398,7 @@
     <sect2 id="mouse-a11y-stop-dwell">
       <title>Quitting The Dwell Click</title>
 
-      <para>It is possible to quit the dwell click in two ways:</para>
+      <para>It is possible to quit the dwell click in three ways:</para>
 
       <itemizedlist>
         <listitem>
@@ -379,6 +427,23 @@
           <para><command>mousetweaks</command>
           <parameter>--shutdown</parameter></para>
         </listitem>
+
+        <listitem>
+          <para>If the Dwell Click applet has been installed on the GNOME
+          panel, the dwell click can be disabled by dwelling with the pointer
+          on its On/Off button.</para>
+
+          <mediaobject>
+            <imageobject>
+              <imagedata fileref="figures/mouse-a11y-dwell-click-type-applet.png" />
+            </imageobject>
+
+            <textobject>
+              <para>Picture showing the click type applet at the right of the
+              GNOME menus</para>
+            </textobject>
+          </mediaobject>
+        </listitem>
       </itemizedlist>
     </sect2>
 
@@ -387,9 +452,9 @@
 
       <para>As the pointer capture function comes in the form of a panel
       applet, you have to quit it the same way that you do it with other
-      applets: perform a right click on the applet and choose
-      <guimenuitem>Remove From Panel</guimenuitem> from its contextual
-      menu.</para>
+      applets: you have to remove it from the GNOME panel. To do it, perform a
+      right click on the handle of the applet and choose <guimenuitem>Remove
+      From Panel</guimenuitem> from its contextual menu.</para>
 
       <mediaobject>
         <imageobject>
@@ -401,14 +466,21 @@
           contextual menu</para>
         </textobject>
       </mediaobject>
+
+      <tip>
+        <para>When using the default GNOME theme, the handle of the Pointer
+        Capture applet are the two vertical dotted lines at the left of the
+        pointer capture area.</para>
+      </tip>
     </sect2>
   </sect1>
 
   <sect1 id="mouse-a11y-functions-description">
     <title>Description Of The Functions</title>
 
-    <para>The <application>Mousetweaks</application> application offers three
-    new pointer features to the user. These are: <itemizedlist>
+    <para>Mousetweaks offers three pointer accessibility functions to the
+    user. In this section you will find the description of the three
+    functions: <itemizedlist>
         <listitem>
           <para><xref linkend="mouse-a11y-ssc-description" /></para>
         </listitem>
@@ -431,28 +503,69 @@
       button</mousebutton>. This is especially useful for users that have only
       one <mousebutton>mouse button</mousebutton> at their disposal.</para>
 
-      <sect3 id="mouse-a11y-ssc-howto">
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="figures/mouse-a11y-ssc-delay-slider.png" />
+        </imageobject>
+
+        <textobject>
+          <para>Picture showing the settings belonging to the Simulated
+          Secondary Click.</para>
+        </textobject>
+      </mediaobject>
+
+      <sect3 id="mouse-a11y-ssc-usage">
         <title>How Does It Work?</title>
 
-        <para>When this feature is enabled, mousetweaks performs a secondary
-        click at the location of the pointer, if the user keeps the
+        <para>Let us assume that the user has enabled the Simulated Secondary
+        Click feature.</para>
+
+        <para>To perform a simulated secondary click, the user has to keep the
         <mousebutton>primary mouse button</mousebutton> pressed without moving
-        the pointer for a determined time.</para>
+        the pointer for a determined time. As soon as the determined time has
+        elapsed, the simulated secondary click is issued. </para>
+
+        <para>While doing the simulated secondary click gesture, mousetweaks
+        will fill the arrow of the pointer with another color to give feedback
+        that it is counting down the time before issuing the simulated
+        secondary click.</para>
+
+        <note>
+          <para>Under some circumstances, it happens that the feedback on the
+          arrow of the pointer does not work. The Simulated Secondary Click is
+          issued nevertheless.</para>
+        </note>
+      </sect3>
+
+      <sect3>
+        <title id="mouse-a11y-ssc-delay">The Delay Slider</title>
 
         <para>How long the user has to hold the <mousebutton>primary mouse
-        button</mousebutton> pressed is determined by the delay slider under
-        the activation checkbox:</para>
+        button</mousebutton> pressed, is determined by the
+        <guilabel>Delay</guilabel> slider located under the activation
+        checkbox. By using this slider, the user can choose the delay most
+        appropriate to him.</para>
+      </sect3>
 
-        <mediaobject>
-          <imageobject>
-            <imagedata fileref="figures/mouse-a11y-ssc-delay-slider.png" />
-          </imageobject>
+      <sect3>
+        <title id="mouse-a11y-ssc-motion-treshold">Motion Treshold</title>
 
-          <textobject>
-            <para>Picture showing the slider to set how long to hold the
-            primary button for the secondary click to be triggered</para>
-          </textobject>
-        </mediaobject>
+        <para>People that have trouble to keep the pointer completely
+        motionless can use the Motion Treshold slider of the Dwell Click
+        feature. This setting makes mousetweaks ignore little mouse movements,
+        so that the simulated secondary click is issued even if the pointer is
+        not completely motionless. Please have a look at the section of the
+        <link linkend="mouse-a11y-dwell-motion-treshold">Motion Treshold
+        slider of the Dwell Click feature</link> for more information about
+        it.</para>
+
+        <note>
+          <para>The <guilabel>Motion Treshold</guilabel> slider that is
+          located under the <guilabel>Dwell Click</guilabel> feature is also
+          effective for the <guilabel>Simulated Secondary Click</guilabel>
+          feature, even if the <guilabel>Dwell Click</guilabel> feature is
+          disabled.</para>
+        </note>
       </sect3>
 
       <sect3 id="mouse-a11y-ssc-pecularities">
@@ -460,9 +573,9 @@
 
         <para>As the simulated secondary click is not able to discard the
         <mousebutton>mouse button down</mousebutton> gesture from the
-        <mousebutton> primary button press</mousebutton> of the user, it
-        issues a primary click before issuing the secondary click. In other
-        words, each secondary click performed by this function is immediately
+        <mousebutton>primary button press</mousebutton> of the user, it issues
+        a primary click before issuing the secondary click. In other words,
+        each secondary click performed by this function is immediately
         preceded by a primary click, and this makes it behave a bit
         differently to the normal secondary click performed by the
         <mousebutton>secondary mouse button</mousebutton>. For example:</para>
@@ -527,69 +640,33 @@
         click with the <mousebutton>mouse buttons</mousebutton>.</para>
       </note>
 
-      <sect3>
-        <title id="mouse-a11y-dwell-delay">Dwell Delay Setting</title>
-
-        <para>With the <guilabel>Delay</guilabel> slider, the user can
-        configure how long the pointer has to be motionless for the click to
-        be initiated.</para>
-
-        <mediaobject>
-          <imageobject>
-            <imagedata fileref="figures/mouse-a11y-dwell-delay-slider.png" />
-          </imageobject>
-
-          <textobject>
-            <para>Picture showing the delay slider of the dwell click</para>
-          </textobject>
-        </mediaobject>
+      <sect3 id="mouse-a11y-dwell-usage">
+        <title>How Does It Work?</title>
 
-        <para>Details about how to complete the click and how to choose the
-        click type can be found under <link
-        linkend="mouse-a11y-dwell-modes">How To Complete Clicks And Specify
-        The Click Type</link>.</para>
+        <para>Each time the pointer stops moving, a dwell click is initiated.
+        To give feedback to the user, mousetweaks will fill the arrow of the
+        pointer with another color while it is counting down the time before
+        the click completion kicks in.</para>
 
         <note>
-          <para>The dwell delay only works in the context of the dwell
-          click.</para>
+          <para>Under some circumstances, it happens that the feedback on the
+          arrow of the pointer does not work; the dwell clicks are
+          nevertheless issued.</para>
         </note>
-      </sect3>
-
-      <sect3 id="mouse-a11y-dwell-motion-treshold">
-        <title>Motion Treshold Setting</title>
-
-        <para>For people that have trouble to keep the mouse motionless, there
-        is the <guilabel>Motion Treshold</guilabel> slider.</para>
-
-        <mediaobject>
-          <imageobject>
-            <imagedata fileref="figures/mouse-a11y-dwell-motion-treshold.png" />
-          </imageobject>
-
-          <textobject>
-            <para>Picture showing the motion treshold slider of the dwell
-            click</para>
-          </textobject>
-        </mediaobject>
-
-        <para>When the slider is set towards low, even little mouse movements
-        are considered; however, by setting a higher treshold, the mouse has
-        to traverse a bigger distance before it is considered as
-        moving.</para>
 
-        <note>
-          <para>This function only works in the context of the dwell
-          click.</para>
-        </note>
-      </sect3>
+        <para>How the click is completed and how the click type is chosen
+        depends on what dwell mode the user has selected. The two available
+        modes are:</para>
 
-      <sect3 id="mouse-a11y-dwell-modes">
-        <title>How To Complete Clicks And Specify The Click Type</title>
+        <itemizedlist>
+          <listitem>
+            <para>Choose type of click beforehand</para>
+          </listitem>
 
-        <para>Each time she pointer stops moving, a click is initiated. How
-        the click is completed and how the click type is chosen depends on
-        what dwell mode the user has selected. The two available modes
-        are:</para>
+          <listitem>
+            <para>Choose type of click with mouse gestures</para>
+          </listitem>
+        </itemizedlist>
 
         <mediaobject>
           <imageobject>
@@ -606,14 +683,15 @@
         button that corresponds to his choice.</para>
 
         <sect4 id="mouse-a11y-dwell-mode-ctw">
-          <title>Dwell Click With Automatic Click Completion And Click Type
-          Choice Beforehand</title>
+          <title>Automatic Click Completion With Click Type Choice
+          Beforehand</title>
 
           <para>This mode is active when the user selects <guilabel>Choose
           type of click beforehand</guilabel>. In fact, after the mouse has
-          been motionless for the time defined by the Delay slider, the system
-          will automatically perform the click type that is selected in the
-          Click Type Window shown here:</para>
+          been motionless for the time defined by the
+          <guilabel>Delay</guilabel> slider, the system will automatically
+          perform the click type that is selected in the Click Type Window
+          shown here:</para>
 
           <mediaobject>
             <imageobject>
@@ -625,9 +703,10 @@
             </textobject>
           </mediaobject>
 
-          <para>To display the click type window on the screen, the user has
-          to put a checkmark <application>in the checkbox named <quote>Show
-          click type window</quote>:</application></para>
+          <para>To display the <guimenu>Click Type Window</guimenu> on the
+          screen, the user has to put a checkmark <application>in the checkbox
+          named <quote><guilabel>Show click type
+          window</guilabel></quote>:</application></para>
 
           <mediaobject>
             <imageobject>
@@ -643,13 +722,12 @@
           <para>After the click has occurred, the single click type will be
           automatically restored. In order to choose another click type, the
           user has to perform an automatic click on the
-          <guibutton>button</guibutton> in the Click Type Window that
-          corresponds to its click type choice.</para>
+          <guibutton>button</guibutton> in the <guilabel>Click Type
+          Window</guilabel> that corresponds to his click type choice.</para>
 
-          <para>Some users might prefer to use the <guilabel>Dwell Click panel
-          applet</guilabel> instead of the Click Type Window. The advantage of
-          the panel applet is that it does not cover any open window on the
-          desktop.</para>
+          <para>Instead of the Click Type Window some users might prefer to
+          use the <guilabel>Dwell Click</guilabel> panel applet, that has some
+          advantages:.</para>
 
           <mediaobject>
             <imageobject>
@@ -658,49 +736,73 @@
 
             <textobject>
               <para>Picture showing the click type applet at the right of the
-              gnome menus</para>
+              GNOME menus</para>
             </textobject>
           </mediaobject>
 
-          <para>To display the click type applet on the GNOME panel, please
-          follow the procedure you have to use in order to add any applet to
-          the GNOME panel. If you do not know how to add an applet to the
-          panel, have a look at <link
+          <para>Indeed, by using the <guilabel>Dwell Click</guilabel> panel
+          applet: <itemizedlist>
+              <listitem>
+                <para>The user does not need the <guilabel>Click Type
+                Window</guilabel> that covers other windows on the
+                desktop.</para>
+              </listitem>
+
+              <listitem>
+                <para>The user has a direct way to start and stop the dwell
+                click by using the <guilabel>On/Off</guilabel> button of the
+                <guilabel>Dwell Click</guilabel> applet. This is especially
+                useful when he wants to disable dwelling for a little while to
+                read some text without the interference of a dwell
+                click.</para>
+              </listitem>
+            </itemizedlist></para>
+
+          <para>To display the <guilabel>Dwell Click</guilabel> applet on the
+          GNOME panel, the user has to follow the usual procedure to add
+          applets to the GNOME panel. An example about how to do it can be
+          found in the section <link
           linkend="mouse-a11y-start-pointer-capture">Starting The Pointer
           Capture Function</link>.</para>
 
-          <para>The click type window and the click type applet can be used
-          simultaneously or each on its own.</para>
+          <para>The <guilabel>Click Type Window</guilabel> and the
+          <guilabel>Dwell Click</guilabel> applet can be used simultaneously
+          or each on its own.</para>
         </sect4>
 
         <sect4 id="mouse-a11y-dwell-mode-gestures">
-          <title>Dwell Click With Click Type Choice And Click Completion By A
-          Mouse Gesture</title>
+          <title>Click Completion And Click Type Choice By Mouse
+          Gesture</title>
 
           <para>This mode is active when the user selects <guilabel>Choose
           type of click with mouse gestures</guilabel>. In fact, after the
-          mouse has been motionless for the above predefined delay, the shape
-          of the pointer will change for a little while:</para>
+          mouse has been motionless for the delay defined by the <link
+          linkend="mouse-a11y-dwell-delay">delay slider</link>, the shape of
+          the pointer will change for a little time lapse; let's call this
+          shape the gesture shape:</para>
 
           <itemizedlist>
             <listitem>
-              <para>If the user moves the mouse while it is showing the
-              alternative shape, a click is performed and the pointer returns
-              to its normal shape. The type of click performed depends on the
-              direction of the movement of the mouse.</para>
+              <para>If the user moves the pointer while it is showing the
+              gesture shape, a click is performed at the location where the
+              pointer was last motionless; finally the pointer returns to its
+              normal shape. The type of click performed depends on the
+              direction of the movement of the mouse. During the movement of
+              the pointer, a line is drawn following the movement of the
+              pointer to give feedback to the user. </para>
             </listitem>
 
             <listitem>
-              <para>If the user keeps the mouse motionless until the pointer
-              returns to its normal shape, the user can move the mouse without
-              a click being performed. The next dwell click can be performed
-              when the mouse stops moving again.</para>
+              <para>If the user keeps the pointer motionless until it returns
+              to its normal shape, the user can move the mouse without a click
+              being performed. The next dwell click can be performed at the
+              next pointer stop..</para>
             </listitem>
           </itemizedlist>
 
           <para>The user also has the possibility to match click type with
           movement direction by using the 4 <guimenu>popups</guimenu>
-          available under this mode:</para>
+          available:</para>
 
           <mediaobject>
             <imageobject>
@@ -716,10 +818,61 @@
           <para>There is also a <guimenuitem>Disabled</guimenuitem> menu item
           in each <guimenu>popup</guimenu>. The user can select it if he does
           not want some click types to be performed automatically. This is
-          especially interesting for users that have problems only with
+          especially interesting for users that have problems with only
           certain click types.</para>
         </sect4>
       </sect3>
+
+      <sect3>
+        <title id="mouse-a11y-dwell-delay">Dwell Delay Setting</title>
+
+        <para>With the <guilabel>Delay</guilabel> slider, the user can
+        configure how long the pointer has to be motionless for the click to
+        be initiated.</para>
+
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="figures/mouse-a11y-dwell-delay-slider.png" />
+          </imageobject>
+
+          <textobject>
+            <para>Picture showing the delay slider of the dwell click</para>
+          </textobject>
+        </mediaobject>
+
+        <note>
+          <para>The dwell delay only works in the context of the dwell
+          click.</para>
+        </note>
+      </sect3>
+
+      <sect3 id="mouse-a11y-dwell-motion-treshold">
+        <title>Motion Treshold Setting</title>
+
+        <para>For people that have trouble to keep the mouse motionless, there
+        is the <guilabel>Motion Treshold</guilabel> slider.</para>
+
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="figures/mouse-a11y-dwell-motion-treshold.png" />
+          </imageobject>
+
+          <textobject>
+            <para>Picture showing the motion treshold slider of the dwell
+            click</para>
+          </textobject>
+        </mediaobject>
+
+        <para>When the slider is set towards low, even little mouse movements
+        are considered; however, by setting a higher treshold, the pointer has
+        to travel a bigger distance before it is considered as moving.</para>
+
+        <note>
+          <para>The Motion Treshold setting does not only work for the dwell
+          click, but also for the simulated secondary click, even if the dwell
+          click is disabled.</para>
+        </note>
+      </sect3>
     </sect2>
 
     <sect2 id="mouse-a11y-pointer-capture-description">
@@ -730,9 +883,9 @@
       into an area of the screen, so that they can use their pointing device
       for other tasks.</para>
 
-      <para>In fact, the Pointer Capture panel applet creates such an area on
-      the panel, into which the user can lock the pointer until he releases it
-      in a determined way.</para>
+      <para>In fact, the Pointer Capture panel applet creates an area on the
+      panel, into which the user can lock the pointer until he releases it in
+      a determined way.</para>
 
       <remark>Have a look at <link
       linkend="mouse-a11y-start-pointer-capture">Starting The Pointer Capture
@@ -759,9 +912,10 @@
         </textobject>
       </mediaobject>
 
-      <para>By choosing Preferences in the contextual menu of the pointer
-      capture applet, the user gets a window with the options of the pointer
-      capture applet:</para>
+      <para>By choosing <guimenu>Preferences</guimenu> in the contextual menu
+      of the <guilabel>Pointer Capture</guilabel> applet, the user gets a
+      window with the options of the <guilabel>Pointer Capture</guilabel>
+      applet:</para>
 
       <mediaobject>
         <imageobject>
@@ -774,34 +928,36 @@
         </textobject>
       </mediaobject>
 
-      <para>The preferences window of the pointer capture applet has three
-      sections:</para>
+      <para>The <guilabel>Preferences</guilabel> window of the
+      <guilabel>Pointer Capture</guilabel> applet has three sections:</para>
 
       <itemizedlist>
         <listitem>
-          <para>In the Capture Pointer section, the user can specify under
-          what circumstances the pointer gets captured when it moves into the
-          capture area. For example: if the control modifier is checked, the
-          pointer gets captured when it is over the capture area and the user
-          presses the Control modifier key. If no modifier is checked and the
-          mouse button is set to 0, the pointer only has to move into the
-          capture area to get locked.</para>
+          <para>In the <guilabel>Capture Pointer</guilabel> section, the user
+          can specify under what circumstances the pointer gets captured when
+          it moves into the capture area. For example: if the control modifier
+          is checked, the pointer gets captured when it is over the capture
+          area and the user presses the Control modifier key. If no modifier
+          is checked and the mouse button is set to 0, the pointer only has to
+          move into the capture area to get locked.</para>
 
           <para>It is also possible to specify a combination of modifiers and
           mouse button.</para>
         </listitem>
 
         <listitem>
-          <para>In the Release Pointer section, the user can specify what
-          modifier or mouse button releases the pointer.</para>
+          <para>In the <guilabel>Release Pointer</guilabel> section, the user
+          can specify what modifier or mouse button releases the
+          pointer.</para>
 
           <para>It is also possible to specify a combination of modifiers and
           mouse button.</para>
         </listitem>
 
         <listitem>
-          <para>In the Size of Capture Area section, the user can specify the
-          width of the capture area on the GNOME panel.</para>
+          <para>In the <guilabel>Size of Capture Area</guilabel> section, the
+          user can specify the width of the capture area on the GNOME
+          panel.</para>
         </listitem>
       </itemizedlist>
     </sect2>
@@ -818,8 +974,8 @@
       url="https://wiki.ubuntu.com/Accessibility/Specs/MouseTweaks";>specification</ulink>
       hosted on Launchpad. It was implemented by Gerd Kohlberger (
       <email>gerdk svn gnome org</email> ), while I (
-      <email>frfumanti svn gnome org</email> ) helped with testing and other
-      things.</para>
+      <email>frfumanti svn gnome org</email> ) helped with testing and
+      logistics..</para>
 
       <para>You can find more informations about Mousetweaks on <ulink
       type="https" url="https://launchpad.net/mousetweaks";>Launchpad</ulink>
@@ -831,22 +987,31 @@
       <title>Feedback</title>
 
       <para>To report a bug or make a suggestion regarding <application>the
-      mousetweaks</application> module (i.e.: mouse accessibility), its user
-      interface or its manual, please use the facilities provided by the
-      <ulink type="http" url="http://bugzilla.gnome.org/";>GNOME's
-      Bugzilla</ulink>, where the corresponding module should soon be
-      available.</para>
+      mousetweaks</application> module, its user interface or its manual,
+      please use the facilities provided by the <ulink type="http"
+      url="http://bugzilla.gnome.org/";>GNOME's Bugzilla</ulink>. If it
+      concerns the layout of the Accessibility tab of the Mouse control panel,
+      please file it against the gnome-control-center module; for anything
+      else regarding mousetweaks, please file it against the mousetweaks
+      module.</para>
     </sect2>
 
     <sect2>
       <title>License</title>
 
-      <para>This program is distributed under the terms of the GNU General
-      Public license as published by the Free Software Foundation; either
+      <para>Mousetweaks is distributed under the terms of the GNU General
+      Public License as published by the Free Software Foundation; either
       version 3 of the License, or (at your option) any later version. A copy
-      of this license can be found at this <ulink type="http"
+      of the license can be found at this <ulink type="http"
       url="http://www.gnu.org/licenses/gpl-3.0.txt";>link</ulink>, or in the
-      file COPYING included with the source code of this program.</para>
+      file COPYING.GPL included with the source code of this program.</para>
+
+      <para>This manual is distributed under the terms of the The GNU Free
+      Documentation License as published by the Free Software Foundation;
+      either version 1.2 of the License, or (at your option) any later
+      version. A copy of the license can be found at this <ulink type="http"
+      url="http://www.gnu.org/licenses/fdl-1.2.txt";>link</ulink>, or in the
+      file COPYING.FDL included with the source code of this program.</para>
     </sect2>
   </sect1>
-</article>
+</article>
\ No newline at end of file



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]