[gnome-terminal/wip/mallard-merge: 151/252] Help: Modified pref-scrolling.page.
- From: Ekaterina Gerasimova <egerasimov src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gnome-terminal/wip/mallard-merge: 151/252] Help: Modified pref-scrolling.page.
- Date: Fri, 1 Mar 2013 22:43:15 +0000 (UTC)
commit dfce3a49557e2c3eb259f6c7d1f087528234a83b
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>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]