GNOME.org
 

[gnome-user-docs] Fill-out some a11y topics

commit f149dae15228892e4437b15d7452d35433401c0f
Author: Phil Bull <philbull gmail com>
Date:   Mon Mar 21 18:07:07 2011 -0400

    Fill-out some a11y topics

 gnome-help/C/a11y-dwellclick.page  |   40 +++++++++++++++++++++++------------
 gnome-help/C/a11y-right-click.page |   23 +++++++++-----------
 gnome-help/C/a11y-slowkeys.page    |   36 +++++++++++++++++++------------
 gnome-help/C/a11y-stickykeys.page  |   36 +++++++++++++++++++------------
 gnome-help/C/a11y.page             |    1 +
 5 files changed, 81 insertions(+), 55 deletions(-)
---
diff --git a/gnome-help/C/a11y-dwellclick.page b/gnome-help/C/a11y-dwellclick.page
index 8f3998c..395a110 100644
--- a/gnome-help/C/a11y-dwellclick.page
+++ b/gnome-help/C/a11y-dwellclick.page
@@ -4,31 +4,43 @@
   <info>
     <link type="guide" xref="a11y#mobility" group="clicking"/>
 
-    <revision pkgversion="3.0" date="2010-12-14" status="stub"/>
+    <revision pkgversion="3.0" date="2011-03-21" status="review"/>
 
     <credit type="author copyright">
       <name>Shaun McCance</name>
       <email>shaunm gnome org</email>
       <years>2010</years>
     </credit>
+    
+    <credit type="author copyright">
+      <name>Phil Bull</name>
+      <email>philbull gmail com</email>
+    </credit>
 
-    <desc>The Dwell Click feature allows you to click by holding the mouse still.</desc>
+    <desc>The Dwell Click (Hover Click) feature allows you to click by holding the mouse still.</desc>
   </info>
 
-  <title>Simulate clicking by hovering</title>
+<title>Simulate clicking by hovering</title>
+
+<p>You can make it so that buttons are clicked when you hover the mouse pointer over them (hover click). This is useful if you find it difficult to move the mouse and click the mouse button at the same time. When hover click is turned on you can move your mouse pointer over a button, let go of the mouse and then wait for a while before the button will be clicked for you.</p>
+
+<p>To turn on hover click, click your name on the top bar, select <gui>System Settings</gui> and open <gui>Universal Access</gui>. Then, go to the <gui>Pointing and Clicking</gui> tab and switch <gui>Hover Click</gui> to <gui>ON</gui>.</p>
+
+<p>The <gui>Dwell Click-Type</gui> window will open, and will stay above all of your other windows. You can use this to choose what sort of click should happen when you hover over a button. For example, if you select <gui>Secondary Click</gui>, the mouse will right-click when you hover over a button for a few seconds.</p>
+
+<p>When you hover your mouse pointer over a button and don't move it, it will gradually change color. When it has fully changed color, the button will be clicked.</p>
 
-  <comment>
-    <cite date="2010-12-14" href="mailto:shaunm gnome org">Shaun McCance</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
+<p>Hover click will click anywhere that your mouse pointer is hovering over, not just on buttons.</p>
 
-  <p>Short introductory text...</p>
+<section id="delay">
+ <title>Change how long to wait before the button is clicked</title>
+ <p>You can change how long the delay should be between hovering the mouse pointer over a button and that button being pressed. To do this, go to the <gui>Pointing and Clicking</gui> tab (see above) and change the <gui>Delay</gui> in the <gui>Hover Click</gui> section.</p>
+</section>
 
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
+<section id="threshold">
+ <title>Change how much the mouse is allowed to move/wiggle when hovering</title>
+ <p>You don't need to hold the mouse perfectly still when hovering over a button to click it - the pointer is allowed to move a little bit and will still click after a while. If it moves too much, however, the click will not happen.</p>
+ <p>You can change how much the pointer is allowed to move but still be considered "still enough" to click the button. Go to the <gui>Pointing and Clicking</gui> tab (see above) and change the <gui>Motion threshold</gui> in the <gui>Hover Click</gui> section; a large motion threshold will allow the pointer to move quite a lot but will still register the click.</p>
+</section>
 
 </page>
diff --git a/gnome-help/C/a11y-right-click.page b/gnome-help/C/a11y-right-click.page
index c177ee5..9663736 100644
--- a/gnome-help/C/a11y-right-click.page
+++ b/gnome-help/C/a11y-right-click.page
@@ -4,31 +4,28 @@
   <info>
     <link type="guide" xref="a11y#mobility" group="clicking"/>
  
-    <revision pkgversion="3.0" date="2010-12-14" status="stub"/>
+    <revision pkgversion="3.0" date="2011-03-21" status="review"/>
 
     <credit type="author copyright">
       <name>Shaun McCance</name>
       <email>shaunm gnome org</email>
       <years>2010</years>
     </credit>
+    
+    <credit type="author">
+      <name>Phil Bull</name>
+      <email>philbull gmail com</email>
+    </credit>
 
     <desc>Press and hold the left mouse button to right-click.</desc>
   </info>
 
-  <title>Simulate right click</title>
+<title>Simulate a right mouse click</title>
 
-  <comment>
-    <cite date="2010-12-14" href="mailto:shaunm gnome org">Shaun McCance</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
+<p>You can make it so that, instead of clicking the right mouse button, you can just hold-down the left mouse button for a while to do the same thing. This is useful if you find it difficult to move your fingers individually on one hand, or if you have a specialized mouse.</p>
 
-  <p>Short introductory text...</p>
+<p>To switch this feature on, click your name on the top panel, select <gui>System Settings</gui> and open <gui>Universal Access</gui>. Then, go to the <gui>Pointing and Clicking</gui> tab and switch <gui>Simulated Secondary Click</gui> to <gui>ON</gui>.</p>
 
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
+<p>You can change how long you must hold down the left mouse button for before it is registered as a right click. In the <gui>Pointing and Clicking</gui> tab, change the <gui>acceptance delay</gui> under <gui>Simulated Secondary Click</gui>.</p>
 
 </page>
diff --git a/gnome-help/C/a11y-slowkeys.page b/gnome-help/C/a11y-slowkeys.page
index e671df7..ee21bc5 100644
--- a/gnome-help/C/a11y-slowkeys.page
+++ b/gnome-help/C/a11y-slowkeys.page
@@ -4,31 +4,39 @@
   <info>
     <link type="guide" xref="a11y#mobility" group="keyboard"/>
 
-    <revision pkgversion="3.0" date="2010-12-17" status="stub"/>
+    <revision pkgversion="3.0" date="2011-03-21" status="review"/>
 
     <credit type="author copyright">
       <name>Shaun McCance</name>
       <email>shaunm gnome org</email>
       <years>2010</years>
     </credit>
+    
+    <credit type="author">
+      <name>Phil Bull</name>
+      <email>philbull gmail com</email>
+    </credit>
 
-    <desc>XXXXX</desc>
+    <desc>Have a delay between a key being pressed and that letter appearing on the screen.</desc>
   </info>
 
-  <title>Turn on Slow Keys</title>
+<title>Turn on Slow Keys</title>
+
+<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>
 
-  <comment>
-    <cite date="2010-12-17" href="mailto:shaunm gnome org">Shaun McCance</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
+<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>
 
-  <p>Short introductory text...</p>
+<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>
 
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
+<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>
 
 </page>
diff --git a/gnome-help/C/a11y-stickykeys.page b/gnome-help/C/a11y-stickykeys.page
index b155d67..95e50b4 100644
--- a/gnome-help/C/a11y-stickykeys.page
+++ b/gnome-help/C/a11y-stickykeys.page
@@ -4,31 +4,39 @@
   <info>
     <link type="guide" xref="a11y#mobility" group="keyboard"/>
 
-    <revision pkgversion="3.0" date="2010-12-17" status="stub"/>
+    <revision pkgversion="3.0" date="2011-03-21" status="review"/>
 
     <credit type="author copyright">
       <name>Shaun McCance</name>
       <email>shaunm gnome org</email>
       <years>2010</years>
     </credit>
+    
+    <credit type="author">
+      <name>Phil Bull</name>
+      <email>philbull gmail com</email>
+    </credit>
 
-    <desc>XXXXX</desc>
+    <desc>Type keyboard shortcuts one key at a time rather than having to hold down all of the keys at once.</desc>
   </info>
 
-  <title>Turn on Sticky Keys</title>
+<title>Turn on Sticky Keys</title>
+
+<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>
 
-  <comment>
-    <cite date="2010-12-17" href="mailto:shaunm gnome org">Shaun McCance</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
+<p>You should 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> and switch <gui>Sticky Keys</gui> to <gui>ON</gui>.</p>
 
-  <p>Short introductory text...</p>
+<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>
 
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
+<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>
 
 </page>
diff --git a/gnome-help/C/a11y.page b/gnome-help/C/a11y.page
index d723118..78b95b2 100644
--- a/gnome-help/C/a11y.page
+++ b/gnome-help/C/a11y.page
@@ -52,6 +52,7 @@
 
   <section id="mobility">
     <title>Mobility Impairments</title>
+    
     <links type="topic" groups="pointing" style="linklist">
       <title>Mouse movement</title>
     </links>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]