[gnome-terminal/wip/mallard-merge: 65/202] help: review adv-keyboard-shortcuts.page



commit d694cf354e2a22a82a83c6ca497a9482d464ee08
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Fri Feb 15 21:59:53 2013 +0000

    help: review adv-keyboard-shortcuts.page

 help/C/adv-keyboard-shortcuts.page |  122 ++++++++++++++++++++++++------------
 1 files changed, 82 insertions(+), 40 deletions(-)
---
diff --git a/help/C/adv-keyboard-shortcuts.page b/help/C/adv-keyboard-shortcuts.page
index 93adeee..c197234 100644
--- a/help/C/adv-keyboard-shortcuts.page
+++ b/help/C/adv-keyboard-shortcuts.page
@@ -12,7 +12,7 @@
       <email>sindhus live in</email>
       <years>2013</years>
     </credit>
-    <credit type="copyright editor">
+    <credit type="author copyright editor">
       <name>Ekaterina Gerasimova</name>
       <email>kittykat3756 gmail com</email>
       <years>2013</years>
@@ -31,53 +31,91 @@
   actions, such as opening the settings dialog or accessing a feature inside
   <app>Terminal</app>, quickly. These shortcuts can be modified to suit your
   requirements.</p>
-  
+
+  <p>To change a keyboard shortcut:</p>
   <steps>
     <item>
-      <p>To change the default keyboard shortcuts, go to to <guiseq><gui
-  style="menu">Edit</gui><gui style="menuitem">Preferences</gui><gui
-  style="tab">Keybindings</gui></guiseq>.</p>
+      <p>Select <guiseq><gui style="menu">Edit</gui>
+      <!-- Preferences has an elipsis on th end, make sure that you cope GUI
+      strings as they are in the UI. -->
+      <gui style="menuitem">Preferences…</gui>
+      <gui style="tab">Keybindings</gui></guiseq>.</p>
+    </item>
+    <!-- Be more precise, it is not a double click but two single clicks. This
+    is important because a double click on the action will have no effect, a
+    double click on a focused item will not allow editing and touch screens do
+    not allow double clicks. -->
+    <item>
+      <p>Select the shortcut that you wish to edit by clicking on it.</p>
+    </item>
+    <item>
+      <p>Once the shortcut is selected, click on the shortcut key to edit
+      it.</p>
     </item>
     <item>
-      <p>Select the shortcut by double clicking on it. Press the desired combination of keys, once keys are 
released, it will be registered as the new keyboard shortcut for the selected action in 
<app>Terminal</app></p>
+      <!-- In full: Ctrl, Shift and/or Alt (Gr) + letter/number OR return/space
+      OR letter/number. -->
+      <p>Type in your desired shortcut key combination as you would enter it to
+      use it. The keys that you can use include <key>Alt</key>, <key>Alt
+      Gr</key>, <key>Ctrl</key>, <key>Shift</key>, number and letter keys.</p>
+    </item>
+    <item>
+      <p>Once you have entered your new shortcut, it will automatically be
+      saved and you should see it in the list, next to the action that it
+      corresponds to.</p>
     </item>
   </steps>
 
-  <p>The default shortcuts for options under <gui style="menu">File</gui> menu are:</p>
+  <note>
+    <p>It is not possible to reset shortcuts automatically back to the default
+    settings. This means that once you have set a shortcut for an action that
+    is disabled by default, you cannot disable it again.</p>
+  </note>
 
-  <table frame="all" rules="rows cols">
-  <tr>
-    <td><p>Action</p></td>  <td><p>Keyboard Shortcuts</p></td>
-  </tr>
-  <tr>
-    <td><p>New Tab</p></td> <td><p><keyseq><key>Shift</key><key>Control</key><key>T</key></keyseq></p></td>
-  </tr>
-  <tr>
-    <td><p>New Window</p></td>  
<td><p><keyseq><key>Shift</key><key>Control</key><key>N</key></keyseq></p></td>
-  </tr>
-  <tr>
-    <td><p>Close Tab</p></td>  
<td><p><keyseq><key>Shift</key><key>Control</key><key>W</key></keyseq></p></td>
-  </tr>
-  <tr>
-    <td><p>Close Window</p></td>  
<td><p><keyseq><key>Shift</key><key>Control</key><key>Q</key></keyseq></p></td>
-  </tr>
+<!-- Make your tables consistent with the current style in gnome-user-help, as
+I have done for the first one. -->
+
+  <table rules="rows" frame="top bottom">
+    <title><gui style="menu">File</gui></title>
+    <tr>
+      <td><p>Action</p></td>
+      <td><p>Keyboard Shortcuts</p></td>
+    </tr>
+    <tr>
+      <td><p>New Tab</p></td>
+      <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>T</key></keyseq></p></td>
+    </tr>
+    <tr>
+      <td><p>New Window</p></td>
+      <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>N</key></keyseq></p></td>
+    </tr>
+    <tr>
+      <td><p>Close Tab</p></td>
+      <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>W</key></keyseq></p></td>
+    </tr>
+    <tr>
+      <td><p>Close Window</p></td>
+      <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Q</key></keyseq></p></td>
+    </tr>
   </table>
 
-  <p>The default shortcuts for options under <gui style="menu">Edit</gui> menu are:</p>
+  <p>The default shortcuts for options in the <gui style="menu">Edit</gui> menu
+  are:</p>
 
   <table frame="all" rules="rows cols">
   <tr>
     <td><p>Action</p></td>  <td><p>Keyboard Shortcuts</p></td>
   </tr>
   <tr>
-    <td><p>Copy</p></td> <td><p><keyseq><key>Control</key><key>Shift</key><key>C</key></keyseq></p></td>
+    <td><p>Copy</p></td> <td><p><keyseq><key>Ctrl</key><key>Shift</key><key>C</key></keyseq></p></td>
   </tr>
   <tr>
-    <td><p>Paste</p></td>  <td><p><keyseq><key>Control</key><key>Shift</key><key>V</key></keyseq></p></td>
+    <td><p>Paste</p></td>  <td><p><keyseq><key>Ctrl</key><key>Shift</key><key>V</key></keyseq></p></td>
   </tr>
   </table>
 
-  <p>The default shortcuts for options under <gui style="menu">View</gui> menu are:</p>
+  <p>The default shortcuts for options in the <gui style="menu">View</gui> menu
+  are:</p>
 
     <table frame="all" rules="rows cols">
   <tr>
@@ -87,33 +125,34 @@
     <td><p>Full Screen</p></td> <td><p><keyseq><key>F11</key></keyseq></p></td>
   </tr>
   <tr>
-    <td><p>Zoom in</p></td>  <td><p><keyseq><key>Control</key><key>+</key></keyseq></p></td>
+    <td><p>Zoom in</p></td>  <td><p><keyseq><key>Ctrl</key><key>+</key></keyseq></p></td>
   </tr>
   <tr>
-    <td><p>Zoom Out</p></td>  <td><p><keyseq><key>Control</key><key>-</key></keyseq></p></td>
+    <td><p>Zoom Out</p></td>  <td><p><keyseq><key>Ctrl</key><key>-</key></keyseq></p></td>
   </tr>
   <tr>
-    <td><p>Normal Size</p></td>  <td><p><keyseq><key>Control</key><key>0</key></keyseq></p></td>
+    <td><p>Normal Size</p></td>  <td><p><keyseq><key>Ctrl</key><key>0</key></keyseq></p></td>
   </tr>
   </table>
 
-  <p>The default shortcuts for Tabs operations in <app>Terminal</app> are:</p>
+  <!-- Do not capitalise nouns unless they are proper nouns. -->
+  <p>The default shortcuts for working with tabs are:</p>
 
   <table frame="all" rules="rows cols">
   <tr>
     <td><p>Action</p></td>  <td><p>Keyboard Shortcuts</p></td>
   </tr>
   <tr>
-    <td><p>Switch to Previous Tab</p></td> <td><p><keyseq><key>Control</key><key>Page 
Up</key></keyseq></p></td>
+    <td><p>Switch to Previous Tab</p></td> <td><p><keyseq><key>Ctrl</key><key>Page Up</key></keyseq></p></td>
   </tr>
   <tr>
-    <td><p>Switch to Next Tab</p></td>  <td><p><keyseq><key>Control</key><key>Page 
Down</key></keyseq></p></td>
+    <td><p>Switch to Next Tab</p></td>  <td><p><keyseq><key>Ctrl</key><key>Page Down</key></keyseq></p></td>
   </tr>
   <tr>
-    <td><p>Move Tab to the Left</p></td>  <td><p><keyseq><key>Shift</key><key>Control</key><key>Page 
Up</key></keyseq></p></td>
+    <td><p>Move Tab to the Left</p></td>  <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Page 
Up</key></keyseq></p></td>
   </tr>
   <tr>
-    <td><p>Move Tab to the Right</p></td>  <td><p><keyseq><key>Shift</key><key>Control</key><key>Page 
Down</key></keyseq></p></td>
+    <td><p>Move Tab to the Right</p></td>  <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Page 
Down</key></keyseq></p></td>
   </tr>
   <tr>
     <td><p>Switch to Tab 1</p></td>  <td><p><keyseq><key>Alt</key><key>1</key></keyseq></p></td>
@@ -147,7 +186,8 @@
   </tr>
   </table>
 
-  <p>The default shortcuts under the <gui style="menu">Help</gui> are:</p>
+  <p>The default shortcuts for accessing items in the
+  <gui style="menu">Help</gui> menu are:</p>
 
   <table>
   <tr>
@@ -155,6 +195,8 @@
   </tr>
   </table>
 
+<!-- This warrants a section of its own. Are you planning to include all
+shortcuts here? -->
   <p>Shell specific keyboard shortcuts:</p>
 
     <table frame="all" rules="rows cols">
@@ -162,14 +204,14 @@
     <td><p>Action</p></td>  <td><p>Keyboard shortcut</p></td>
   </tr>
   <tr>
-    <td><p>Erase a word</p></td>  <td><p><keyseq><key>Control</key><key>W</key></keyseq></p></td>
+    <td><p>Erase a word</p></td>  <td><p><keyseq><key>Ctrl</key><key>W</key></keyseq></p></td>
   </tr>
   <tr>
-    <td><p>Erase a line</p></td>  <td><p><keyseq><key>Control</key><key>U</key></keyseq></p></td> 
+    <td><p>Erase a line</p></td>  <td><p><keyseq><key>Ctrl</key><key>U</key></keyseq></p></td> 
   </tr>
   <tr>
-    <td><p>Bring up search tool</p></td>  <td><p><keyseq><key>Control</key><key>R</key></keyseq></p></td> 
+    <td><p>Bring up search tool</p></td>  <td><p><keyseq><key>Ctrl</key><key>R</key></keyseq></p></td> 
   </tr>
   </table>
 
-</page>
\ No newline at end of file
+</page>


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]