[gnome-terminal/wip/mallard-merge: 89/202] help: review app-terminal-sizes.page

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 4621bf0a694b09dfda02442017ea0f64d5abb6bc
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Sun Feb 17 17:20:23 2013 +0000

    help: review app-terminal-sizes.page

 help/C/app-terminal-sizes.page |   16 ++++++++++++++++
 1 files changed, 16 insertions(+), 0 deletions(-)
---
diff --git a/help/C/app-terminal-sizes.page b/help/C/app-terminal-sizes.page
index 278203f..4f627e8 100644
--- a/help/C/app-terminal-sizes.page
+++ b/help/C/app-terminal-sizes.page
@@ -24,15 +24,22 @@
 
   <title><app>Terminal</app> sizes</title>
 
+  <!-- Reword the introductory sentence as it makes less sense now that stuff
+  is in different order on the page. -->
   <p>You can change the <app>Terminal</app> window size to the
   following presets:</p>
   
   <steps>
     <item>
+      <!-- In what sizes? Reword. Note that 'To do *something* should normally
+      be before the start of the steps. Full stop is missing at the end of this
+      item. -->
       <p>To open a <app>Terminal</app> window in these sizes, go to
       <guiseq><gui style="menu">Terminal</gui></guiseq></p>
     </item>
     <item>
+      <!-- If you are listing something and the previous sentence tells the
+      user what the list is, you should normally end it with a colon. -->
       <p>Choose from the options given in the menu.</p>
       <list>
         <item>
@@ -52,25 +59,34 @@
   </steps>
 
   <note style="tip">
+    <!-- Reflow. Your keyseq does not work in one combination. Make sure that
+    you use × instead of x. -->
     <p>If you have enabled <link xref="pref-keyboard-access"><gui>Menu access keys</gui></link>, you can 
access this
     menu by pressing <keyseq><key>Alt</key><key>T</key><key>1</key></keyseq> to
     open a <app>Terminal</app> window of size <gui>80x24</gui> and so on.</p>
   </note>
 
+  <!-- Reflow properly: the second line should start at the same indenting as
+  the paragraph tag. Is this in addition to the above? Or alternatively? Make
+  this explicit. -->
   <p>You can alter <app>Terminal</app> sizes according to your
      requirements:</p>
 
   <steps>
     <item>
+      <!-- Indent properly. Be precise when you copy UI strings. -->
        <p>Go to <guiseq><gui style="menu">Edit</gui><gui
      style="menuitem">Profile Preferences</gui><gui
      style="tab">General</gui></guiseq>.</p>
    </item>
    <item>
+      <!-- Indent properly, reflow. -->
     <p>Select <gui>Use custom default terminal
      size</gui>.</p>
    </item>
    <item>
+      <!-- The faster way to do this is to just type in the number of columns
+      or rows manually. -->
     <p>You can set <gui>Default size</gui> columns and rows by
      clicking on <gui style="button">+</gui> to increase size and <gui
      style="button">-</gui> to decrease.</p>