- Update Keyboard capplet documentation, from mclasen, bug #571030

* C/goscustdesk.xml:
- Update Keyboard capplet documentation, from mclasen, bug #571030

svn path=/trunk/; revision=1108

2 files changed, 356 insertions, 447 deletions

diff --git a/gnome2-user-guide/C/goscustdesk.xml b/gnome2-user-guide/C/goscustdesk.xml
index cdb5589..c455908 100644
--- a/gnome2-user-guide/C/goscustdesk.xml
+++ b/gnome2-user-guide/C/goscustdesk.xml
@@ -134,437 +134,6 @@ keyboard</application> application automatically when you log in.</para>
     </table>
   </sect2>
 
-
-  <sect2 id="prefs-keyboard-a11y">
-    <title>Keyboard Accessibility Preferences</title>
-
-    <!-- Maintained for 2.8 compatibility -->
-    <anchor id="goscustaccess-6"/>
-    <indexterm>
-      <primary>AccessX</primary>
-      <see>preference tools, Keyboard Accessibility</see>
-    </indexterm>
-    <indexterm>
-      <primary>keyboard</primary>
-      <secondary>configuring
-accessibility options</secondary>
-    </indexterm>
-    <indexterm>
-      <primary>accessibility</primary>
-      <secondary>configuring keyboard</secondary>
-    </indexterm>
-    <indexterm>
-      <primary>preference tools</primary>
-      <secondary>Keyboard Accessibility</secondary>
-    </indexterm>
-    <para>The <application>Keyboard Accessibility</application> preference tool allows you to set  options such as filtering out accidental keypresses, using the keyboard as a substitute for the mouse, and using shortcut keys without having to hold down several keys at once. The <application>Keyboard</application> accessibility preference tool is also known as <application>AccessX</application>.</para>
-    <para>This section describes each of the preferences you can set. For a more task-oriented description of keyboard accessibility, see the <ulink type="help" url="ghelp:gnome-access-guide?index"><citetitle>GNOME Desktop Accessibility Guide</citetitle></ulink>.</para> 
-    <para>To open the <application>Keyboard Accessibility</application> preference tool, do one of the following:</para>
-    <itemizedlist>
-      <listitem>
-        <para>From the <guimenu>Main Menu</guimenu>, choose <menuchoice><guimenu>System</guimenu><guimenuitem>Preferences</guimenuitem><guimenuitem>Accessibility</guimenuitem><guimenuitem>Keyboard</guimenuitem></menuchoice>.
-        </para>
-      </listitem>
-      <listitem>
-        <para>In the <application>Keyboard</application> preference tool, click the <guibutton>Accessibility</guibutton> button.
-        </para>
-      </listitem>
-    </itemizedlist> 
-    <para>You can customize the preferences for the keyboard accessibility in
-the following functional areas:</para>
-    <itemizedlist>
-      <listitem>
-        <para>
-          <guilabel>Basic</guilabel>
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          <guilabel>Filters</guilabel>
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          <guilabel>Mouse</guilabel>
-        </para>
-      </listitem>
-    </itemizedlist>
-
-    <sect3 id="goscustaccess-8">
-      <title>Basic Preferences</title>
-      <para><xref linkend="goscustaccess-TBL-1"/> lists the basic keyboard accessibility
-preferences that you can modify.</para>
-      <table frame="topbot" id="goscustaccess-TBL-1">
-        <title>Keyboard Accessibility Preferences</title>
-        <tgroup cols="2" colsep="0" rowsep="0">
-          <colspec colname="colspec0" colwidth="25.64*"/>
-          <colspec colname="colspec1" colwidth="74.36*"/>
-          <thead>
-            <row rowsep="1">
-              <entry>
-                <para>Dialog Element</para>
-              </entry>
-              <entry>
-                <para>Description</para>
-              </entry>
-            </row>
-          </thead>
-          <tbody>
-            <row>
-              <entry colname="colspec0" valign="top">
-                <para>
-                  <guilabel>Enable keyboard
-accessibility features</guilabel>
-                </para>
-              </entry>
-              <entry colname="colspec1" valign="top">
-                <para>Select this option to enable keyboard accessibility features.
-When you select this option, the other options in the preference tool become
-available.</para>
-              </entry>
-            </row>
-            <row>
-              <entry colname="colspec0" valign="top">
-                <para>
-                  <guilabel>Disable if unused
-for</guilabel>
-                </para>
-              </entry>
-              <entry colname="colspec1" valign="top">
-                <para>Select this option to deactivate keyboard accessibility preferences if the
-keyboard is not used for a specified period of time. Use the slider to specify
-the number of seconds of keyboard idle time required before the system disables
-the keyboard accessibility preferences.  When the specified number of seconds
-elapses, the following keyboard accessibility preferences are disabled:</para>
-                <itemizedlist>
-                  <listitem>
-                    <para>Bounce keys</para>
-                  </listitem>
-                  <listitem>
-                    <para>Mouse keys</para>
-                  </listitem>
-                  <listitem>
-                    <para>Slow keys</para>
-                  </listitem>
-                  <listitem>
-                    <para>Sticky keys</para>
-                  </listitem>
-                  <listitem>
-                    <para>Toggle keys</para>
-                  </listitem>
-                </itemizedlist>
-              </entry>
-            </row>
-            <row>
-              <entry colname="colspec0" valign="top">
-                <para>
-                  <guilabel>Beep when features
-turned on or off from keyboard</guilabel>
-                </para>
-              </entry>
-              <entry colname="colspec1" valign="top">
-                <para>Select this option for an audible indication when a feature
-such as sticky keys or slow keys is activated, or deactivated.</para>
-              </entry>
-            </row>
-            <row>
-              <entry colname="colspec0" valign="top">
-                <para>
-                  <guibutton>Import Feature
-Settings</guibutton>
-                </para>
-              </entry>
-              <entry colname="colspec1" valign="top">
-                <para>Click on this button to import an <application>AccessX</application> configuration
-file. </para>
-              </entry>
-            </row>
-            <row>
-              <entry colname="colspec0" valign="top">
-                <para>
-                  <guilabel>Enable Sticky
-Keys</guilabel>
-                </para>
-                <indexterm>
-                  <primary>accessibility</primary>
-                  <secondary>sticky keys</secondary>
-                </indexterm>
-              </entry>
-              <entry colname="colspec1" valign="top">
-                <para>Select this option to perform multiple simultaneous keypress operations by
-pressing the keys in sequence. Alternatively, to enable the sticky keys feature,
-press <keycap>Shift</keycap> five times.</para>
-                <para>You can set the following
-sticky keys preferences:</para>
-                <itemizedlist>
-                  <listitem>
-                    <para><guilabel>Beep when modifier is pressed</guilabel>: Select
-this option for an audible indication when you press a modifier key. </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Disable if two keys pressed together</guilabel>:
-Select this option to specify that when you press two keys simultaneously,
-you can no longer press keys in sequence to perform multiple simultaneous
-keypresses.</para>
-                  </listitem>
-                </itemizedlist>
-              </entry>
-            </row>
-            <row>
-              <entry colname="colspec0" valign="top">
-                <para>
-                  <guilabel>Enable Repeat
-Keys</guilabel>
-                </para>
-                <indexterm>
-                  <primary>accessibility</primary>
-                  <secondary>repeat keys</secondary>
-                </indexterm>
-              </entry>
-              <entry colname="colspec1" valign="top">
-                <para>Select this option to enable the autorepeat settings for your keyboard. You
-can set the following autorepeat preferences:</para>
-                <itemizedlist>
-                  <listitem>
-                    <para><guilabel>Delay</guilabel>: Use the slider or the spin box
-to specify the interval to wait after the first keypress before the automatic
-repeat of a pressed key. </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Speed</guilabel>: Use the slider or the spin box
-to specify the number of characters per second to enter. </para>
-                  </listitem>
-                </itemizedlist>
-              </entry>
-            </row>
-            <row>
-              <entry colname="colspec0" valign="top">
-                <para>
-                  <guilabel>Type to test settings</guilabel>
-                </para>
-              </entry>
-              <entry colname="colspec1" valign="top">
-                <para>The
-test area is an interactive interface so you can see how the keyboard settings
-affect the display as you type. Type text in the test area to test the effect
-of your settings.</para>
-              </entry>
-            </row>
-          </tbody>
-        </tgroup>
-      </table>
-      <para>For more information on configuring keyboard accessibility preferences,
-see the <ulink type="help" url="ghelp:gnome-access-guide?index"><citetitle>GNOME Desktop Accessibility Guide</citetitle></ulink>.</para>
-    </sect3>
-    <sect3 id="goscustaccess-9">
-      <title>Filter Preferences</title>
-      <para><xref linkend="goscustaccess-TBL-11"/> lists the filter preferences that
-you can modify.</para>
-      <table frame="topbot" id="goscustaccess-TBL-11">
-        <title>Filter Preferences</title>
-        <tgroup cols="2" colsep="0" rowsep="0">
-          <colspec colname="colspec0" colwidth="25.64*"/>
-          <colspec colname="colspec1" colwidth="74.36*"/>
-          <thead>
-            <row rowsep="1">
-              <entry>
-                <para>Dialog Element</para>
-              </entry>
-              <entry>
-                <para>Description</para>
-              </entry>
-            </row>
-          </thead>
-          <tbody>
-            <row>
-              <entry colname="colspec0" valign="top">
-                <para>
-                  <guilabel>Enable keyboard
-accessibility features</guilabel>
-                </para>
-              </entry>
-              <entry colname="colspec1" valign="top">
-                <para>Select this option to enable keyboard accessibility features.
-When you select this option, the other options in the preference tool become
-available.</para>
-              </entry>
-            </row>
-            <row>
-              <entry colname="colspec0" valign="top">
-                <para>
-                  <guilabel>Enable Slow Keys</guilabel>
-                </para>
-                <indexterm>
-                  <primary>accessibility</primary>
-                  <secondary>slow keys</secondary>
-                </indexterm>
-              </entry>
-              <entry colname="colspec1" valign="top">
-                <para>Select this option to control the period of time that you must press-and-hold
-a key before acceptance. Alternatively, to enable the slow keys feature, press-and-hold <keycap>Shift</keycap> for eight seconds.</para>
-                <para>You can set the following slow
-keys preferences: </para>
-                <itemizedlist>
-                  <listitem>
-                    <para><guilabel>Only accept keys held for</guilabel>: Use the slider
-or the spin box to specify the period of time that you must press-and-hold
-a key before acceptance. </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Beep when key is</guilabel>: Select the appropriate
-option or options for an audible indication  when a key is pressed, accepted,
-or rejected. </para>
-                  </listitem>
-                </itemizedlist>
-              </entry>
-            </row>
-            <row>
-              <entry colname="colspec0" valign="top">
-                <para>
-                  <guilabel>Enable Bounce
-Keys</guilabel>
-                </para>
-                <indexterm>
-                  <primary>accessibility</primary>
-                  <secondary>bounce keys</secondary>
-                </indexterm>
-              </entry>
-              <entry colname="colspec1" valign="top">
-                <para>Select this option to accept a key input and to control the key repeat characteristics
-of the keyboard. You can set the following bounce keys preferences:  </para>
-                <itemizedlist>
-                  <listitem>
-                    <para><guilabel>Ignore duplicate keypresses within</guilabel>: Use
-the slider or the spin box to specify the interval to wait after the first
-keypress before the automatic repeat of a pressed key. </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Beep if key is rejected</guilabel>: Select this
-option for an audible indication of key rejection. </para>
-                  </listitem>
-                </itemizedlist>
-              </entry>
-            </row>
-            <row>
-              <entry colname="colspec0" valign="top">
-                <para>
-                  <guilabel>Enable Toggle
-Keys</guilabel>
-                </para>
-                <indexterm>
-                  <primary>accessibility</primary>
-                  <secondary>toggle keys</secondary>
-                </indexterm>
-              </entry>
-              <entry colname="colspec1" valign="top">
-                <para>Select this option for an audible indication of a toggle keypress. You hear
-one beep when a toggle key is turned on. You hear two beeps when a toggle
-key is turned off.</para>
-              </entry>
-            </row>
-            <row>
-              <entry colname="colspec0" valign="top">
-                <para>
-                  <guilabel>Type to test settings</guilabel>
-                </para>
-              </entry>
-              <entry colname="colspec1" valign="top">
-                <para>The
-test area is an interactive interface so you can see how the keyboard settings
-affect the display as you type. Type text in the test area to test the effect
-of your settings.</para>
-              </entry>
-            </row>
-          </tbody>
-        </tgroup>
-      </table>
-      <para>For more information on configuring keyboard accessibility preferences,
-see the <ulink type="help" url="ghelp:gnome-access-guide?index"><citetitle>GNOME Desktop Accessibility Guide</citetitle></ulink>.</para>
-    </sect3>
-    <sect3 id="goscustaccess-10">
-      <title>Mouse Preferences</title>
-      <para><xref linkend="goscustaccess-TBL-12"/> lists the mouse preferences that
-you can modify.</para>
-      <table frame="topbot" id="goscustaccess-TBL-12">
-        <title>Mouse Preferences</title>
-        <tgroup cols="2" colsep="0" rowsep="0">
-          <colspec colname="colspec0" colwidth="25.64*"/>
-          <colspec colname="colspec1" colwidth="74.36*"/>
-          <thead>
-            <row rowsep="1">
-              <entry>
-                <para>Dialog Element</para>
-              </entry>
-              <entry>
-                <para>Description</para>
-              </entry>
-            </row>
-          </thead>
-          <tbody>
-            <row>
-              <entry colname="colspec0" valign="top">
-                <para>
-                  <guilabel>Enable keyboard
-accessibility features</guilabel>
-                </para>
-              </entry>
-              <entry colname="colspec1" valign="top">
-                <para>Select this option to enable keyboard accessibility features.
-When you select this option, the other options in the preference tool become
-available.</para>
-              </entry>
-            </row>
-            <row>
-              <entry colname="colspec0" valign="top">
-                <para>
-                  <guilabel>Enable Mouse Keys</guilabel>
-                </para>
-                <indexterm>
-                  <primary>accessibility</primary>
-                  <secondary>mouse keys</secondary>
-                </indexterm>
-              </entry>
-              <entry colname="colspec1" valign="top">
-                <para>Select this option to make the numeric keypad emulate mouse actions. The list of keys and their equivalences is in the <citetitle>GNOME Desktop Accessibility Guide</citetitle> under the heading <ulink type="help" url="ghelp:gnome-access-guide?dtconfig-14"><citetitle>To Enable the Keyboard to Emulate the Mouse</citetitle></ulink>.</para>
-                <para>You can
-set the following mouse key preferences: </para>
-                <itemizedlist>
-                  <listitem>
-                    <para><guilabel>Maximum pointer speed</guilabel>: Use the slider
-or the spin box to specify the maximum speed that the pointer moves across
-the screen.</para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Time to accelerate to maximum speed</guilabel>:
-Use the slider or the spin box to specify the duration of the acceleration
-time of the pointer. </para>
-                  </listitem>
-                  <listitem>
-                    <para><guilabel>Delay between keypress and pointer movement</guilabel>:
-Use the slider or the spin box to specify the period of time that must pass
-after a keypress before the pointer moves. </para>
-                  </listitem>
-                </itemizedlist>
-              </entry>
-            </row>
-            <row>
-              <entry colname="colspec0">
-                <para>
-                  <guibutton>Mouse Preferences</guibutton>
-                </para>
-              </entry>
-              <entry colname="colspec1">
-                <para>Click on this button to open the <application>Mouse</application> preference tool.</para>
-              </entry>
-            </row>
-          </tbody>
-        </tgroup>
-      </table>
-      <para>For more information on configuring keyboard accessibility preferences,
-see the <ulink type="help" url="ghelp:gnome-access-guide?index"><citetitle>GNOME Desktop Accessibility Guide</citetitle></ulink>.</para>
-    </sect3>
-  </sect2>
-
   <sect2 id="prefs-keyboard-shortcuts">
     <title>Keyboard Shortcuts Preferences</title>
 
@@ -1947,9 +1516,8 @@ preference tool in the following functional areas:</para>
     <para>To open the <link linkend="prefs-keyboard-a11y"><application>Keyboard <emphasis>Accessibility</emphasis></application> preference tool</link>, click the <guibutton>Accessibility</guibutton> button.</para>    
     <sect3 id="goscustdesk-40">
       <title>Keyboard Preferences</title>
-      <para>Use the <guilabel>Keyboard</guilabel> tabbed section to set general
-keyboard preferences. To start the <application>Keyboard</application> <emphasis>accessibility</emphasis> preference tool, that is, <application>AccessX</application>,
-click on the <guibutton>Accessibility</guibutton> button.</para>
+      <para>Use the <guilabel>General</guilabel> tabbed section to set general
+keyboard preferences.</para>
       <para><xref linkend="goscustperiph-TBL-3"/> lists the keyboard preferences
 that you can modify.</para>
       <table frame="topbot" id="goscustperiph-TBL-3">
@@ -2000,7 +1568,7 @@ that the action repeats.</para>
                 </para>
               </entry>
               <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
-                <para>Select the speed at which the action is repeated. </para>
+                <para>Select the speed at which the action is repeated.</para>
               </entry>
             </row>
             <row>
@@ -2052,33 +1620,35 @@ test area to test the effect of your settings.</para>
       <variablelist>
 	      <varlistentry>
 	        <term><guilabel>Keyboard model</guilabel></term>
-	        <listitem><para>Use the browse button (labelled with an ellipsis, <guibutton>...</guibutton>) to choose another keyboard make and model.</para></listitem>
+	        <listitem><para>Use the browse button (labelled with the currently selected keyboard model) to choose another keyboard make and model.</para></listitem>
 	      </varlistentry>
 	      <varlistentry>
+	        <term><guilabel>Separate layout for each window</guilabel></term>
+	        <listitem><para>
+	        When this option is selected, each window has its own keyboard layout. Changing to a different layout will only affect the current window.</para>
+	        <para>This allows you to to type with a Russian keyboard layout in a word processor, then switch to your web browser and type with an English keyboard layout, for example. </para></listitem>
+              </varlistentry>
+	      <varlistentry>
 	        <term><guilabel>Selected Layouts</guilabel></term>
 	        <listitem><para>You can switch between selected layouts to change the characters your keyboard produces when you type. To add a layout, click <guibutton>Add</guibutton>. You can have up to four layouts. To remove a layout, select it and press <guibutton>Remove</guibutton>.</para>
 	        <para>To switch between keyboard layouts, use the <ulink type="help" url="ghelp:gswitchit"><application>Keyboard Indicator</application> panel applet</ulink>. <!-- better link to the specific page, but not yet suitable for a direct link: ghelp:gswitchit?gswitchit-applet-switching --></para>
+                 <para>To add a layout to the list of selected layouts, click the <guibutton>Add</guibutton> button. It opens a layout chooser dialog, which lets you select a layout by country or by language.</para> 
 	        </listitem>
 	      </varlistentry>
-	      <varlistentry>
-	        <term><guilabel>Separate group for each window</guilabel></term>
-	        <listitem><para>
-	        When this option is selected, each window has its own keyboard layout. Changing to a different layout will only affect the current window.</para>
-	        <para>This allows you to to type with a Russian keyboard layout in a word processor, then switch to your web browser and type with an English keyboard layout, for example. </para></listitem>
-        </varlistentry>
       </variablelist>
       
       <para>Click <guibutton>Reset to Defaults</guibutton> to restore all keyboard layout settings to their initial state for your system and locale.</para>
-    </sect3>
-    
+
+      <para>Click the <guibutton>Layout Options</guibutton> button to open the <guilabel>Keyboard Layout Options</guilabel> dialog.</para>
+   </sect3>
     
     <sect3 id="prefs-keyboard-layoutoptions"> 
       <title>Keyboard Layout Options</title>
       <!-- preserve id for backwards compatibility: 2.12 -->
       <anchor id="goscustdesk-101"/>
-      <para>The <guilabel>Layout Options</guilabel> tabbed section has options for the behaviour of keyboard modifier keys and certain shortcut options.</para>
+      <para>The <guilabel>Keyboard Layout Options</guilabel> dialog has options for the behaviour of keyboard modifier keys and certain shortcut options.</para>
       <para>Expand each group label to show the available options. A label in boldface indicates that the options in the group have been changed from the default setting.</para>
-      <note><para>The options shown in this tabbed section depend on the X windowing system you are using. Not all the following options might be listed on your system, and not all the options shown might work on your system.</para></note>
+      <note><para>The options shown in this dialog depend on the X windowing system you are using. Not all the following options might be listed on your system, and not all the options shown might work on your system.</para></note>
 
       <!-- the options of mystery!!!       
            for future reference, these are in
@@ -2088,7 +1658,7 @@ test area to test the effect of your settings.</para>
         <varlistentry>
                 <term><guilabel>Adding the EuroSign to certain keys</guilabel></term>
                 <listitem>
-                  <para>Use these options to add the Euro currency symbol to a key as a third-level character. To access this symbol, you must assign a <guilabel>third level chooser</guilabel>.</para>
+                  <para>Use these options to add the Euro currency symbol € to a key as a third-level character. To access this symbol, you must assign a <guilabel>third level chooser</guilabel>.</para>
                 </listitem>
         </varlistentry>
         <varlistentry>
@@ -2158,6 +1728,340 @@ test area to test the effect of your settings.</para>
       </variablelist>
     </sect3>
 
+    <sect3 id="prefs-keyboard-a11y">
+
+    <!-- Maintained for 2.8 compatibility -->
+    <anchor id="goscustaccess-6"/>
+    <indexterm>
+      <primary>AccessX</primary>
+      <see>preference tools, Keyboard Accessibility</see>
+    </indexterm>
+    <indexterm>
+      <primary>keyboard</primary>
+      <secondary>configuring
+accessibility options</secondary>
+    </indexterm>
+    <indexterm>
+      <primary>accessibility</primary>
+      <secondary>configuring keyboard</secondary>
+    </indexterm>
+    <indexterm>
+      <primary>preference tools</primary>
+      <secondary>Keyboard Accessibility</secondary>
+    </indexterm>
+
+      <title>Keyboard Accessibility Preferences</title>
+      <anchor id="goscustaccess-8"/>
+      <anchor id="goscustaccess-9"/>
+      <para>The <guilabel>Accessibility</guilabel> tabbed section allows you to set  options such as filtering out accidental keypresses and using shortcut keys without having to hold down several keys at once. These features are also known as AccessX.</para>
+
+       <para>This section describes each of the preferences you can set. For a more task-oriented description of keyboard accessibility, see the <ulink type="help" url="ghelp:gnome-access-guide?index"><citetitle>GNOME Desktop Accessibility Guide</citetitle></ulink>.</para>
+
+      <para><xref linkend="goscustdesk-TBL-85"/> lists the accessibility preferences
+ that you can modify.</para>
+     <table frame="topbot" id="goscustdesk-TBL-85">
+        <title>Accessibility Preferences</title>
+        <tgroup cols="2" colsep="0" rowsep="0">
+          <colspec colwidth="50*"/>
+          <colspec colwidth="50*"/>
+          <thead>
+            <row rowsep="1">
+              <entry>
+                <para>Dialog Element</para>
+              </entry>
+              <entry>
+                <para>Description</para>
+              </entry>
+            </row>
+          </thead>
+          <tbody>
+             <row>
+                <entry valign="top">
+                  <para>
+                    <guilabel>Accessibility features can be toggled with keyboard shortcuts</guilabel>
+                  </para>
+                </entry>
+                <entry valign="top">
+                   <para>
+                     Select this option to show an icon in the notification 
+                     area that offers quick access to accessibility features.
+                   </para>
+                </entry>
+             </row>
+             <row>
+                <entry valign="top">
+                  <para>
+                    <guilabel>Simulate simultaneous keypresses</guilabel>
+                  </para>
+                  <indexterm>
+                    <primary>accessibility</primary>
+                    <secondary>sticky keys</secondary>
+                  </indexterm>
+                </entry>
+                <entry valign="top">
+                <para>Select this option to perform multiple simultaneous keypress operations by
+pressing the keys in sequence. Alternatively, to enable the sticky keys feature,
+press <keycap>Shift</keycap> five times.</para>
+                </entry>
+             </row>
+             <row>
+                <entry valign="top">
+                    <para>
+                      <guilabel>Disable sticky keys if two keys are pressed together</guilabel>
+                    </para>
+                </entry>
+                <entry valign="top">
+                    <para>Select this option to specify that when you press two keys simultaneously,
+you can no longer press keys in sequence to perform multiple simultaneous
+keypresses.</para>
+                </entry>
+             </row>
+             <row>
+                <entry valign="top">
+                  <para>
+                    <guilabel>Only accept long keypresses</guilabel>
+                  </para>
+                  <indexterm>
+                    <primary>accessibility</primary>
+                    <secondary>slow keys</secondary>
+                  </indexterm>
+                </entry>
+                <entry valign="top">
+                <para>Select this option to control the period of time that you must press-and-hold
+a key before acceptance. Alternatively, to enable the slow keys feature, press-and-hold <keycap>Shift</keycap> for eight seconds.</para>
+                </entry>
+             </row>
+             <row>
+                <entry valign="top">
+                  <para>
+                    <guilabel>Delay</guilabel>
+                  </para>
+                </entry>
+                <entry valign="top">
+                  <para>Use the slider
+to specify the period of time that you must press-and-hold
+a key before acceptance.</para>
+                </entry>
+             </row>
+             <row>
+                <entry valign="top">
+                  <para>
+                    <guilabel>Ignore fast duplicate keypresses</guilabel>
+                  </para>
+                  <indexterm>
+                    <primary>accessibility</primary>
+                    <secondary>bounce keys</secondary>
+                  </indexterm>
+                </entry>
+                <entry valign="top">
+                <para>Select this option to accept a key input and to control the key repeat characteristics
+of the keyboard.</para>
+                </entry>
+             </row>
+             <row>
+                <entry valign="top">
+                  <para>
+                    <guilabel>Delay</guilabel>
+                  </para>
+                </entry>
+                <entry valign="top">
+                   <para>Use the slider to specify the interval to wait after the first
+keypress before the automatic repeat of a pressed key.</para>
+                </entry>
+             </row>
+            <row>
+              <entry  valign="top">
+                <para>
+                  <guilabel>Type to test settings</guilabel>
+                </para>
+              </entry>
+              <entry valign="top">
+                <para>The
+test area is an interactive interface so you can see how the keyboard settings
+affect the display as you type. Type text in the test area to test the effect
+of your settings.</para>
+              </entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </table>
+      <para>To configure audio feedback for keyboard accessibility features,
+      click the <guibutton>Audio Feedback</guibutton> button. It opens the
+      <guilabel>Keyboard Accessibility Audio Feedback</guilabel> window.</para>
+    </sect3>
+
+   <sect3>
+      <title>Keyboard Accessibility Audio Feedback</title>
+      <para>Configure audio feedback for keyboard accessibility features.</para>
+      <para><xref linkend="goscustdesk-TBL-86"/> lists the audio feedback preferences
+      that you can modify.</para>
+      <table frame="topbot" id="goscustdesk-TBL-86">
+        <title>Audio Feedback Preferences</title>
+        <tgroup cols="2" colsep="0" rowsep="0">
+          <colspec colwidth="50*"/>
+          <colspec colwidth="50*"/>
+          <thead>
+            <row rowsep="1">
+              <entry>
+                <para>Dialog Element</para>
+              </entry>
+              <entry>
+                <para>Description</para>
+              </entry>
+            </row>
+          </thead>
+          <tbody>
+            <row>
+              <entry valign="top">
+                <para>
+                  <guilabel>Beep when accessibility features are turned on or off</guilabel>
+                </para>
+              </entry>
+              <entry valign="top">
+                <para>Select this option for an audible indication when a feature
+                such as sticky keys or slow keys is activated, or deactivated.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top">
+                 <para>
+                   <guilabel>Beep when a toggle key is pressed</guilabel>
+                 </para>
+                 <indexterm>
+                    <primary>accessibility</primary>
+                    <secondary>toggle keys</secondary>
+                  </indexterm>
+              </entry>
+	      <entry valign="top">
+                 <para>Select this option for an audible indication of a toggle keypress. 
+                 You hear one beep when a toggle key is turned on. You hear two
+                  beeps when a toggle key is turned off.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top">
+                 <para>
+                   <guilabel>Beep when a modifier key is pressed</guilabel>
+                 </para>
+              </entry>
+              <entry valign="top">
+                 <para>Select this option for an audible indication when you 
+                 press a modifier key.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top">
+                 <para>
+                   <guilabel>Beep when a key is pressed</guilabel>
+                 </para>
+              </entry>
+              <entry valign="top">
+                 <para>Select this option for an audible indication when  
+                 a key is pressed.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top">
+                 <para>
+                   <guilabel>Beep when a key is accepted</guilabel>
+                 </para>
+              </entry>
+              <entry valign="top">
+                 <para>Select this option for an audible indication when  
+                 a key is accepted.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top">
+                 <para>
+                   <guilabel>Beep when a key is rejected</guilabel>
+                 </para>
+              </entry>
+              <entry valign="top">
+                 <para>Select this option for an audible indication when  
+                 a key is rejected.</para>
+              </entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </table>
+   </sect3>
+ 
+   <sect3>
+     <title>Mouse Keys Preferences</title>
+     <anchor id="goscustaccess-10"/>
+     <para>The options in the <guilabel>Mouse Keys</guilabel> tabbed section
+     let you configure the keyboard as a substitute for the mouse.</para>
+      <para><xref linkend="goscustdesk-TBL-88"/> lists the mouse keys preferences
+ that you can modify.</para>
+      <table frame="topbot" id="goscustdesk-TBL-88">
+        <title>Typing Break Preferences</title>
+        <tgroup cols="2" colsep="0" rowsep="0">
+          <colspec colwidth="50*"/>
+          <colspec colwidth="50*"/>
+          <thead>
+            <row rowsep="1">
+              <entry>
+                <para>Dialog Element</para>
+              </entry>
+              <entry>
+                <para>Description</para>
+              </entry>
+            </row>
+          </thead>
+          <tbody>
+            <row>
+              <entry valign="top">
+                <para>
+                  <guilabel>Pointer can be controlled using the keypad</guilabel>
+                </para>
+                <indexterm>
+                  <primary>accessibility</primary>
+                  <secondary>mouse keys</secondary>
+                </indexterm>
+              </entry>
+              <entry valign="top">
+               <para>Select this option to make the numeric keypad emulate mouse actions. The list of keys and their equivalences is in the <citetitle>GNOME Desktop Accessibility Guide</citetitle> under the heading <ulink type="help" url="ghelp:gnome-access-guide?dtconfig-14"><citetitle>To Enable the Keyboard to Emulate the Mouse</citetitle></ulink>.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top">
+                <para>
+                   <guilabel>Acceleration</guilabel> 
+                </para>
+              </entry>
+              <entry valign="top">
+                <para>Use the slider to specify how long it takes the pointer to accelerate to maximum speed.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top">
+                <para>
+                   <guilabel>Speed</guilabel>
+                </para>
+              </entry>
+              <entry valign="top">
+                <para>Use the slider
+to specify the maximum speed that the pointer moves across
+the screen.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top">
+                <para>
+                  <guilabel>Delay</guilabel>
+                </para>
+              </entry>
+              <entry valign="top">
+                <para>Use the slider to specify the period of time that must pass
+after a keypress before the pointer moves.</para>
+              </entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </table>
+  </sect3>
+
     <sect3 id="goscustdesk-86">
       <title>Typing Break Preferences</title>
       <para>Configure the Typing Break Preferences to make GNOME remind you to rest after you have been using the keyboard and mouse for a long time. During a Typing Break, the screen will be locked.</para>
diff --git a/gnome2-user-guide/ChangeLog b/gnome2-user-guide/ChangeLog
index fcbe3a8..9533572 100644
--- a/gnome2-user-guide/ChangeLog
+++ b/gnome2-user-guide/ChangeLog
@@ -1,6 +1,11 @@
 2009-02-21  Shaun McCance  <shaunm@gnome.org>
 
 	* C/goscustdesk.xml:
+	- Update Keyboard capplet documentation, from mclasen, bug #571030
+
+2009-02-21  Shaun McCance  <shaunm@gnome.org>
+
+	* C/goscustdesk.xml:
 	- Updates to appearance capplet docs, patch from mclasen plus id-compatiblity fixes, #571140
 
 2009-02-21  Mario Blättermann <mariobl@svn.gnome.org>