[gnome-user-docs] g-h/a11y-*keys: Make a11y settings primary, menu a tip. Final

[Shaun McCance <shaunm src gnome org>]

commit d3c15ffaad245aace381f4b6b3245811a484e3a7
Author: Shaun McCance <shaunm gnome org>
Date:   Mon Apr 4 18:06:24 2011 -0400

    g-h/a11y-*keys: Make a11y settings primary, menu a tip. Final

 gnome-help/C/a11y-bouncekeys.page |   24 +++++++++++++++++-----
 gnome-help/C/a11y-slowkeys.page   |   36 ++++++++++++++++++++++------------
 gnome-help/C/a11y-stickykeys.page |   38 ++++++++++++++++++++++++------------
 3 files changed, 66 insertions(+), 32 deletions(-)
---
diff --git a/gnome-help/C/a11y-bouncekeys.page b/gnome-help/C/a11y-bouncekeys.page
index 5c0e97f..41fd8f4 100644
--- a/gnome-help/C/a11y-bouncekeys.page
+++ b/gnome-help/C/a11y-bouncekeys.page
@@ -5,7 +5,7 @@
     <link type="guide" xref="a11y#mobility" group="keyboard"/>
     <link type="guide" xref="keyboard"/>
 
-    <revision pkgversion="3.0" date="2011-04-03" status="candidate"/>
+    <revision pkgversion="3.0" date="2011-04-04" status="final"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
@@ -22,14 +22,26 @@
 
 <title>Turn on Bounce Keys</title>
 
-<p>Turn-on <em>bounce keys</em> to ignore keypresses that are rapidly repeated. For example, if you have hand tremors which cause you to press a key multiple times when you only want to press it once, you should turn on bounce keys.</p>
+<comment>
+  <cite date="2011-04-04">shaunm</cite>
+  <p>Turn on from the keyboard?! How do I turn these features on from
+  the keyboard then? Used to be there were odd shortcuts. I think
+  5x Shift turned one of them on. Fix for 3.2</p>
+</comment>
 
-<p>To do this, click the <link xref="a11y-icon">universal access icon on the top bar</link> (it looks like a little man) and switch <gui>Bounce Keys</gui> to <gui>ON</gui>.</p>
+<p>Turn on <em>bounce keys</em> to ignore keypresses that are rapidly repeated. For example, if you have hand tremors which cause you to press a key multiple times when you only want to press it once, you should turn on bounce keys.</p>
 
-<!-- Is there a keyboard shortcut to do this? -->
+<steps>
+  <item><p>Click your name on the top bar and select <gui>System Settings</gui>.</p></item>
+  <item><p>Click <gui>Universal Access</gui>.</p></item>
+  <item><p>Select the <gui>Typing</gui> tab.</p></item>
+  <item><p>Select <gui>Turn on accessibility features from the keyboard</gui>.</p></item>
+  <item><p>Switch <gui>Bounce Keys</gui> on.</p></item>
+</steps>
 
-<p>You can change how long bounce keys waits before it registers another key press after you pressed the key for the first time. Click your name on the top panel and click <gui>System Settings</gui>. Then, open <gui>Universal Access</gui> and go to the <gui>Typing</gui> tab. Change the <gui>acceptance delay</gui> to change how long bounce keys waits for key presses.</p>
+<note style="tip"><p>You can quickly turn this feature on and off
+from the <link xref="a11y-icon">universal access menu</link>.</p></note>
 
-<p>On the same screen, you can also check <gui>Beep when a key is rejected</gui> if you want the computer to make a sound each time it ignores a key press because it happened too soon after the previous key press.</p>
+<p>Use the <gui>Acceptance delay</gui> slider to change how long bounce keys waits before it registers another key press after you pressed the key for the first time. Select <gui>Beep when a key is rejected</gui> if you want the computer to make a sound each time it ignores a key press because it happened too soon after the previous key press.</p>
 
 </page>
diff --git a/gnome-help/C/a11y-slowkeys.page b/gnome-help/C/a11y-slowkeys.page
index 8ec111c..67bbce8 100644
--- a/gnome-help/C/a11y-slowkeys.page
+++ b/gnome-help/C/a11y-slowkeys.page
@@ -5,7 +5,7 @@
     <link type="guide" xref="a11y#mobility" group="keyboard"/>
     <link type="guide" xref="keyboard"/>
 
-    <revision pkgversion="3.0" date="2011-04-03" status="candidate"/>
+    <revision pkgversion="3.0" date="2011-04-04" status="final"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
@@ -22,21 +22,31 @@
 
 <title>Turn on Slow Keys</title>
 
+<comment>
+  <cite date="2011-04-04">shaunm</cite>
+  <p>Turn on from the keyboard?! How do I turn these features on from
+  the keyboard then? Used to be there were odd shortcuts. I think
+  5x Shift turned one of them on. Fix for 3.2</p>
+</comment>
+
 <p>Turn on <em>slow keys</em> if you would like there to be a delay between pressing a key and that letter being displayed on the screen. This means that you have to hold down each key you want to type for a little while before it appears. Use slow keys if you accidentally press several keys at a time when you type, or if you find it difficult to press the right key on the keyboard first time.</p>
 
-<p>To turn on slow keys, click the <link xref="a11y-icon">universal access icon</link> on the top bar and switch <gui>Slow keys</gui> to <gui>ON</gui>.</p>
+<steps>
+  <item><p>Click your name on the top bar and select <gui>System Settings</gui>.</p></item>
+  <item><p>Click <gui>Universal Access</gui>.</p></item>
+  <item><p>Select the <gui>Typing</gui> tab.</p></item>
+  <item><p>Select <gui>Turn on accessibility features from the keyboard</gui>.</p></item>
+  <item><p>Switch <gui>Slow Keys</gui> on.</p></item>
+</steps>
+
+<note style="tip"><p>You can quickly turn this feature on and off
+from the <link xref="a11y-icon">universal access menu</link>.</p></note>
 
-<section id="delay">
- <title>Change the key-press delay</title>
- <p>You can change the length of the delay between the key being pressed and the letter appearing on screen.</p>
- <p>Click your name on the top bar and choose <gui>System Settings</gui>, then open Universal Access. Look for the <gui>Slow Keys</gui> options under the <gui>Typing</gui> tab and change the <gui>acceptance delay</gui>.</p>
-</section>
+<p>Use the <gui>Acceptance delay</gui> slider to control how long you have to
+hold a key down for it to register.</p>
 
-<section id="beep">
- <title>Make a sound to tell when the key is pressed/accepted</title>
- <p>The computer can make a "beep" sound if your key press is accepted or rejected, so that you can keep track of whether the letter you pressed was typed on the screen or not.</p>
- <p>To enable these sounds, click your name on the top bar and choose <gui>System Settings</gui>, then open Universal Access. Look for the <gui>Slow Keys</gui> options under the <gui>Typing</gui> tab and check the appropriate boxes.</p>
- <p>Check <gui>pressed</gui> if you want it to beep when you first press a key; <gui>accepted</gui> if you want it to beep only when you've held-down the key long enough for it to appear on the screen; and <gui>rejected</gui> to beep if you didn't hold down a key for long enough for it to appear on the screen.</p>
-</section>
+<p>You can have your computer make a sound when you press a key, when a key
+press is accepted, or when a key press is rejected because you didn't hold
+the key down long enough.</p>
 
 </page>
diff --git a/gnome-help/C/a11y-stickykeys.page b/gnome-help/C/a11y-stickykeys.page
index 77e8210..847ad2a 100644
--- a/gnome-help/C/a11y-stickykeys.page
+++ b/gnome-help/C/a11y-stickykeys.page
@@ -5,7 +5,7 @@
     <link type="guide" xref="a11y#mobility" group="keyboard"/>
     <link type="guide" xref="keyboard"/>
 
-    <revision pkgversion="3.0" date="2011-04-03" status="candidate"/>
+    <revision pkgversion="3.0" date="2011-04-04" status="final"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
@@ -22,21 +22,33 @@
 
 <title>Turn on Sticky Keys</title>
 
+<comment>
+  <cite date="2011-04-04">shaunm</cite>
+  <p>Turn on from the keyboard?! How do I turn these features on from
+  the keyboard then? Used to be there were odd shortcuts. I think
+  5x Shift turned one of them on. Fix for 3.2</p>
+</comment>
+
 <p><em>Sticky Keys</em> allows you to type keyboard shortcuts one key at a time rather than having to hold down all of the keys at once. For example, the <keyseq><key>Alt</key><key>Tab</key></keyseq> shortcut switches between windows. Without sticky keys turned on, you would have to hold down both keys at the same time; with sticky keys turned on, you would press <key>Alt</key> and then <key>Tab</key> to do the same.</p>
 
-<p>You might want to turn on sticky keys if you find it difficult to hold down several keys at once. To do this, click the <link xref="a11y-icon">universal access icon</link> on the top bar and switch <gui>Sticky Keys</gui> to <gui>ON</gui>.</p>
+<p>You might want to turn on sticky keys if you find it difficult to hold down several keys at once.</p>
+
+<steps>
+  <item><p>Click your name on the top bar and select <gui>System Settings</gui>.</p></item>
+  <item><p>Click <gui>Universal Access</gui>.</p></item>
+  <item><p>Select the <gui>Typing</gui> tab.</p></item>
+  <item><p>Select <gui>Turn on accessibility features from the keyboard</gui>.</p></item>
+  <item><p>Switch <gui>Sticky Keys</gui> on.</p></item>
+</steps>
+
+<note style="tip"><p>You can quickly turn this feature on and off
+from the <link xref="a11y-icon">universal access menu</link>.</p></note>
+
 
-<section id="ignore">
- <title>Don't use sticky keys if two buttons are pressed at once</title>
- <p>If you press two keys at once, you can have sticky keys turn itself off temporarily to let you enter a keyboard shortcut in the "standard" way.</p>
- <p>For example, if you have sticky keys turned on but press <key>Alt</key> and <key>Tab</key> simultaneously, sticky keys would not wait for you to press another key if you had this option turned on. It <em>would</em> wait if you only pressed one key, however. This is useful if you are able to press some keyboard shortcuts simultaneously (for example, keys that are close together), but not others.</p>
- <p>To enable this feature, click your name on the top panel, click <gui>System Settings</gui>, and open <gui>Universal Access</gui>. Then, go to the <gui>Typing</gui> tab and check <gui>Disable if two keys are pressed together</gui>.</p>
-</section>
+<p>If you press two keys at once, you can have sticky keys turn itself off temporarily to let you enter a keyboard shortcut in the "standard" way.</p>
+<p>For example, if you have sticky keys turned on but press <key>Alt</key> and <key>Tab</key> simultaneously, sticky keys would not wait for you to press another key if you had this option turned on. It <em>would</em> wait if you only pressed one key, however. This is useful if you are able to press some keyboard shortcuts simultaneously (for example, keys that are close together), but not others.</p>
+<p>Select <gui>Disable if two keys are pressed together</gui> to enable this.</p>
 
-<section id="beep">
- <title>Make a sound when you start typing a keyboard shortcut</title>
- <p>You can have the computer make a "beep" sound when you start typing a keyboard shortcut with sticky keys turned on. This is useful if you want to know that sticky keys is expecting a keyboard shortcut to be typed, so the next key press will be interpreted as part of a shortcut.</p>
- <p>To turn this on, click your name on the top panel, click <gui>System Settings</gui>, and open <gui>Universal Access</gui>. Then, go to the <gui>Typing</gui> tab and check <gui>Beep when a modifier key is pressed</gui>.</p>
-</section>
+<p>You can have the computer make a "beep" sound when you start typing a keyboard shortcut with sticky keys turned on. This is useful if you want to know that sticky keys is expecting a keyboard shortcut to be typed, so the next key press will be interpreted as part of a shortcut. Select <gui>Beep when a modifier key is pressed</gui> to enable this.</p>
 
 </page>