[gnome-terminal/wip/mallard-merge: 240/271] help: review pref-keyboard-access.page

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 1ca75ff78873a2f4ffdc95bd3c8188342220c66e
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Sat Mar 2 23:39:27 2013 +0000

    help: review pref-keyboard-access.page

 help/C/pref-keyboard-access.page |   36 +++++++++++++++++++++---------------
 1 files changed, 21 insertions(+), 15 deletions(-)
---
diff --git a/help/C/pref-keyboard-access.page b/help/C/pref-keyboard-access.page
index df084a6..49e00b7 100644
--- a/help/C/pref-keyboard-access.page
+++ b/help/C/pref-keyboard-access.page
@@ -23,61 +23,67 @@
       <years>2013</years>
     </credit>
 
-    <desc>Access <app>Terminal</app> menus using keys.</desc>
+    <desc>Navigate around <app>Terminal</app> menus using keyboard keys.</desc>
   </info>
 
   <title>Keyboard accessibility</title>
 
   <note style="important">
-    <p>These settings work only when the <app>Terminal</app> menubar is set to be visible.</p>
+    <p>These keys will only have an effect in windows in which the menubar is
+    set to be visible.</p>
   </note>
 
-  <p>You can navigate the <app>Terminal</app> menu using a combination
-  of keys. You can access them in the following ways:</p>
+  <p>You can navigate the <app>Terminal</app> menu using a combination of keys
+  that are called <em>mnemocnis</em> or a special key that takes you directly
+  to the first menu in the menubar which is called a <em>menu accelerator
+  key</em>.</p>
 
-  <section id="menu-access-keys">
-    <title>Menu access keys</title>
+  <section id="mnemonics">
+    <title>Mnemonics</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 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>.</p>
 
-    <p>To enable <gui>Menu access keys</gui>:</p>
+    <p>To enable mnemonics:</p>
 
     <steps>
       <item>
         <p>Select <guiseq><gui style="menu">Edit</gui>
        <gui style="menuitem">Preferences</gui>
-       <gui style="tab">Keybindings</gui></guiseq>.</p>
+       <gui style="tab">General</gui></guiseq>.</p>
       </item>
       <item>
-        <p>Check <gui style="checkbox">Enable menu access keys</gui>.</p>
+        <p>Check <gui style="checkbox">Enable mnemonics</gui>.</p>
       </item>
     </steps>
 
   </section>
 
-  <section id="menu-shortcut-key">
-    <title>Menu shortcut key</title>
+  <section id="menu-accelerator">
+    <title>Menu accelerator key</title>
 
-    <p>This setting brings up the <gui style="menu">File</gui> menu when
-    <key>F10</key> is pressed:</p>
+    <p>This setting brings up the <gui style="menu">File</gui> menu the menu
+    accelerator key is pressed. This key is usually <key>F10</key> by
+    default.</p>
 
     <steps>
       <item>
         <p>Select <guiseq><gui style="menu">Edit</gui>
        <gui style="menuitem">Preferences</gui>
-       <gui style="tab">Keybindings</gui></guiseq>.</p>
+       <gui style="tab">Shortcuts</gui></guiseq>.</p>
       </item>
       <item>
-        <p>Check <gui style="checkbox">Enable menu shortcut key</gui>.</p>
+        <p>Check <gui style="checkbox">Enable the menu accelerator
+        key</gui>.</p>
       </item>
     </steps>