rewrite 'Mouse Skills' and 'Mouse Button Conventions'. Patch from

  * gosbasic.xml: rewrite 'Mouse Skills' and 'Mouse Button Conventions'. Patch from karderio. Fixes #381418

2 files changed, 32 insertions, 29 deletions

diff --git a/gnome2-user-guide/C/ChangeLog b/gnome2-user-guide/C/ChangeLog
index a44c080..091b48c 100644
--- a/gnome2-user-guide/C/ChangeLog
+++ b/gnome2-user-guide/C/ChangeLog
@@ -1,6 +1,7 @@
 2006-12-02  Joachim Noreiko  <jnoreiko@yahoo.com>
 
 	* gostools.xml: mention opening files in Yelp from Nautilus. Patch from karderio. Fixes #381377
+  * gosbasic.xml: rewrite 'Mouse Skills' and 'Mouse Button Conventions'. Patch from karderio. Fixes #381418
 
 2006-11-11  Joachim Noreiko  <jnoreiko@yahoo.com>
 
diff --git a/gnome2-user-guide/C/gosbasic.xml b/gnome2-user-guide/C/gosbasic.xml
index 55e2670..dcbee8c 100644
--- a/gnome2-user-guide/C/gosbasic.xml
+++ b/gnome2-user-guide/C/gosbasic.xml
@@ -36,9 +36,14 @@
   * pointers
   -->
 
-  <para>This section describes the button conventions and action
-  terminology used in this manual, and also the
-  mouse pointers used throughout the desktop and applications.</para>
+  <para>
+        This section describes what the mouse buttons do, and what the different pointers mean.
+  </para>
+
+    <para>A mouse is a pointing device that lets you move the mouse pointer on the screen. The mouse pointer is usually
+a small arrow with which you point to objects on your screen. Pressing a mouse button will perform a particular
+action on the object over which your mouse pointer is situated, depending on which button you press.
+    </para>
 
   <section id="mouse-conventions">
     <title>Mouse Button Conventions</title>
@@ -52,49 +57,46 @@
       <secondary>button conventions</secondary>
     </indexterm>
 
-    <para>All the instructions in this manual are for the following
-    types of mouse devices:</para>
-    <itemizedlist>
-      <listitem>
-        <para>Devices that are configured for right-hand users.</para>
-      </listitem>
-      <listitem>
-        <para>Three button devices.</para>
-      </listitem>
-    </itemizedlist>
+    <para>The instructions in this manual are for three buttoned, right handed mouse devices, the most common type.
+        If you use another type of mouse or pointing device, you should take care to locate the corresponding buttons on your mouse.  If you use a left-handed mouse
+        see the paragraph on setting mouse orientation below.
+    </para>
+
+        <note><para>If you set your mouse device to be left handed, you should reverse the mouse button
+        conventions used in this manual. This is normally also implied in most documentation and in many
+        applications.</para></note>
+
+    <para>Some mice lack a middle button. If you have a two-button mouse device,
+    then your system may be configured to use <firstterm>chording</firstterm> to allow middle button simulation. If chording is activated,
+    you press the left and right mouse buttons simultaneously, to simulate the 
+    the middle mouse button. A middle mouse button is by no means necessary to use GNOME.</para>
 
     <para>The mouse button conventions used in this manual are as
     follows:</para>
     <variablelist>
       <varlistentry>
         <term>Left mouse button</term>
-        <listitem><para>The button on the left side of a mouse device
-        configured for normal right-hand use.</para></listitem>
+        <listitem><para>The button on the left side of a mouse device. This is the main mouse button, used for selecting,
+        activating, pressing buttons etc... When you are told to "click" it is implied that you should click with the left button,
+        unless specifically stated.
+        </para></listitem>
       </varlistentry>
       <varlistentry>
         <term>Middle mouse button</term>
-        <listitem><para>The middle button of a mouse device configured
-        for normal right-hand use.  On many mice with a scroll wheel,
-        the scroll wheel can be pushed directly down for a middle mouse
+        <listitem><para>The middle button of a mouse device.  On many mice with a scroll wheel,
+        the scroll wheel can be pushed down for a middle mouse
         button click.</para></listitem>
       </varlistentry>
       <varlistentry>
         <term>Right mouse button</term>
-        <listitem><para>The button on the right side of a mouse device
-        configured for normal right-hand use.</para></listitem>
+        <listitem><para>The button on the right side of a mouse device. Often, this button displays
+        a context menu for the object under the pointer.</para></listitem>
       </varlistentry>
     </variablelist>
-    <para>To reverse the handedness of your mouse device, start the
-    <application>Mouse Preferences</application>, then select the options
-    that you require.  If you do reverse the handedness of your mouse device,
-    then you must reverse the mouse button conventions used in this manual.
+
+    <para>Use <application>Mouse Preferences</application> to reverse the orientation of your mouse device. You will then need to reverse the mouse button conventions used in this manual and other GNOME documentation.
     See <xref linkend="prefs-mouse"/> for more information about setting
     your mouse preferences.</para>
-    
-    <para>If you have a two-button mouse device,
-    then your system may be configured to allow you to press the left
-    and right mouse buttons simultaneously to simulate the effect of
-    a middle mouse button press.</para>
 
   </section>