[gnome-terminal] help: Modified help on app-terminal-sizes.page

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 990ffa7f768dbf2ca1673f19a439cf4eacf973f7
Author: Sindhu S <sindhus live in>
Date:   Tue Feb 26 00:19:22 2013 +0530

    help: Modified help on app-terminal-sizes.page
    
    Reworded help as instructed in previous review.
    Added new introductory explanation to when changing
    Terminal sizes would be useful.
    Made necessary mallard tag changes as asked in review.

 help/C/app-terminal-sizes.page |   60 ++++++++++++++++-----------------------
 1 files changed, 25 insertions(+), 35 deletions(-)
---
diff --git a/help/C/app-terminal-sizes.page b/help/C/app-terminal-sizes.page
index 4f627e8..8134f80 100644
--- a/help/C/app-terminal-sizes.page
+++ b/help/C/app-terminal-sizes.page
@@ -24,23 +24,21 @@
 
   <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>
+  <p>You may require <app>Terminal</app> windows to be of a particular size when
+  you work with certain command line applications that have minimum terminal
+  size requirements in order to display correctly or if you want to view long
+  lines of terminal output with minimal line breaks on your display.</p>
+
+  <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>
+      <p>To open a <app>Terminal</app> window in preset 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>
+      <p>You can choose from the options:</p>
       <list>
         <item>
           <p><gui>80×24</gui></p>
@@ -59,38 +57,30 @@
   </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>
+    <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></keyseq> and then press <key>1</key> to
+    open a <app>Terminal</app> window of size <gui>80×24</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>
+  <p>If you require custom size <app>Terminal</app> windows, you can also alter
+  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>
+      <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>
+    <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>
+     <p>You can set <gui>Default size</gui> columns and rows by typing the
+     desired number of columns and rows in the input boxes next to <gui>Default
+     size:</gui> for <gui>columns</gui> and <gui>rows</gui>. You can also click
+     on <gui style="button">+</gui> to increase and/or <gui
+     style="button">-</gui> to decrease the size.</p>
     </item>
   </steps>
 
-</page>
+</page>
\ No newline at end of file