Gnome User Guide: mouse prefs

[Joachim Noreiko <jnoreiko yahoo com>]

Here's a patch that sort of fixes bug 149309, the
discrepancy between the UI and the docs for mouse
preferences.
(It seems that since the bug got filed, both parts
were updated and are now the other way round, but
still mismatched.)
There is an underlying problem with the UI, in that it
uses both 'cursor' and 'pointer' to mean the pointer.
(Bug 318056.) 
So the documentation for this bit is going to suck
until the UI is fixed.

I've also tried to clean up the intro and I've added a
mention of the light-bulb icon.

Another point I'd like to raise is the tables in the
mouse prefs docs.
IMHO these would be better off as variablelists. They
have two columns, which are basically a label and its
explanation, and a list is easier on the eye than lots
of table borders.
And a sentence like 'Table 9-14 lists the mouse
pointer preferences that you can modify:' is just
overkill. 
This is also a problem in other parts of the Gnome
User Guide.

Is there a DocBook tool that can convert the table to
a variablelist? 
I can whip up a perl script to do it, but I'd rather
not reinvent the wheel :)


	
	
		
___________________________________________________________ 
Yahoo! Messenger - NEW crystal clear PC to PC calling worldwide with voicemail http://uk.messenger.yahoo.com

Index: goscustdesk.xml
===================================================================
RCS file: /cvs/gnome/gnome-user-docs/gnome2-user-guide/C/goscustdesk.xml,v
retrieving revision 1.19
diff -u -r1.19 goscustdesk.xml
--- goscustdesk.xml	29 Mar 2005 05:01:20 -0000	1.19
+++ goscustdesk.xml	12 Dec 2005 16:49:36 -0000
@@ -1906,28 +1906,18 @@
       <primary>mouse</primary>
       <secondary>configuring</secondary>
     </indexterm>
-    <para>Use the <application>Mouse</application> preference tool
-to configure your mouse for right-hand use or for left-hand use. You can also
-specify the speed and sensitivity of mouse movement.</para>
-    <para>You can customize the settings for the <application>Mouse</application>
-preference tool in the following functional areas:</para>
+    <para>With the <application>Mouse</application> preference tool
+    you can:</para>
     <itemizedlist>
       <listitem>
-        <para>
-          <guilabel>Buttons</guilabel>
-        </para>
+        <para>configure your mouse for right-hand use or for left-hand use,</para>
       </listitem>
-      <listitem>
-        <para>
-          <guilabel>Cursors</guilabel>
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          <guilabel>Motion</guilabel>
-        </para>
+      <listitem>      
+        <para>specify the speed and sensitivity of mouse movement.</para>
       </listitem>
     </itemizedlist>
+    
+    
     <sect2 id="goscustdesk-55">
       <title>Buttons Preferences</title>
       <para>Use the <guilabel>Buttons</guilabel> tabbed section to specify whether
@@ -1935,7 +1925,9 @@
 delay between clicks for a double-click.</para>
       <para><xref linkend="goscustperiph-TBL-6"/> lists the mouse button preferences
 that you can modify.</para>
-      <table frame="topbot" id="goscustperiph-TBL-6">
+
+    <!-- convert to variablelist -->
+    <table frame="topbot" id="goscustperiph-TBL-6">
         <title>Mouse Button Preferences</title>
         <tgroup cols="2" colsep="1" rowsep="1">
           <colspec colname="colspec18" colwidth="19.21*"/>
@@ -1975,6 +1967,8 @@
 the amount of time that can pass between clicks when you double-click. If
 the interval between the first and second clicks exceeds the time that is
 specified here, the action is not interpreted as a double-click. </para>
+
+                <para>Use the light bulb icon to check double-click sensitivity: the light will light up briefly for a click, but stay lit for a double-click.</para>
               </entry>
             </row>
           </tbody>
@@ -1983,8 +1977,10 @@
     </sect2>
     <sect2 id="goscustdesk-54">
       <title>Pointer Preferences</title>
-      <para>Use the <guilabel>Cursors</guilabel> tabbed section to set your mouse
-pointer preferences.</para>
+      <!-- Pointer Cursor Yes, this is stupid. See Bug 318056 -->
+      <para>Use the <guilabel>Cursors</guilabel> tabbed section to set
+      your mouse pointer preferences.
+      </para>
       <para><xref linkend="goscustdesk-TBL-45"/> lists the mouse pointer preferences
 that you can modify:</para>
       <table frame="topbot" id="goscustdesk-TBL-45">
@@ -2004,35 +2000,14 @@
           </thead>
           <tbody>
             <row>
-              <entry colname="colspec0">
-                <para>
-                  <guilabel>Small</guilabel>
-                </para>
-              </entry>
-              <entry colname="colspec1">
-                <para>Select this option to display a small mouse
-pointer.</para>
-              </entry>
-            </row>
-            <row>
-              <entry colname="colspec0">
-                <para>
-                  <guilabel>Medium</guilabel>
-                </para>
-              </entry>
-              <entry colname="colspec1">
-                <para>Select this option to display a medium mouse
-pointer.</para>
-              </entry>
-            </row>
-            <row>
               <entry valign="top">
                 <para>
-                  <guilabel>Large</guilabel>
+                  <guilabel>Cursor Theme</guilabel>
                 </para>
               </entry>
               <entry valign="top">
-                <para>Select this option to display a large mouse pointer.</para>
+                <para>Select the mouse pointer theme that you require
+from the list box. </para>
               </entry>
             </row>
             <row>