[gnome-terminal/help-pages] help: review app-reset.page

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit c47f1ff795e9f286a8608ec94556ab029201cb1a
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Mon Mar 11 22:09:37 2013 +0000

    help: review app-reset.page

 help/C/app-reset.page |   35 ++++++++++++++++++++++++++++++++---
 1 files changed, 32 insertions(+), 3 deletions(-)
---
diff --git a/help/C/app-reset.page b/help/C/app-reset.page
index dbb4e71..1f2ccb7 100644
--- a/help/C/app-reset.page
+++ b/help/C/app-reset.page
@@ -20,11 +20,17 @@
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>Reset and clear <app>Terminal</app> screen.</desc>
+    <desc>Reset and clear the <app>Terminal</app> screen that you are viewing.</desc>
   </info>
 
-  <title>Reset <app>Terminal</app></title>
+  <title>Reset your terminal</title>
 
+  <comment>
+    <cite href="kittykat3756 gmail com">Kat</cite>
+    <p>Start with a more generic sentence such as "If your terminal is showing
+    you gibberish (use a better, more precise word), you may need to reset
+    it.".</p>
+  </comment>
   <p>If you have used <cmd>cat</cmd> on a file that contains binary data, your
   <app>Terminal</app> screen could be filled with gibberish symbols. You can
   recover your <app>Terminal</app> in the following ways:</p>
@@ -32,19 +38,41 @@
   <section id="reset">
     <title>Reset</title>
 
-    <p>Reset <app>Terminal</app> screen.</p>
+    <p>Reset your <app>Terminal</app> screen.</p>
+    <comment>
+      <cite href="kittykat3756 gmail com">Kat</cite>
+      <p>It is worth mentioning here that the output needs to have stopped
+      outputting at this point :)</p>
+    </comment>
 
     <steps>
       <item>
         <p>Select <guiseq><gui style="menu">Terminal</gui><gui
         style="menuitem">Reset</gui></guiseq>.</p>
+        <comment>
+          <cite href="kittykat3756 gmail com">Kat</cite>
+          <p>Reflow so that you do not break the <gui> tag between the tag and
+          attributes.</p>
+        </comment>
       </item>
       <item>
         <p>Press <keyseq><key>Ctrl</key><key>L</key></keyseq> to obtain the
         prompt.</p>
+        <comment>
+          <cite href="kittykat3756 gmail com">Kat</cite>
+          <p>Ctrl+L does not give a prompt, it clears the output. Is it
+          possible that you are seeing not seeing the prompt because it is
+          you have not scrolled to the bottom of the screen?</p>
+        </comment>
       </item>
     </steps>
 
+    <comment>
+      <cite href="kittykat3756 gmail com">Kat</cite>
+      <p>TODO for Sindhu: check that Reset clears the prompt by testing the
+      behaviour. Document the behaviour.</p>
+    </comment>
+
   </section>
 
   <section id="reset-clear">
@@ -64,4 +92,5 @@
     </steps>
 
   </section>
+
 </page>