[gnome-terminal/mallard-help] help: review pref-keyboard-access.page

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 7ca770770312466867c69d0a998cc49cfaf0aaee
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Mon Feb 25 23:57:18 2013 +0100

    help: review pref-keyboard-access.page

 help/C/pref-keyboard-access.page |   78 ++++++++++++++++++++-----------------
 1 files changed, 42 insertions(+), 36 deletions(-)
---
diff --git a/help/C/pref-keyboard-access.page b/help/C/pref-keyboard-access.page
index 0073439..1213fc9 100644
--- a/help/C/pref-keyboard-access.page
+++ b/help/C/pref-keyboard-access.page
@@ -3,7 +3,7 @@
       id="pref-keyboard-access">
 
   <info>
-    <revision version="0.1" date="2013-01-11" status="draft"/>
+    <revision version="0.1" date="2013-02-25" status="review"/>
     <link type="guide" xref="index#preferences"/>
     <link type="seealso" xref="pref-menubar"/>
 
@@ -18,55 +18,61 @@
       <years>2013</years>
     </credit>
 
-    <desc>Access <app>Terminal</app> menus using keys</desc>
+    <desc>Access <app>Terminal</app> menus using keys.</desc>
   </info>
 
   <title>Keyboard accessibility</title>
 
-  <p>You can navigate around the <app>Terminal</app> menu using a combination of
-  keys. You can access them in the following ways:</p>
+  <p>You can navigate around the <app>Terminal</app> menu using a combination
+  of keys. You can access them in the following ways:</p>
 
   <section id="menu-access-keys">
     <title>Menu access keys</title>
-  <p><app>Terminal</app> menu can be accessed by combining the <key>Alt</key>
-  key and a letter of the menu item. The letter you can access for the menu is
-  underlined in the menu.</p>
 
-  <p>For example, you can access <gui style="menuitem">Character
-  Encoding</gui>submenu using <keyseq><key>Alt</key><key>T</key></keyseq>,
-  followed by <key>C</key>. Similarly, you can access <gui
-  style="menu">File</gui> menu using
-  <keyseq><key>Alt</key><key>F</key></keyseq>. To enable <gui>Menu access
-  keys</gui>:</p>
+    <p><app>Terminal</app> menu can be accessed by combining the <key>Alt</key>
+    key and a letter of the menu item. The letter that you need to use to
+    access the menu will be underlined when you hold down the
+    <key>Alt</key>.</p>
+
+    <!-- Note to self, test this. -->
+    <p>For example, you can access <gui style="menuitem">Character
+    Encoding</gui> submenu using <keyseq><key>Alt</key><key>T</key></keyseq>,
+    followed by <key>C</key>. Similarly, you can access
+    <gui style="menu">File</gui> menu using
+    <keyseq><key>Alt</key><key>F</key></keyseq>. To enable <gui>Menu access
+    keys</gui>:</p>
+
+    <steps>
+      <item>
+        <p>Select <guiseq><gui style="menu">Edit</gui>
+       <gui style="menuitem">Preferences</gui>
+       <gui style="tab">Keybindings</gui></guiseq>.</p>
+      </item>
+      <item>
+        <p>Check <gui style="checkbox">Enable menu access keys</gui>.</p>
+      </item>
+    </steps>
 
-  <steps>
-    <item>
-      <p>Go to <guiseq><gui style="menu">Edit</gui> <gui
-      style="menuitem">Preferences</gui> <gui
-      style="tab">Keybindings</gui></guiseq>.</p>
-    </item>
-    <item>
-      <p>Select <gui style="checkbox">Enable menu access keys</gui>.</p>
-    </item>
-  </steps>
   </section>
 
   <section id="menu-shortcut-key">
     <title>Menu shortcut key</title>
 
-  <p>This setting brings up the <gui style="menu">File</gui> menu in
-  <app>Terminal</app>.</p>
+    <p>This setting brings up the <gui style="menu">File</gui> menu when
+    <key>F10</key> is pressed:</p>
+    <!-- TODO: check that F10 can be changed to other keys. -->
 
-  <steps>
-    <item>
-      <p>Go to <guiseq><gui style="menu">Edit</gui><gui
-      style="menuitem">Preferences</gui><gui
-      style="tab">Keybindings</gui></guiseq>.</p>
-    </item>
-    <item>
-      <p>Select <gui style="checkbox">Enable menu shortcut key</gui>.</p>
-    </item>
-  </steps>
-</section>
+    <steps>
+      <item>
+        <p>Select <guiseq><gui style="menu">Edit</gui>
+       <gui style="menuitem">Preferences</gui>
+       <gui style="tab">Keybindings</gui></guiseq>.</p>
+      </item>
+      <item>
+        <p>Check <gui style="checkbox">Enable menu shortcut key</gui>.</p>
+      </item>
+    </steps>
+
+  </section>
 
 </page>