GNOME.org
 

[gnome-user-docs] Lots of work on keyboard, esp keyboard a11y

commit 21c7c9477fc5fb671a37292923b0520f2c60adf8
Author: Shaun McCance <shaunm gnome org>
Date:   Fri Sep 23 18:18:55 2011 -0400

    Lots of work on keyboard, esp keyboard a11y

 gnome-help/C/a11y-bouncekeys.page                |   27 ++++++++------------
 gnome-help/C/a11y-slowkeys.page                  |   28 ++++++++++-----------
 gnome-help/C/a11y-stickykeys.page                |   29 ++++++++++------------
 gnome-help/C/figures/input-keyboard-symbolic.png |  Bin 0 -> 326 bytes
 gnome-help/C/figures/system-run.png              |  Bin 676 -> 0 bytes
 gnome-help/C/keyboard-cursor-blink.page          |    9 ++++--
 gnome-help/C/keyboard-layouts.page               |    4 +-
 gnome-help/C/keyboard-nav.page.stub              |    4 ++-
 gnome-help/C/keyboard-osk.page                   |   20 +++++++++++++++
 gnome-help/C/keyboard-repeat-keys.page           |   10 ++++---
 gnome-help/C/keyboard.page                       |   12 +++++++++
 gnome-help/C/mouse-mousekeys.page                |   11 ++++----
 gnome-help/C/shell-keyboard-shortcuts.page       |    8 ++++--
 gnome-help/C/tips-specialchars.page              |    1 -
 gnome-help/Makefile.am                           |    3 +-
 15 files changed, 98 insertions(+), 68 deletions(-)
---
diff --git a/gnome-help/C/a11y-bouncekeys.page b/gnome-help/C/a11y-bouncekeys.page
index 6a41510..f06ad11 100644
--- a/gnome-help/C/a11y-bouncekeys.page
+++ b/gnome-help/C/a11y-bouncekeys.page
@@ -3,8 +3,9 @@
       id="a11y-bouncekeys">
   <info>
     <link type="guide" xref="a11y#mobility" group="keyboard"/>
-    <link type="guide" xref="keyboard"/>
+    <link type="guide" xref="keyboard" group="a11y"/>
 
+    <revision pkgversion="3.2" date="2011-09-23" status="final"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
@@ -20,29 +21,23 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Turn on Bounce Keys</title>
+<title>Turn on bounce 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>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>
+<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>
 
 <steps>
   <item><p>Click your name on the top bar and select <gui>System Settings</gui>.</p></item>
   <item><p>Open <gui>Universal Access</gui> and 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>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>
+<note style="tip">
+<title>Quickly turn bounce keys on and off</title>
+<p>You can turn bounce keys on and off by clicking the
+<link xref="a11y-icon">accessibility icon</link> on the top bar and selecting
+<gui>Bounce Keys</gui>.</p>
+</note>
 
- <note style = "tip">
- <p>You can quickly turn Bounce Keys on and off by clicking the <link xref="a11y-icon">accessibility
- icon</link> on the top bar and selecting <gui>Bounce Keys</gui>.</p>
- </note>
+<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 7b9c68c..25826c9 100644
--- a/gnome-help/C/a11y-slowkeys.page
+++ b/gnome-help/C/a11y-slowkeys.page
@@ -3,8 +3,9 @@
       id="a11y-slowkeys">
   <info>
     <link type="guide" xref="a11y#mobility" group="keyboard"/>
-    <link type="guide" xref="keyboard"/>
+    <link type="guide" xref="keyboard" group="a11y"/>
 
+    <revision pkgversion="3.2" date="2011-09-23" status="final"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
@@ -20,28 +21,25 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Turn on Slow Keys</title>
+<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>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>
 
 <steps>
   <item><p>Click your name on the top bar and select <gui>System Settings</gui>.</p></item>
   <item><p>Open <gui>Universal Access</gui> and 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 Slow Keys on and off by clicking the <link xref="a11y-icon">accessibility
- icon</link> on the top bar and selecting <gui>Slow Keys</gui>.</p>
- </note>
+<note style="tip">
+<title>Quickly turn slow keys on and off</title>
+<p>Select <gui>Turn on accessibility features from the keyboard</gui> to turn Sticky
+Keys on and off from the keyboard. When this option is selected, you can press and
+hold <key>Shift</key> for eight seconds to enable or disable slow keys.</p>
+<p>You can also turn slow keys on and off by clicking the
+<link xref="a11y-icon">accessibility icon</link> on the top bar and selecting
+<gui>Slow Keys</gui>.</p>
+</note>
 
 <p>Use the <gui>Acceptance delay</gui> slider to control how long you have to
 hold a key down for it to register.</p>
diff --git a/gnome-help/C/a11y-stickykeys.page b/gnome-help/C/a11y-stickykeys.page
index bc0c6a5..2004639 100644
--- a/gnome-help/C/a11y-stickykeys.page
+++ b/gnome-help/C/a11y-stickykeys.page
@@ -3,8 +3,9 @@
       id="a11y-stickykeys">
   <info>
     <link type="guide" xref="a11y#mobility" group="keyboard"/>
-    <link type="guide" xref="keyboard"/>
+    <link type="guide" xref="keyboard" group="a11y"/>
 
+    <revision pkgversion="3.2" date="2011-09-23" status="final"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
@@ -20,31 +21,27 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Turn on Sticky Keys</title>
+<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><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.</p>
 
 <steps>
   <item><p>Click your name on the top bar and select <gui>System Settings</gui>.</p></item>
   <item><p>Open <gui>Universal Access</gui> and 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 Sticky Keys on and off by clicking the <link xref="a11y-icon">accessibility
- icon</link> on the top bar and selecting <gui>Sticky Keys</gui>.</p>
- </note>
-
+<note style="tip">
+<title>Quickly turn sticky keys on and off</title>
+<p>Select <gui>Turn on accessibility features from the keyboard</gui> to turn Sticky
+Keys on and off from the keyboard. When this option is selected, you can press
+<key>Shift</key> five times in a row to enable or disable sticky keys.</p>
+<p>You can also turn sticky keys on and off by clicking the
+<link xref="a11y-icon">accessibility icon</link> on the top bar and selecting
+<gui>Sticky Keys</gui>.</p>
+</note>
 
 <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>
diff --git a/gnome-help/C/figures/input-keyboard-symbolic.png b/gnome-help/C/figures/input-keyboard-symbolic.png
new file mode 100644
index 0000000..7f93c62
Binary files /dev/null and b/gnome-help/C/figures/input-keyboard-symbolic.png differ
diff --git a/gnome-help/C/keyboard-cursor-blink.page b/gnome-help/C/keyboard-cursor-blink.page
index ff90785..4cfa8da 100644
--- a/gnome-help/C/keyboard-cursor-blink.page
+++ b/gnome-help/C/keyboard-cursor-blink.page
@@ -4,6 +4,9 @@
   <info>
     <link type="guide" xref="a11y#vision" group="lowvision"/>
     <link type="guide" xref="keyboard"/>
+
+    <revision pkgversion="3.2" date="2011-09-23" status="final"/>
+
     <desc>Make the insertion point blink and control how quickly it blinks.</desc>
 
     <credit type="author">
@@ -19,12 +22,12 @@
 
   <title>Make the keyboard cursor blink</title>
 
-  <p>It is possible to lose the keyboard cursor in a text field. Setting it to blink may make it easier to locate on the screen.
-  To make the cursor blink and to adjust the speed of it:</p>
+  <p>If you find it difficult to see the keyboard cursor in a text field, you
+  can make it blink to make it easier to locate.</p>
 
   <steps>
     <item><p>Click your name on the top bar and select <gui>System Settings</gui>.</p></item>
-    <item><p>Open <gui>Keyboard</gui>.</p></item>
+    <item><p>Open <gui>Keyboard</gui> and select the <gui>Typing</gui> tab.</p></item>
     <item><p>Select <gui>Cursor blinks in text fields</gui>.</p></item>
     <item><p>Use the <gui>Speed</gui> slider to adjust how quickly the cursor blinks.</p></item>
   </steps>
diff --git a/gnome-help/C/keyboard-layouts.page b/gnome-help/C/keyboard-layouts.page
index a70bfc8..b61a898 100644
--- a/gnome-help/C/keyboard-layouts.page
+++ b/gnome-help/C/keyboard-layouts.page
@@ -3,7 +3,7 @@
       id="keyboard-layouts">
   <info>
     <link type="guide" xref="prefs-language"/>
-    <link type="guide" xref="keyboard"/>
+    <link type="guide" xref="keyboard" group="i18n"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
@@ -32,7 +32,7 @@
 
   <note style="sidebar">
     <p>You can preview an image of any layout by selecting it in the list and clicking
-    <gui><media type="image" src="figures/system-run.png" width="16" height="16">preview</media></gui>,
+    <gui><media type="image" src="figures/input-keyboard-symbolic.png" width="16" height="16">preview</media></gui>,
     or by clicking <gui>Preview</gui> in the pop-up window when adding a layout.</p>
   </note>
 
diff --git a/gnome-help/C/keyboard-nav.page.stub b/gnome-help/C/keyboard-nav.page.stub
index 76255f1..d997c81 100644
--- a/gnome-help/C/keyboard-nav.page.stub
+++ b/gnome-help/C/keyboard-nav.page.stub
@@ -3,7 +3,9 @@
       id="keyboard-nav">
   <info>
     <link type="guide" xref="tips"/>
-    <link type="guide" xref="a11y#mobility"/>
+    <link type="guide" xref="keyboard" group="a11y"/>
+    <link type="guide" xref="a11y#mobility" group="keyboard"/>
+    <link type="seealso" xref="shell-keyboard-shortcuts"/>
 
     <revision pkgversion="3.0" version="3.0.1" date="2011-04-07" status="stub"/>
 
diff --git a/gnome-help/C/keyboard-osk.page b/gnome-help/C/keyboard-osk.page
new file mode 100644
index 0000000..729ab10
--- /dev/null
+++ b/gnome-help/C/keyboard-osk.page
@@ -0,0 +1,20 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="keyboard-osk">
+  <info>
+    <link type="guide" xref="keyboard" group="a11y"/>
+    <link type="guide" xref="a11y#mobility" group="keyboard"/>
+
+    <revision pkgversion="3.2" date="2011-09-23" status="stub"/>
+
+    <credit type="author">
+      <name>...</name>
+      <email>...</email>
+    </credit>
+
+    <desc>Use an on-screen keyboard to enter text with your mouse.</desc>
+  </info>
+
+  <title>Use a screen keyboard</title>
+
+</page>
diff --git a/gnome-help/C/keyboard-repeat-keys.page b/gnome-help/C/keyboard-repeat-keys.page
index 3052663..fdd34be 100644
--- a/gnome-help/C/keyboard-repeat-keys.page
+++ b/gnome-help/C/keyboard-repeat-keys.page
@@ -3,7 +3,9 @@
       id="keyboard-repeat-keys">
   <info>
     <link type="guide" xref="a11y#mobility" group="keyboard"/>
-    <link type="guide" xref="keyboard"/> 	
+    <link type="guide" xref="keyboard"/>
+
+    <revision pkgversion="3.2" date="2011-09-23" status="final"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
@@ -28,9 +30,9 @@
 
   <steps>
     <item><p>Click your name on the top bar and select <gui>System Settings</gui>.</p></item>
-    <item><p>Open <gui>Keyboard</gui>.</p></item>
-    <item><p>On the <gui>General</gui> tab, turn off <gui>Key presses repeat
-    when key is held down</gui> to disable repeated keys entirely. Alternatively,
+    <item><p>Open <gui>Keyboard</gui> and select the <gui>Typing</gui> tab.</p></item>
+    <item><p>Turn off <gui>Key presses repeat when key is held down</gui> to disable
+    repeated keys entirely. Alternatively,
     adjust the <gui>Delay</gui> slider to control how long you have to hold a key
     down to begin repeating it, and adjust the <gui>Speed</gui> slider to control
     how quickly key presses repeat.</p></item>
diff --git a/gnome-help/C/keyboard.page b/gnome-help/C/keyboard.page
index 5882dda..5f089b2 100644
--- a/gnome-help/C/keyboard.page
+++ b/gnome-help/C/keyboard.page
@@ -22,4 +22,16 @@
 
 <title>Keyboard</title>
 
+<links type="topic" groups="i18n" style="linklist">
+  <title>Language &amp; region</title>
+</links>
+
+<links type="topic" groups="a11y" style="linklist">
+  <title>Universal access</title>
+</links>
+
+<links type="topic" groups="#first #default #last" style="linklist">
+  <title>Other topics</title>
+</links>
+
 </page>
diff --git a/gnome-help/C/mouse-mousekeys.page b/gnome-help/C/mouse-mousekeys.page
index fe5a730..163790c 100644
--- a/gnome-help/C/mouse-mousekeys.page
+++ b/gnome-help/C/mouse-mousekeys.page
@@ -8,8 +8,7 @@
 
     <revision pkgversion="3.2" date="2011-09-19" status="final"/>
     
-    <desc>How to enable <gui>Mouse Keys</gui> to click and move mouse
-    pointer with keypad.</desc>
+    <desc>Enable mouse keys to control the mouse with the keypad.</desc>
     
     <credit type="author">
       <name>Phil Bull</name>
@@ -22,11 +21,11 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 </info>
 
-<title>Click and move mouse pointer using keypad</title>
+<title>Click and move mouse pointer using the keypad</title>
 
 <p>If you have difficulties using a mouse or other pointing device, you can
 control the mouse pointer using the numeric keypad on your keyboard. This
-feature is called <em>Mouse Keys</em>.</p>
+feature is called <em>mouse keys</em>.</p>
 
 <steps>
   <item><p>Click your name on the top bar and select <gui>System Settings</gui>.</p></item>
@@ -41,7 +40,7 @@ feature is called <em>Mouse Keys</em>.</p>
 </steps>
 
  <note style = "tip">
- <p>You can quickly turn Mouse Keys on and off by clicking the <link xref="a11y-icon">accessibility
+ <p>You can quickly turn mouse keys on and off by clicking the <link xref="a11y-icon">accessibility
  icon</link> on the top bar and selecting <gui>Mouse Keys</gui>.</p>
  </note>
 
@@ -69,7 +68,7 @@ right-click by holding down <key>5</key> or the left mouse button.
 </p>
 
 <p>
-If you want to use the keypad to type numbers while Mouse Keys is enabled, turn 
+If you want to use the keypad to type numbers while mouse keys is enabled, turn 
 <key>Num Lock</key> on. The mouse cannot be controlled with the keypad when 
 <key>Num Lock</key> is turned on, though.
 </p>
diff --git a/gnome-help/C/shell-keyboard-shortcuts.page b/gnome-help/C/shell-keyboard-shortcuts.page
index 71f496d..b24434a 100644
--- a/gnome-help/C/shell-keyboard-shortcuts.page
+++ b/gnome-help/C/shell-keyboard-shortcuts.page
@@ -1,9 +1,11 @@
 <page xmlns="http://projectmallard.org/1.0/";
+      xmlns:ui="http://projectmallard.org/experimental/ui/";
       type="topic" style="tip"
       id="shell-keyboard-shortcuts">
 
   <info>
     <link type="guide" xref="tips"/>
+    <link type="guide" xref="keyboard"/>
     <link type="guide" xref="shell-overview"/>
     
     <desc>Getting around the desktop using the keyboard.</desc>
@@ -18,7 +20,7 @@
 
 <title>Useful keyboard shortcuts</title>
 
-<table rules="rows" frame="top bottom">
+<table rules="rows" frame="top bottom" ui:expanded="no">
 <title>Getting around the desktop</title>
   <tr>
     <td><p><keyseq><key>Alt</key><key>F1</key></keyseq> or
@@ -65,7 +67,7 @@
   </tr>
 </table>
 
-<table rules="rows" frame="top bottom">
+<table rules="rows" frame="top bottom" ui:expanded="no">
 <title>Common editing shortcuts</title>
   <tr>
     <td><p><keyseq><key>Ctrl</key><key>A</key></keyseq></p></td>
@@ -89,7 +91,7 @@
   </tr>
 </table>
 
-<table rules="rows" frame="top bottom">
+<table rules="rows" frame="top bottom" ui:expanded="no">
 <title>Capturing from the screen</title>
   <tr>
     <td><p><key>Print</key></p></td>
diff --git a/gnome-help/C/tips-specialchars.page b/gnome-help/C/tips-specialchars.page
index a518b5f..3fdcf89 100644
--- a/gnome-help/C/tips-specialchars.page
+++ b/gnome-help/C/tips-specialchars.page
@@ -5,7 +5,6 @@
     <link type="guide" xref="tips"/>
     <link type="seealso" xref="keyboard-layouts"/>
 
-
     <credit type="author">
       <name>Shaun McCance</name>
       <email>shaunm gnome org</email>
diff --git a/gnome-help/Makefile.am b/gnome-help/Makefile.am
index 95ce8e4..9aa56ab 100644
--- a/gnome-help/Makefile.am
+++ b/gnome-help/Makefile.am
@@ -15,6 +15,7 @@ HELP_MEDIA = \
 	figures/color-space.png \
 	figures/gnome.png \
 	figures/gnome-searchtool.png \
+	figures/input-keyboard-symbolic.png \
 	figures/nautilus.png \
 	figures/nautilus-icons.png \
 	figures/printing-select.png \
@@ -30,7 +31,6 @@ HELP_MEDIA = \
 	figures/shell-windows.png \
 	figures/shell-workspaces.png \
 	figures/shell.png \
-	figures/system-run.png \
 	figures/universal-access-menu.png \
 	figures/view-fullscreen-16.png \
 	figures/yelp-icon-big.png
@@ -130,6 +130,7 @@ HELP_FILES = \
 	irc.page \
 	keyboard-cursor-blink.page \
 	keyboard-layouts.page \
+	keyboard-osk.page \
 	keyboard-repeat-keys.page \
 	keyboard.page \
 	look-background.page \
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]