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	15 Jan 2006 17:47:19 -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>System</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
@@ -73,25 +73,12 @@
 <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>
-</listitem>
-<listitem>
-<para>Medium</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>This will display a list of cursor themes and sizes available.</para>
 </listitem>
 </orderedlist>
+<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>
@@ -172,7 +159,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>System</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 +177,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>System</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 +216,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>System</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 +249,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 +265,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 +308,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 +344,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 +352,7 @@
 <para>/</para>
 </entry>
 <entry valign="top">
-<para>Mouse button 1</para>
+<para>Primary mouse button</para>
 </entry>
 </row>
 <row>
@@ -387,7 +360,7 @@
 <para>*</para>
 </entry>
 <entry colname="colspec1" valign="top">
-<para>Mouse button 2</para>
+<para>Secondary mouse button</para>
 </entry>
 </row>
 <row>
@@ -395,64 +368,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 +453,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 +521,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 +560,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 +579,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 +679,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 +704,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 +733,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 +768,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 +803,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 +972,7 @@
 </tbody>
 </tgroup>
 </table>
+
+
 </sect1>
 </chapter>
