[gnome-terminal/mallard-help] help: review adv-keyboard-shortcuts.page

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit dbb4e05e494ed3c24e415a086d9300ac8259e27e
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Sun Feb 24 12:19:22 2013 +0100

    help: review adv-keyboard-shortcuts.page

 help/C/adv-keyboard-shortcuts.page |   18 ++++++++++++------
 1 files changed, 12 insertions(+), 6 deletions(-)
---
diff --git a/help/C/adv-keyboard-shortcuts.page b/help/C/adv-keyboard-shortcuts.page
index 9d781e3..d8d7b8c 100644
--- a/help/C/adv-keyboard-shortcuts.page
+++ b/help/C/adv-keyboard-shortcuts.page
@@ -53,6 +53,7 @@
       it.</p>
     </item>
     <item>
+      <!-- Do not break line half way though a tag unless you have to. -->
       <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>
@@ -71,8 +72,9 @@
 
   <section id="file-shortcuts">
     <title><gui style="menu">File</gui> shortcuts</title>
-    <p>The default shortcuts for options under <gui style="menu">File</gui> menu
-    are:</p>
+
+    <p>The default shortcuts for options under <gui style="menu">File</gui>
+    menu are:</p>
 
     <table rules="rows" frame="top bottom" ui:expanded="yes">
       <thead>
@@ -104,8 +106,9 @@
 
   <section id="edit-shortcuts">
     <title><gui style="menu">Edit</gui> shortcuts</title>
-    <p>The default shortcuts for options under <gui style="menu">Edit</gui> menu
-    are:</p>
+
+    <p>The default shortcuts for options under <gui style="menu">Edit</gui>
+    menu are:</p>
 
     <table rules="rows" frame="top bottom" ui:expanded="no">
       <thead>
@@ -142,6 +145,7 @@
       <tbody>
         <tr>
           <td><p>Full Screen</p></td>
+         <!-- Single keys should not be in a <keyseq> -->
           <td><p><keyseq><key>F11</key></keyseq></p></td>
         </tr>
         <tr>
@@ -255,8 +259,10 @@
 
   <section id="shell-shortcuts">
     <title>Shell shortcuts</title>
+    <!-- Bash is <app> or nothing, check the markup in gnome-user-docs. -->
     <p><gui>Bash</gui> shell specific keyboard shortcuts:</p>
 
+    <!-- Use capital letters for keys. -->
     <table rules="rows" frame="top bottom" ui:expanded="no">
       <thead>
         <tr>
@@ -337,8 +343,8 @@
 
   <comment>
     <cite date="2013-02-24" href="mailto:mdhillca gmail com">Michael Hill</cite>
-      <p>The keybinding for reverse incremental search should be Ctrl-R.
-      Non-incremental should be Alt-P.</p>
+    <p>The keybinding for reverse incremental search should be Ctrl-R.
+    Non-incremental should be Alt-P.</p>
   </comment>
 
 </page>