Index: dtconfig.xml
===================================================================
RCS file: /cvs/gnome/gnome-user-docs/gnome2-accessibility-guide/C/dtconfig.xml,v
retrieving revision 1.7
diff -u -r1.7 dtconfig.xml
--- dtconfig.xml	29 Jul 2005 13:13:27 -0000	1.7
+++ dtconfig.xml	28 Jan 2006 13:28:00 -0000
@@ -6,7 +6,7 @@
 <title>Configuring the Mouse</title>
 <para>Use the <guilabel>Mouse</guilabel> preference tool to configure the
 mouse to suit your needs. To open the <guilabel>Mouse</guilabel> preference
-tool, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>Mouse</guimenuitem></menuchoice>. The <guilabel>Mouse Preferences</guilabel> dialog is displayed.</para>
+tool, choose <menuchoice><guimenu>Desktop</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Mouse</guimenuitem></menuchoice>. The <guilabel>Mouse Preferences</guilabel> dialog is displayed.</para>
 <sect2 id="dtconfig-2">
 <title>To Configure the Behavior of the Mouse</title>
 <para>The following sections describe how to modify the behavior of the mouse
@@ -43,7 +43,7 @@
 </listitem>
 <listitem>
 <para>Use the <guilabel>Timeout</guilabel> slider to specify the
-timeout in seconds that the system allows between the two clicks of a double-click. </para>
+timeout in seconds that the system allows between the two clicks of a double-click. Moving the slider to the right will increase the timeout interval in 0.1 second intervals.  In the same manner, moving the slider to the left will decrease the timeout in 0.1 second intervals.</para>
 </listitem>
 <listitem>
 <para>Double-click on the light bulb to the right of the slider
@@ -57,41 +57,32 @@
 </orderedlist>
 </sect3>
 <sect3 id="dtconfig-20">
-<title>To Change the Size of the Cursor and Pointer</title>
+<title>To Change the Size of the Mouse Pointer</title>
 <indexterm>
 <primary>mouse</primary>
-<secondary>cursor and pointer size</secondary>
+<secondary>pointer size</secondary>
 </indexterm>
 <indexterm>
-<primary>cursor</primary>
+<primary>pointer</primary>
 <secondary>size</secondary>
 </indexterm>
-<para>To change the size of the cursor and pointer that is displayed
+<para>To change the size of the mouse pointer that is displayed
 on the desktop, perform the following steps:</para>
 <orderedlist>
 <listitem>
-<para>Click on the <guilabel>Cursors</guilabel> tab in the <guilabel>Mouse Preferences</guilabel> dialog. </para>
-</listitem>
-<listitem>
-<para>Select one of the following <guilabel>Cursor Size</guilabel>
-options:</para>
-<itemizedlist>
-<listitem>
-<para>Small</para>
+<para>Click on the <guilabel>Pointers</guilabel> tab in the <guilabel>Mouse Preferences</guilabel> dialog. </para>
 </listitem>
 <listitem>
-<para>Medium</para>
+<para>This will display a list of pointer themes and sizes available.</para>
 </listitem>
 <listitem>
-<para>Large</para>
-</listitem>
-</itemizedlist>
-</listitem>
-<listitem>
-<para>To complete this change, you must log out of your session
-and log in again.</para>
+<para>By default, GNOME does not include mouse pointer themes.  Information about installing and using pointer themes can be found in the User Guide.</para>
 </listitem>
 </orderedlist>
+<!-- GNOME does not currently ship with default pointers.  When it does, this needs updated. -->
+<note>
+<para>On some platforms you must log out and log in again for this setting to take effect.</para>
+</note>
 </sect3>
 <sect3 id="dtconfig-6">
 <title>To Locate the Mouse Pointer</title>
@@ -100,7 +91,7 @@
 <secondary>locating pointer</secondary>
 </indexterm>
 <para>If you have difficulty locating the mouse pointer on the
-screen, you can enable an option to highlight the pointer when you press the <keycap>Control</keycap> key. To enable this option, click on the <guilabel>Cursors</guilabel> tab in the <guilabel>Mouse Preferences</guilabel> dialog, then
+screen, you can enable an option to highlight the pointer when you press the <keycap>Control</keycap> key. To enable this option, click on the <guilabel>Pointers</guilabel> tab in the <guilabel>Mouse Preferences</guilabel> dialog, then
 select the <guilabel>Highlight the pointer when you press Ctrl</guilabel>
 option. When you press <keycap>Control</keycap>, the system displays an animation
 around the pointer to highlight the pointer. </para>
@@ -142,7 +133,7 @@
 <term>Sensitivity</term>
 <listitem>
 <para>Use the slider to specify
-how sensitive the mouse pointer is to movements of your mouse.</para>
+how responsive the mouse pointer is to movements of your mouse. Moving the slider to the right will increase the sensitivity and moving it to the left will decrease the sensitivity.</para>
 </listitem>
 </varlistentry>
 <varlistentry>
@@ -172,7 +163,7 @@
 steps: </para>
 <orderedlist>
 <listitem>
-<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice> to start the <application>Keyboard</application> preference tool.</para>
+<para>Choose <menuchoice><guimenu>Desktop</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice> to start the <application>Keyboard</application> preference tool.</para>
 </listitem>
 <listitem>
 <para>In the <guilabel>Keyboard</guilabel> tabbed section, deselect
@@ -190,9 +181,7 @@
 </sect1>
 <sect1 id="dtconfig-11">
 <title>Configuring the Keyboard</title>
-<para>Use the <application>Keyboard Accessibility</application> preference
-tool, also known as <application>AccessX</application>, to configure the keyboard
-accessibility options. To start <application>AccessX</application>, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
+<para>Use the <application>Keyboard</application> preference tool, to configure the keyboard accessibility options. To open the <application>Keyboard</application> preference tool, choose <menuchoice><guimenu>Desktop</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.  Accessibility options can be enabled by selecting <guilabel>Accessibility</guilabel>.  This will open a new dialog, <application>Keyboard Accessibility Preferences</application>, also known as <application>AccessX</application>.</para>
 <note>
 <para>Before you can use the <application>Keyboard Accessibility</application>
 preference tool on Solaris systems, you must follow the steps outlined in <xref linkend="sysadmin-55"/> of this guide.</para>
@@ -231,7 +220,7 @@
 <para>To activate the keyboard accessibility options, perform the following steps: </para>
 <orderedlist>
 <listitem>
-<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
+<para>Choose <menuchoice><guimenu>Desktop</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice> and select <guilabel>Accessibility</guilabel></para>
 </listitem>
 <listitem>
 <para>Select the <guilabel>Enable keyboard accessibility features</guilabel> option.</para>
@@ -264,8 +253,7 @@
 different users, some of whom require the keyboard accessibility options. </para>
 </listitem>
 <listitem>
-<para>If you are a Linux user, log out and log in again before the
-accessibility settings take effect.</para>
+<para>Changes made will be instantly applied.</para>
 </listitem>
 </orderedlist>
 </sect2>
@@ -281,10 +269,7 @@
 steps:</para>
 <orderedlist>
 <listitem>
-<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
-</listitem>
-<listitem>
-<para>Click on the <guilabel>Mouse Keys</guilabel> tab.</para>
+<para>In the <application>Keyboard Accessibility Preferences (AccessX)</application> dialog, select the <guilabel>Mouse Keys</guilabel> tab.</para>
 </listitem>
 <listitem>
 <para>Select the <guilabel>Enable Mouse Keys</guilabel> option.</para>
@@ -327,7 +312,7 @@
 <para>When you enable mouse keys, the keys on the numeric keypad have the
 following functions:</para>
 <table frame="topbot" id="dtconfig-TBL-1">
-<title>Numeric Keypad to Mouse Function Mapping on Solaris Systems</title>
+<title>Numeric Keypad to Mouse Function Mapping</title>
 <tgroup cols="2" colsep="0" rowsep="0">
 <colspec colname="colspec0" colwidth="52.78*"/>
 <colspec colname="colspec1" colwidth="47.22*"/>
@@ -363,15 +348,7 @@
 <para>0</para>
 </entry>
 <entry colname="colspec1" valign="top">
-<para>Mouse button double-click</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0" valign="top">
-<para>.</para>
-</entry>
-<entry colname="colspec1" valign="top">
-<para>Mouse button press</para>
+<para>Mouse button toggle</para>
 </entry>
 </row>
 <row>
@@ -379,7 +356,7 @@
 <para>/</para>
 </entry>
 <entry valign="top">
-<para>Mouse button 1</para>
+<para>Primary mouse button</para>
 </entry>
 </row>
 <row>
@@ -387,7 +364,7 @@
 <para>*</para>
 </entry>
 <entry colname="colspec1" valign="top">
-<para>Mouse button 2</para>
+<para>Secondary mouse button</para>
 </entry>
 </row>
 <row>
@@ -395,64 +372,21 @@
 <para>&minus;</para>
 </entry>
 <entry colname="colspec1" valign="top">
-<para>Mouse button 3</para>
-</entry>
-</row>
-</tbody>
-</tgroup>
-</table>
-<table frame="topbot" id="dtconfig-TBL-4">
-<title>Numeric Keypad to Mouse Function Mapping on Linux Systems</title>
-<tgroup cols="2" colsep="0" rowsep="0">
-<colspec colname="colspec0" colwidth="50*"/>
-<colspec colname="colspec1" colwidth="50*"/>
-<thead>
-<row rowsep="1">
-<entry>
-<para>Numeric Keypad Keys</para>
-</entry>
-<entry>
-<para>Function</para>
-</entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry>
-<para>1, 2, 3, 4, 6, 7, 8, 9</para>
-</entry>
-<entry>
-<para>Move the
-mouse pointer around the screen</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0">
-<para>5</para>
-</entry>
-<entry colname="colspec1">
-<para>Mouse button click</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0">
-<para>+</para>
-</entry>
-<entry colname="colspec1">
-<para>Mouse button double-click</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0">
-<para>0</para>
-</entry>
-<entry colname="colspec1">
-<para>Mouse button 3</para>
+<para>Tertiary mouse button</para>
 </entry>
 </row>
 </tbody>
 </tgroup>
 </table>
+
+<para>The toggle mouse button key enable the currently selected mouse button until the <guilabel>Mouse button click</guilabel> key is pressed.  This allows you to perform drag and drop operations.</para>
+
+<para>The <guilabel>Mouse button click</guilabel> emulates the currently selected mouse button.  Pressing <keycap>/</keycap>, <keycap>*</keycap> or <keycap>&minus;</keycap> will change the behaviour of this.  The currently selected mouse button can be seen in the <application>Keyboard Accessibility Status</application> panel application, discussed in <xref linkend="dtconfig-21"/>.</para>
+
+<note>
+<para>The <guilabel>Primary mouse button</guilabel> is the left mouse button for right handed people.  The <guilabel>Secondary mouse button</guilabel> is the right mouse button and the <guilabel>Tertiary mouse button</guilabel> is the middle mouse button.</para>
+</note>
+
 <para>Some Solaris systems also use the function keys to emulate the mouse
 buttons. The common function key to mouse button mappings are described in
 the following table.</para>
@@ -523,20 +457,15 @@
 steps:</para>
 <orderedlist>
 <listitem>
-<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
-</listitem>
-<listitem>
-<para>Click on the <guilabel>Filters</guilabel> tab.</para>
+<para>From the <application>Keyboard Accessibility Preferences (AccessX)</application> dialog, select the <guilabel>Filters</guilabel> tab.</para>
 </listitem>
 <listitem>
 <para>Select the <guilabel>Enable Slow Keys</guilabel> option. </para>
 <tip>
 <para>To select or deselect the slow keys feature from the keyboard,
-press-and-hold <keycap>Shift</keycap> for eight seconds. The <keycap>Shift</keycap> keyboard shortcut automatically selects all of the slow keys options.
+press-and-hold <keycap>Shift</keycap> for eight seconds. This will present a dialog confirming that you with slow keys enabled.  The <keycap>Shift</keycap> keyboard shortcut automatically selects all of the slow keys options.
 If you selected the <guilabel>Beep when features turned on or off from the
-keyboard</guilabel> option, after four seconds the system beeps three times
-to indicate that the system is about to select or deselect the feature. If
-you enable this feature from the keyboard, you must press-and-hold <keycap>Shift</keycap> for eight seconds again to disable the feature.</para>
+keyboard</guilabel> option in the <guilabel>Basic</guilabel> tab, after four seconds the system beeps three times to indicate that the system is about to select or deselect the feature.</para>
 </tip>
 </listitem>
 <listitem>
@@ -596,10 +525,7 @@
 steps:</para>
 <orderedlist>
 <listitem>
-<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
-</listitem>
-<listitem>
-<para>Click on the <guilabel>Filters</guilabel> tab.</para>
+<para>From the <application>Keyboard Accessibility Preferences (AccessX)</application> dialog select the <guilabel>Filters</guilabel> tab.</para>
 </listitem>
 <listitem>
 <para>Select the <guilabel>Enable Bounce Keys</guilabel> option. </para>
@@ -638,20 +564,16 @@
 steps:</para>
 <orderedlist>
 <listitem>
-<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
-</listitem>
-<listitem>
-<para>Click on the <guilabel>Basic</guilabel> tab.</para>
+<para>From the <application>Keyboard Accessibility Preferences (AccessX)</application> select the <guilabel>Basic</guilabel> tab.</para>
 </listitem>
 <listitem>
 <para>Select the <guilabel>Enable Sticky Keys</guilabel> option.</para>
 <tip>
-<para>To enable the sticky keys feature from the keyboard, press <keycap>Shift</keycap> five times. The <keycap>Shift</keycap> keyboard shortcut automatically
+<para>To enable the sticky keys feature from the keyboard, press <keycap>Shift</keycap> five times. This will present a dialog confirming that you with to enable sticky keys.  The <keycap>Shift</keycap> keyboard shortcut automatically
 selects all of the sticky keys options. If you selected the <guilabel>Beep
 when features turned on or off from the keyboard</guilabel> option, the system
 beeps to indicate that the system is about to select or deselect the feature.
-If you enable this feature from the keyboard, press <keycap>Shift</keycap>
-five times again to disable the feature.</para>
+When active, pressing <keycap>shift</keycap> five times in a row will present a dialog asking if you want to disable sticky keys.</para>
 </tip>
 </listitem>
 <listitem>
@@ -661,9 +583,8 @@
 This option is useful to remind you whether a modifier key is active or inactive. </para>
 </listitem>
 <listitem>
-<para>To automatically disable the sticky keys feature when you
-press two keys simultaneously, select the <guilabel>Disable if two keys pressed
-together</guilabel> option.</para>
+<para>Selecting the <guilabel>Disable if two keys pressed
+together</guilabel> option will present a dialog with the option to disable sticky keys if two keys are pressed at the same time.</para>
 </listitem>
 </orderedlist>
 <para>You can use the sticky keys feature in latch or lock mode. The following
@@ -762,10 +683,7 @@
 <para>To enable accessible toggle keys, perform the following steps: </para>
 <orderedlist>
 <listitem>
-<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
-</listitem>
-<listitem>
-<para>Click on the <guilabel>Filters</guilabel> tab.</para>
+<para>From the <application>Keyboard Accessibility Preferences (AccesX)</application> select the <guilabel>Filters</guilabel> tab.</para>
 </listitem>
 <listitem>
 <para>Select the <guilabel>Enable Toggle Keys</guilabel> option.</para>
@@ -790,10 +708,7 @@
 steps: </para>
 <orderedlist>
 <listitem>
-<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
-</listitem>
-<listitem>
-<para>Click on the <guilabel>Basic</guilabel> tab.</para>
+<para>From the <application>Keyboard Accessibility Preferences (AccessX)</application> select the <guilabel>Basic</guilabel> tab.</para>
 </listitem>
 <listitem>
 <para>Select the <guilabel>Enable Repeat Keys</guilabel> option.</para>
@@ -822,7 +737,7 @@
 features are enabled in the <application>Keyboard Accessibility</application>
 preference tool.</para>
 <para>To add the <application>Keyboard Accessibility Status</application>
-panel application to a panel, right-click on the panel, then choose <menuchoice><guimenu>Add to Panel</guimenu><guisubmenu>Accessories</guisubmenu><guimenuitem>Keyboard Accessibility Status</guimenuitem></menuchoice>.</para>
+panel application to a panel, right-click on the panel, then choose <menuchoice><guimenu>Add to Panel</guimenu></menuchoice> and select the <guimenuitem>Keyboard Accessibility Status</guimenuitem>.</para>
 <para>The following table describes the icons that the panel application displays
 and the status that each icon represents.</para>
 <table frame="topbot" id="dtconfig-TBL-25">
@@ -857,7 +772,7 @@
 </entry>
 <entry valign="middle">
 <para>Keyboard accessibility in general
-is enabled but none of the individual key features are enabled.</para>
+is available but none of the individual key features are enabled.</para>
 </entry>
 </row>
 <row>
@@ -892,7 +807,7 @@
 </screenshot>
 </entry>
 <entry valign="middle">
-<para>The mouse keys feature is enabled.</para>
+<para>The mouse keys feature is enabled.  The dot in the mouse button shows which button is currently associated with the <guilabel>Mouse button click</guilabel> key.</para>
 </entry>
 </row>
 <row>
@@ -1061,5 +976,7 @@
 </tbody>
 </tgroup>
 </table>
+
+
 </sect1>
 </chapter>
