[gnome-terminal/wip/mallard-merge: 154/241] Help: Modified pref-scrolling.page.

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 48a7dc805a14f6c12e718316486aef9a2c7ee00e
Author: Sindhu S <sindhus live in>
Date:   Thu Feb 21 13:24:47 2013 +0530

    Help: Modified pref-scrolling.page.
    
    Added introduction about scrollbars: what they can do for user
    and their attributes in the GUI environment.
    Added sections to explain scrollbar related options.
    Added a note about potential burden on user's computer when
    scrollback lines are set to unlimited.
    Reflowed paragraphs on the page.

 help/C/pref-scrolling.page |  125 ++++++++++++++++++++++++++++++++++++--------
 1 files changed, 103 insertions(+), 22 deletions(-)
---
diff --git a/help/C/pref-scrolling.page b/help/C/pref-scrolling.page
index 4d5f268..8b56d81 100644
--- a/help/C/pref-scrolling.page
+++ b/help/C/pref-scrolling.page
@@ -20,40 +20,121 @@
     <desc>Set scroll output and scrollbar behaviour.</desc>
   </info>
 
-<!-- TODO: reflow text. -->
-
   <title>Scrollbar preferences</title>
 
-<!-- Add some text here please. -->
+  <p>A scrollbar is a part of the Graphical User Interface (GUI) which allows
+  anything continuous and exceeding the visible screen space such as text to be
+  viewable by the user by scrolling down to the parts hidden from current
+  view.</p>
 
-<!-- Followed by some <steps> that contain instructions. -->
+  <p>Scrollbars are usually placed at either sides of the viewing area as long
+  rectangualr areas containing a bar that can be dragged along the track to move
+  the body of the text. Scrollbars also contain arrows on either end of this
+  track to for precise adjustments.</p>
 
-  <terms>
-    <item>
-      <title>Scrollbar visibility can be set to any of the three options...</title>
+  <section id="scrollbar-visibility">
+    <title>Scrollbar visibility</title>
+
+  <p>To set scrollbar visibility in <app>Terminal</app>:</p>
+
+    <steps>
+      <item>
+        <p>Go to <guiseq><gui style="menu">Edit</gui><gui
+        style="menuitem">Profile Preferences</gui><gui
+        style="tab">Scrolling</gui></guiseq>.</p>
+      </item>
+      <item>
+        <p>You can choose from the following options:</p>
         <list>
-          <item><p><gui style="menuitem">Always visible</gui>: Scrollbar is visible at all times.</p></item>
-          <item><p><gui style="menuitem">Visible only when necessary</gui>: Scrollbar is visible only when 
terminal output exceeds the length of <app>Terminal</app> window size.</p></item>
-          <item><p><gui style="menuitem">Hidden</gui>: Scrollbar is always hidden from view.</p></item>
+          <item>
+            <p><gui style="menuitem">Always visible</gui>: Scrollbar is visible
+            at all times.</p>
+          </item>
+          <item>
+            <p><gui style="menuitem">Visible only when necessary</gui>:
+            Scrollbar is visible only when terminal output exceeds the length of
+            <app>Terminal</app> window size.</p>
+          </item>
+          <item>
+            <p><gui style="menuitem">Hidden</gui>: Scrollbar is always hidden
+            from view.</p>
+          </item>
         </list>
-      <p>To set scrollbar visibility in <app>Terminal</app> go to <guiseq><gui style="menu">Edit</gui><gui 
style="menuitem">Profile Preferences</gui><gui style="tab">Scrolling</gui></guiseq> and select the desired 
visibility state from <gui>Scrollbar is</gui> menu.</p>
     </item>
     <item>
-      <title><gui>Scrollback</gui> lines</title>
-      <p><gui>Scrollback</gui> lines indicate the number of <app>Terminal</app> output lines stored in 
memory for scrolling. The default number of scrollback lines is <input>8192</input>. To change this, click on 
<gui style="button">+</gui> to increase and <gui style="button">-</gui> to decrease lines. You can also 
manually input a number greater than 0 to set scrollback lines.</p>
-      <!-- Where did you get the 8192 from? It is 1024 for me. -->
-      <p>To have unlimited scrollback lines, select <gui style="checkbox">Unlimited</gui> as your option.</p>
-      <!-- Talk about potential downsides to 'Unlimited'. It *may* be stored in memory/swap rather than on 
disk - ask Christian. -->
+      <p>Your preference is saved immediately. Click <gui
+      style="button">Close</gui> to return to <app>Terminal</app>.</p>
+  </item>
+  </steps>
+
+  </section>
+
+  <section id="scrollback-lines">
+    <title>Scrollback lines</title>
+
+    <p><gui>Scrollback</gui> lines indicate the number of <app>Terminal</app>
+    output lines stored in memory for scrolling.</p>
+
+  <steps>
+    <item>
+      <p>Go to <guiseq><gui style="menu">Edit</gui><gui style="menuitem">Profile
+      Preferences</gui><gui style="tab">Scrolling</gui></guiseq>.</p>
     </item>
     <item>
-      <title><gui style="checkbox">Scroll on output</gui></title>
-        <p><app>Terminal</app> can automatically scroll down to the latest output as a command or program 
executes. To enable this, select <gui style="checkbox">Scroll on output</gui>.</p>
+      <p>In the input box next to <gui>Scrollback</gui>, input a number greater
+      than 0 to set the number of scrollback lines.</p>
     </item>
     <item>
-      <title>Scroll on keystroke</title>
-        <p><gui style="checkbox">Scroll on keystroke</gui>, when enabled allows
-        the <app>Terminal</app> to scroll down to prompt, on press of any key that can be an input to 
prompt, such as an alphabet, numbers, tab key etc.</p>
+      <p>Optionally, you can click on <gui style="button">+</gui> to increase
+      and <gui style="button">-</gui> to decrease lines.</p>
+    </item>
+  </steps>
+
+  <p>To have unlimited scrollback lines, check <gui
+  style="checkbox">Unlimited</gui> as your option.</p>
+
+  <note style="warning">
+    <p><gui style="checkbox">Unlimited</gui> scrollback lines could potentially
+    overburden your computer's memory and make <app>Terminal</app> sluggish
+    during scrolling!</p>
+  </note>
+  </section>
+
+  <section id="scroll-on-output">
+    <title>Scroll on output</title>
+
+    <p><app>Terminal</app> can automatically scroll down to the latest output as
+    a command executes.</p>
+
+    <steps>
+      <item>
+        <p>Go to <guiseq><gui style="menu">Edit</gui><gui
+        style="menuitem">Profile Preferences</gui><gui
+        style="tab">Scrolling</gui></guiseq>.</p>
+      </item>
+      <item>
+        <p>Select <gui style="checkbox">Scroll on output</gui>.</p>
+      </item>
+    </steps>
+  </section>
+
+  <section id="scroll-on-keystroke">
+    <title>Scroll on keystroke</title>
+
+    <p><gui style="checkbox">Scroll on keystroke</gui>, when enabled allows
+    the<app>Terminal</app> to scroll down to prompt, on press of any key that
+    can be an input to prompt, such as an alphabet, numbers, tab key etc.</p>
+
+    <steps>
+      <item>
+        <p>Go to <guiseq><gui style="menu">Edit</gui><gui
+        style="menuitem">Profile Preferences</gui><gui
+        style="tab">Scrolling</gui></guiseq>.</p>
+      </item>
+      <item>
+        <p>Select <gui style="checkbox">Scroll on keystroke</gui>.</p>
       </item>
-  </terms>
+    </steps>
+  </section>
 
 </page>