summaryrefslogtreecommitdiffstats
path: root/help/C
diff options
context:
space:
mode:
Diffstat (limited to 'help/C')
-rw-r--r--help/C/adv-keyboard-shortcuts.page410
-rw-r--r--help/C/app-colors.page194
-rw-r--r--help/C/app-cursor.page72
-rw-r--r--help/C/app-fonts.page140
-rw-r--r--help/C/app-fullscreen.page70
-rw-r--r--help/C/app-terminal-sizes.page99
-rw-r--r--help/C/app-zoom.page64
-rw-r--r--help/C/figures/gnome-terminal-icon.pngbin0 -> 859 bytes
-rw-r--r--help/C/figures/gnome-terminal.pngbin0 -> 9334 bytes
-rw-r--r--help/C/figures/keyboard-key-search.svg36
-rw-r--r--help/C/gs-execute-commands.page62
-rw-r--r--help/C/gs-tabs.page176
-rw-r--r--help/C/index.page63
-rw-r--r--help/C/introduction.page48
-rw-r--r--help/C/legal.xml21
-rw-r--r--help/C/overview.page101
-rw-r--r--help/C/pref-bell.page66
-rw-r--r--help/C/pref-custom-command.page82
-rw-r--r--help/C/pref-custom-exit.page78
-rw-r--r--help/C/pref-keyboard-access.page101
-rw-r--r--help/C/pref-login-shell.page99
-rw-r--r--help/C/pref-menubar.page75
-rw-r--r--help/C/pref-profile-char-width.page55
-rw-r--r--help/C/pref-profile-encoding.page58
-rw-r--r--help/C/pref-profiles.page293
-rw-r--r--help/C/pref-scrolling.page179
-rw-r--r--help/C/pref-tab-window.page75
-rw-r--r--help/C/pref-user-input.page48
-rw-r--r--help/C/pref.page32
-rw-r--r--help/C/prob-reset.page76
-rw-r--r--help/C/txt-copy-paste.page67
-rw-r--r--help/C/txt-links.page107
-rw-r--r--help/C/txt-search.page87
-rw-r--r--help/C/txt-select-text.page56
34 files changed, 3190 insertions, 0 deletions
diff --git a/help/C/adv-keyboard-shortcuts.page b/help/C/adv-keyboard-shortcuts.page
new file mode 100644
index 0000000..5243be4
--- /dev/null
+++ b/help/C/adv-keyboard-shortcuts.page
@@ -0,0 +1,410 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ xmlns:ui="http://projectmallard.org/ui/1.0"
+ type="task"
+ id="adv-keyboard-shortcuts">
+
+ <info>
+ <revision version="0.1" date="2013-02-17" status="candidate"/>
+ <revision version="0.2" pkgversion="3.34" date="2020-01-04" status="candidate"/>
+ <link type="guide" xref="index#advanced"/>
+ <link type="guide" xref="pref#global"/>
+ <link type="seealso" xref="pref-keyboard-access" />
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="author copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>View and edit keyboard shortcuts.</desc>
+ </info>
+
+ <title>Keyboard shortcuts</title>
+
+ <p>Keyboard shortcuts are combinations of keys that allow you to perform
+ actions, such as opening the settings dialog or accessing a feature inside
+ <app>Terminal</app> quickly. These shortcuts can be modified to suit your
+ preferences.</p>
+
+ <p>To change a keyboard shortcut:</p>
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select <gui>Shortcuts</gui>.</p>
+ </item>
+ <item>
+ <p>Make sure <gui style="checkbox">Enable shortcuts</gui> is selected.</p>
+ </item>
+ <item>
+ <p>Select the shortcut that you wish to edit by clicking on it.</p>
+ </item>
+ <item>
+ <p>Once the shortcut is selected, click on the shortcut key combination
+ to edit it.</p>
+ </item>
+ <item>
+ <p>Press your desired shortcut key combination as you would enter it to
+ use it. The keys that you can use include <key>Alt</key>,
+ <key>Alt Gr</key>, <key>Ctrl</key>, <key>Shift</key>, <key>Super</key>,
+ number and letter keys.</p>
+ <note>
+ <p>Mnemonic key combinations, such as <keyseq><key>Alt</key>
+ <key>F</key></keyseq> will not work.</p>
+ </note>
+ </item>
+ <item>
+ <p>Once you have entered your new shortcut, it will automatically be
+ saved and you should see it in the list next to the corresponding
+ action.</p>
+ </item>
+ </steps>
+
+ <note style="tip">
+ <p>To disable a shortcut, edit it and press the <key>Backspace</key>
+ instead of the new shortcut.</p>
+ </note>
+
+ <section id="file-shortcuts">
+ <title><gui style="menu">File</gui> shortcuts</title>
+
+ <p>The default shortcuts for options in this section are:</p>
+
+ <table rules="rows" frame="top bottom" ui:expanded="true">
+ <thead>
+ <tr>
+ <td><p>Action</p></td>
+ <td><p>Keyboard Shortcut</p></td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><p>New Tab</p></td>
+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>T</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>New Window</p></td>
+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>N</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Close Tab</p></td>
+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>W</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Close Window</p></td>
+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Q</key></keyseq></p></td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+
+ <section id="edit-shortcuts">
+ <title><gui style="menu">Edit</gui> shortcuts</title>
+
+ <p>The default shortcuts for options in this section are:</p>
+
+ <table rules="rows" frame="top bottom" ui:expanded="false">
+ <thead>
+ <tr>
+ <td><p>Action</p></td>
+ <td><p>Keyboard Shortcut</p></td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><p>Copy</p></td>
+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>C</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Paste</p></td>
+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>V</key></keyseq></p></td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+
+ <section id="view-shortcuts">
+ <title><gui style="menu">View</gui> shortcuts</title>
+
+ <p>The default shortcuts for options in this section are:</p>
+
+ <table rules="rows" frame="top bottom" ui:expanded="false">
+ <thead>
+ <tr>
+ <td><p>Action</p></td>
+ <td><p>Keyboard Shortcut</p></td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><p>Full Screen</p></td>
+ <td><p><key>F11</key></p></td>
+ </tr>
+ <tr>
+ <td><p>Zoom In</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>+</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Zoom Out</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>-</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Normal Size</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>0</key></keyseq></p></td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+
+ <section id="find-shortcuts">
+ <title><gui style="menu">Search</gui> shortcuts</title>
+
+ <p>The default shortcuts for options in this section are:</p>
+
+ <table rules="rows" frame="top bottom" ui:expanded="false">
+ <thead>
+ <tr>
+ <td><p>Action</p></td>
+ <td><p>Keyboard Shortcut</p></td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><p>Find</p></td>
+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>F</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Find Next</p></td>
+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>G</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Find Previous</p></td>
+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>H</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Clear Highlight</p></td>
+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>J</key></keyseq></p></td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+
+ <section id="tab-shortcuts">
+ <title>Tab shortcuts</title>
+
+ <p>The default shortcuts for options in this section are:</p>
+
+ <table rules="rows" frame="top bottom" ui:expanded="false">
+ <thead>
+ <tr>
+ <td><p>Action</p></td>
+ <td><p>Keyboard Shortcut</p></td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><p>Switch to Previous Tab</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>Page Up</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Switch to Next Tab</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>Page Down</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Move Tab to the Left</p></td>
+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Page Up</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Move Tab to the Right</p></td>
+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Page Down</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Switch to Tab 1</p></td>
+ <td><p><keyseq><key>Alt</key><key>1</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Switch to Tab 2</p></td>
+ <td><p><keyseq><key>Alt</key><key>2</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Switch to Tab 3</p></td>
+ <td><p><keyseq><key>Alt</key><key>3</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Switch to Tab 4</p></td>
+ <td><p><keyseq><key>Alt</key><key>4</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Switch to Tab 5</p></td>
+ <td><p><keyseq><key>Alt</key><key>5</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Switch to Tab 6</p></td>
+ <td><p><keyseq><key>Alt</key><key>6</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Switch to Tab 7</p></td>
+ <td><p><keyseq><key>Alt</key><key>7</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Switch to Tab 8</p></td>
+ <td><p><keyseq><key>Alt</key><key>8</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Switch to Tab 9</p></td>
+ <td><p><keyseq><key>Alt</key><key>9</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Switch to Tab 10</p></td>
+ <td><p><keyseq><key>Alt</key><key>0</key></keyseq></p></td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+
+ <section id="other-shortcuts">
+ <title>Other</title>
+
+ <p>There are also some shortcuts that cannot be edited:</p>
+
+ <table rules="rows" frame="top bottom" ui:expanded="false">
+ <thead>
+ <tr>
+ <td><p>Action</p></td>
+ <td><p>Keyboard Shortcut</p></td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><p>Scroll up by one line</p></td>
+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Up</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Scroll down by one line</p></td>
+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Down</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Scroll up by one page</p></td>
+ <td><p><keyseq><key>Shift</key><key>Page Up</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Scroll down by one page</p></td>
+ <td><p><keyseq><key>Shift</key><key>Page Down</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Scroll to the top</p></td>
+ <td><p><keyseq><key>Shift</key><key>Home</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Scroll to the bottom</p></td>
+ <td><p><keyseq><key>Shift</key><key>End</key></keyseq></p></td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+
+ <section id="bash-shortcuts">
+ <title>Bash shortcuts</title>
+
+ <p>These are <app>Bash</app> shortcuts. <app>Bash</app> is usually the
+ default shell.</p>
+
+ <comment>
+ <cite href="mailto:kittykat3756@gmail.com">Kat</cite>
+ <p>TODO: move this section to a new page or link to info:readline
+ instead.</p>
+ </comment>
+ <p><app>Bash</app> shell specific keyboard shortcuts are:</p>
+
+ <table rules="rows" frame="top bottom" ui:expanded="false">
+ <thead>
+ <tr>
+ <td><p>Action</p></td>
+ <td><p>Keyboard shortcut</p></td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><p>Erase a word</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>W</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Erase a line</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>U</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Move to the start of the line</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>A</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Move to the end of the line</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>E</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Move back one character</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>B</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Move back one word</p></td>
+ <td><p><keyseq><key>Alt</key><key>B</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Move forward one character</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>F</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Move forward one word</p></td>
+ <td><p><keyseq><key>Alt</key><key>F</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Delete from the cursor to the beginning of the line</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>u</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Delete from the cursor to the end of the line</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>K</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Delete from the cursor to the start of the word</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>W</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Delete previous word</p></td>
+ <td><p><keyseq><key>Alt</key><key>Backspace</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Paste text from the clipboard</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>Y</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Clear the screen leaving the current line at the top of the
+ screen</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>L</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Reverse incremental search of history</p></td>
+ <td><p><keyseq><key>Ctrl</key><key>R</key></keyseq></p></td>
+ </tr>
+ <tr>
+ <td><p>Reverse non-incremental search of history</p></td>
+ <td><p><keyseq><key>Alt</key><key>P</key></keyseq></p></td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+
+</page>
diff --git a/help/C/app-colors.page b/help/C/app-colors.page
new file mode 100644
index 0000000..9efe395
--- /dev/null
+++ b/help/C/app-colors.page
@@ -0,0 +1,194 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="topic"
+ id="app-colors">
+
+ <info>
+ <revision version="0.1" date="2013-03-02" status="candidate"/>
+ <revision pkgversion="3.34" version="0.2" date="2020-01-04" status="candidate"/>
+ <link type="guide" xref="index#appearance"/>
+ <link type="guide" xref="pref#profile"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="author copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Change colors and backgrounds.</desc>
+
+ </info>
+
+ <title>Color schemes</title>
+
+ <p>If you do not like the default <app>Terminal</app> theme, you may want to
+ change the colors that are used for the text and background. You can use
+ colors from your theme, select one of the presets or use a custom scheme.</p>
+
+ <section id="system-theme">
+ <title>Use colors from your system theme</title>
+
+ <p>To use colors from the system theme:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Colors</gui>.</p>
+ </item>
+ <item>
+ <p>Check <gui style="checkbox">Use colors from system theme</gui>. The
+ changes will be applied automatically.</p>
+ </item>
+ </steps>
+
+ </section>
+
+ <section id="built-in-scheme">
+ <title>Built-in schemes</title>
+
+ <p>You can choose one of the built-in color schemes: <gui>Black on light
+ yellow</gui>, <gui>Black on white</gui>, <gui>Gray on black</gui>,
+ <gui>Green on black</gui>, <gui>White on black</gui>, <gui>Tango
+ light</gui>, <gui>Tango dark</gui>, <gui>Solarized light</gui>,
+ <gui>Solarized dark</gui>. To set any of the built-in schemes:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Colors</gui>.</p>
+ </item>
+ <item>
+ <p>Make sure that <gui style="checkbox">Use colors from system
+ theme</gui> is unchecked. Choose the desired color scheme from
+ <gui>Built-in schemes</gui>. Color scheme choices are applied
+ automatically.</p>
+ <note>
+ <p>Applications can choose to use a color from the palette rather
+ than the specified bold color.</p>
+ </note>
+ </item>
+ </steps>
+
+ </section>
+
+ <section id="custom-scheme">
+ <title>Custom color scheme</title>
+
+ <p>You can use custom colors for the text and background in
+ <app>Terminal</app>:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Colors</gui>.</p>
+ </item>
+ <item>
+ <p>Make sure that <gui style="checkbox">Use colors from system
+ theme</gui> is unchecked. Select <gui>Custom</gui> from the
+ <gui>Built-in schemes</gui> drop-down list.</p>
+ </item>
+ <item>
+ <p>Click on the color you would like to change.</p>
+ </item>
+ <item>
+ <p>Choose your desired color from the color sample and click
+ <gui style="button">Select</gui>.</p>
+ <p>You can choose the desired color in the following ways:</p>
+ <list>
+ <item>
+ <p>Input the hexadecimal color code in the input box.</p>
+ </item>
+ <item>
+ <p>Drag the slider on the left to adjust the colors and click on
+ the desired color in the color selection area.</p>
+ </item>
+ </list>
+ <p>Your changes will be saved automatically.</p>
+ </item>
+ </steps>
+
+ <note style="tip">
+ <p>You may also alter a color when you have chosen a built-in scheme by
+ clicking on the color sample block. Once changed, your selection in the
+ built-in scheme menu will change to <gui>Custom</gui>.</p>
+ </note>
+
+ <note style="tip">
+ <p>Traditionally terminal emulators offered a 16 color palette, this is
+ what you can alter here. <app>Terminal</app> supports an extended set of
+ 256 colors, but the additional 240 colors cannot be edited here.</p>
+
+ <p><app>Terminal</app> even offers direct access to over 16 million
+ colors, this is called “true color” mode.</p>
+
+ <p>If the changes you make to the palette do not seem to have an effect,
+ presumably the contents you see consist of such extended palette colors
+ or true colors, rather than the 16 base colors.</p>
+ </note>
+
+ </section>
+
+ <section id="bold-is-bright">
+ <title>Bright colors for bold text</title>
+
+ <p>Traditionally terminals didn't clearly separate bold font weight from
+ intense colors, often both of them were enabled together. Recent
+ improvements, such as the introduction of true color support, and certain
+ color schemes (e.g. Solarized) made it desirable to separate the two
+ concepts, that is, make the brightness independent from the font weight.</p>
+
+ <p>In order to choose your preferred behavior:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Colors</gui>.</p>
+ </item>
+ <item>
+ <p>Disable <gui>Show bold text in bright colors</gui> for the new
+ default behavior, the complete separation of color intensity and font
+ weight; or enable this option for improved backward compatibility.</p>
+ </item>
+ </steps>
+ </section>
+
+</page>
diff --git a/help/C/app-cursor.page b/help/C/app-cursor.page
new file mode 100644
index 0000000..16aec47
--- /dev/null
+++ b/help/C/app-cursor.page
@@ -0,0 +1,72 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ xmlns:its="http://www.w3.org/2005/11/its"
+ type="task"
+ id="app-cursor">
+
+ <info>
+ <revision version="0.1" date="2013-02-17" status="candidate"/>
+ <revision pkgversion="3.34" version="0.2" date="2020-01-04" status="candidate"/>
+ <link type="guide" xref="index#appearance"/>
+ <link type="guide" xref="pref#profile"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="author copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Select different cursor style.</desc>
+
+ </info>
+
+ <title>Change cursor</title>
+
+ <p><app>Terminal</app> has three cursors from which to choose. To select your
+ preferred cursor:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Text</gui>.</p>
+ </item>
+ <item>
+ <p>Choose your desired cursor shape from the drop down list next to
+ <gui>Cursor shape</gui>. You can choose from the following options:</p>
+ <terms>
+ <item>
+ <title its:translate="no">█</title>
+ <p><gui>Block</gui></p>
+ </item>
+ <item>
+ <title its:translate="no">▏</title>
+ <p><gui>I-Beam</gui></p>
+ </item>
+ <item>
+ <title its:translate="no">▁</title>
+ <p><gui>Underline</gui></p>
+ </item>
+ </terms>
+ <p>Upon selection of the cursor, your choice is saved automatically.</p>
+ </item>
+ </steps>
+
+</page>
diff --git a/help/C/app-fonts.page b/help/C/app-fonts.page
new file mode 100644
index 0000000..1efce17
--- /dev/null
+++ b/help/C/app-fonts.page
@@ -0,0 +1,140 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="task"
+ id="app-fonts">
+
+ <info>
+ <revision version="0.1" date="2013-02-22" status="candidate"/>
+ <revision pkgversion="3.34" version="0.2" date="2020-01-04" status="candidate"/>
+ <link type="guide" xref="index#appearance"/>
+ <link type="guide" xref="pref#profile"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Use system fonts or choose a custom font for your terminal.</desc>
+
+ </info>
+
+ <title>Change font and style</title>
+
+ <p>When you work with a lot of <app>Terminal</app> text, you may want to
+ change the default font to your preference. You have the following
+ options:</p>
+
+ <section id="system-font">
+ <title>System fixed width font</title>
+
+ <p>To use system default fonts:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Text</gui>.</p>
+ </item>
+ <item>
+ <p>Unselect <gui style="checkbox">Custom font</gui>.</p>
+ </item>
+ </steps>
+
+ </section>
+
+ <section id="custom-font">
+ <title>Set a custom font</title>
+
+ <p>To set a custom font and size:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Text</gui>.</p>
+ </item>
+ <item>
+ <p>Select <gui style="checkbox">Custom font</gui>.</p>
+ </item>
+ <item>
+ <p>Click on the button next to <gui style="checkbox">Custom font</gui>.</p>
+ </item>
+ <item>
+ <p>Type the name of your desired font into the search field or browse the
+ list of fonts.</p>
+ </item>
+ <item>
+ <p>Drag the slider that is below the font list to set the font size.
+ Alternatively, you can type in the font size into the field next to the
+ slider, or click on <gui style="button">+</gui> to increase font size or
+ <gui style="button">-</gui> to decrease selected font size.</p>
+ </item>
+ <item>
+ <p>Click <gui style="button">Select</gui> to apply your changes. To
+ discard changes and go back to previous dialog, click
+ <gui style="button">Cancel</gui>.</p>
+ </item>
+ </steps>
+
+ </section>
+
+ <section id="cell-spacing">
+ <title>Line spacing and character spacing</title>
+
+ <p><app>Terminal</app> allows you to pull its characters apart for improved
+ readability. Line spacing and character spacing can be adjusted from 1.0
+ (the regular look) to 2.0 (“double spacing”), including fractional values
+ in between.</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Text</gui>.</p>
+ </item>
+ <item>
+ <p>Go to the <gui>Cell spacing</gui> setting.</p>
+ </item>
+ <item>
+ <p>To set the horizontal character spacing, adjust the multiplier number
+ in front of <gui>width</gui>.</p>
+ </item>
+ <item>
+ <p>To set the line spacing, adjust the multiplier number in front of
+ <gui>height</gui>.</p>
+ </item>
+ </steps>
+
+ </section>
+
+</page>
diff --git a/help/C/app-fullscreen.page b/help/C/app-fullscreen.page
new file mode 100644
index 0000000..4c5c108
--- /dev/null
+++ b/help/C/app-fullscreen.page
@@ -0,0 +1,70 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="app-fullscreen">
+
+ <info>
+ <revision version="0.1" date="2013-02-17" status="candidate"/>
+ <revision pkgversion="3.34" version="0.2" date="2020-01-04" status="candidate"/>
+ <link type="guide" xref="index#appearance"/>
+ <link type="seealso" xref="pref-menubar"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Enable fullscreen mode.</desc>
+ </info>
+
+ <title>Fullscreen session</title>
+
+ <p>Fullscreen mode allows <app>Terminal</app> to use the entire screen.</p>
+
+ <p>This mode is useful if you have a device with limited screen space and
+ intend to work in <app>Terminal</app> for a long duration, or are working with
+ long lines of terminal output. It temporarily hides the window
+ decoration, allowing you to view more <link xref="pref-scrolling">scrollback
+ lines</link> on the screen.</p>
+
+ <p>To enable fullscreen mode:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Full Screen</gui>, or press <key>F11</key>.</p>
+ </item>
+ </steps>
+
+ <note style="important">
+ <p>The menubar will still be visible in fullscreen mode unless you have
+ hidden it.</p>
+ </note>
+
+ <note style="tip">
+ <p>If you have more than one <app>Terminal</app> tab open, the tab bar will
+ be visible in the fullscreen mode.</p>
+ </note>
+
+ <p>To disable fullscreen mode:</p>
+
+ <steps>
+ <item>
+ <p>Right click and select <gui style="menuitem">Leave Full Screen</gui>.
+ Alternatively, press <key>F11</key>.</p>
+ </item>
+ </steps>
+
+</page>
diff --git a/help/C/app-terminal-sizes.page b/help/C/app-terminal-sizes.page
new file mode 100644
index 0000000..2521459
--- /dev/null
+++ b/help/C/app-terminal-sizes.page
@@ -0,0 +1,99 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="task"
+ id="app-terminal-sizes">
+
+ <info>
+ <revision version="0.1" date="2013-02-25" status="candidate"/>
+ <revision version="0.2" pkgversion="3.34" date="2020-01-04" status="candidate"/>
+ <link type="guide" xref="index#appearance"/>
+ <link type="guide" xref="adv-keyboard-shortcuts"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Change the <app>Terminal</app> window size.</desc>
+
+ </info>
+
+ <title><app>Terminal</app> sizes</title>
+
+ <p>If 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, you may require <app>Terminal</app> windows to be of a particular
+ size.</p>
+
+ <p>You can change the <app>Terminal</app> window size to some preset
+ values:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Advanced</gui>.</p>
+ </item>
+ <item>
+ <p>Choose one of the following options:</p>
+ <list>
+ <item>
+ <p><gui style="menuitem">80×24</gui></p>
+ </item>
+ <item>
+ <p><gui style="menuitem">80×43</gui></p>
+ </item>
+ <item>
+ <p><gui style="menuitem">132×24</gui></p>
+ </item>
+ <item>
+ <p><gui style="menuitem">132×43</gui></p>
+ </item>
+ </list>
+ </item>
+ </steps>
+
+ <note style="tip">
+ <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 pressing <key>1</key>
+ to switch the <app>Terminal</app> window to size <gui>80×24</gui> and so
+ on.</p>
+ </note>
+
+ <p>If you require custom size <app>Terminal</app> windows, you can also set
+ the default window size according to your requirements:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Text</gui>.</p>
+ </item>
+ <item>
+ <p>Set <gui>Initial terminal size</gui> by typing the desired number of columns and
+ rows in the corresponding input boxes. You can also click
+ <gui style="button">+</gui> to increase or <gui style="button">-</gui> to
+ decrease the size.</p>
+ </item>
+ </steps>
+
+</page>
diff --git a/help/C/app-zoom.page b/help/C/app-zoom.page
new file mode 100644
index 0000000..b8be1fd
--- /dev/null
+++ b/help/C/app-zoom.page
@@ -0,0 +1,64 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="task"
+ id="app-zoom">
+
+ <info>
+ <revision version="0.1" date="2013-02-24" status="candidate"/>
+ <revision version="0.2" pkgversion="3.34" date="2020-01-04" status="review"/>
+ <link type="guide" xref="index#appearance"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Increase or decrease text size.</desc>
+
+ </info>
+
+ <title>Zoom in and zoom out</title>
+
+ <p>To increase <app>Terminal</app> text size:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and press
+ <gui style="button">+</gui>, or press
+ <keyseq><key>Ctrl</key><key>+</key></keyseq>.</p>
+ </item>
+ </steps>
+
+ <p>To decrease <app>Terminal</app> text size:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and press
+ <gui style="button">-</gui>, or press
+ <keyseq><key>Ctrl</key><key>-</key></keyseq>.</p>
+ </item>
+ </steps>
+
+ <p>To restore <app>Terminal</app> text to default size:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and press
+ <gui style="button">100%</gui>, or press
+ <keyseq><key>Ctrl</key><key>0</key></keyseq>.</p>
+ </item>
+ </steps>
+
+</page>
diff --git a/help/C/figures/gnome-terminal-icon.png b/help/C/figures/gnome-terminal-icon.png
new file mode 100644
index 0000000..ca094b4
--- /dev/null
+++ b/help/C/figures/gnome-terminal-icon.png
Binary files differ
diff --git a/help/C/figures/gnome-terminal.png b/help/C/figures/gnome-terminal.png
new file mode 100644
index 0000000..4c954a2
--- /dev/null
+++ b/help/C/figures/gnome-terminal.png
Binary files differ
diff --git a/help/C/figures/keyboard-key-search.svg b/help/C/figures/keyboard-key-search.svg
new file mode 100644
index 0000000..d309bfe
--- /dev/null
+++ b/help/C/figures/keyboard-key-search.svg
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+ xmlns:dc="http://purl.org/dc/elements/1.1/"
+ xmlns:cc="http://creativecommons.org/ns#"
+ xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ style="font-style:normal;font-weight:normal;font-size:12px;font-family:Dialog;color-interpolation:auto;fill:#000000;fill-opacity:1;stroke:#000000;stroke-width:1;stroke-linecap:square;stroke-linejoin:miter;stroke-miterlimit:10;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto"
+ height="15"
+ width="14.999999"
+ version="1.1"
+ id="svg2"
+ font-size="12"
+ font-style="normal"
+ font-weight="normal"
+ stroke-miterlimit="10">
+ <metadata
+ id="metadata13">
+ <rdf:RDF>
+ <cc:Work
+ rdf:about="">
+ <dc:format>image/svg+xml</dc:format>
+ <dc:type
+ rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+ <dc:title></dc:title>
+ </cc:Work>
+ </rdf:RDF>
+ </metadata>
+ <!--Unicode Character 'EARTH GLOBE EUROPE-AFRICA' (U+1F30D)-->
+ <defs
+ id="genericDefs" />
+ <path
+ id="path4182"
+ d="m 1.4722842,1.4722841 c -1.96304554,1.9630457 -1.96304566,5.17207 0,7.1351158 1.702736,1.7027361 4.340992,1.9217971 6.2923471,0.6706426 l 5.3992397,5.6817865 c 0.32949,0.329489 2.125447,-1.466468 1.795957,-1.795958 L 9.2926566,7.7370261 C 10.524766,5.7883395 10.3024,3.1672841 8.6073999,1.4722842 6.6443542,-0.49076139 3.4353298,-0.49076139 1.4722842,1.4722841 Z m 1.2584695,1.2584695 c 1.2825439,-1.2825439 3.3356326,-1.282544 4.6181768,1e-7 1.2825438,1.2825438 1.2825439,3.3356328 0,4.6181767 -1.282544,1.2825439 -3.3356329,1.282544 -4.6181768,10e-8 -1.2825442,-1.2825441 -1.282544,-3.335633 0,-4.6181769 z"
+ style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:medium;line-height:normal;font-family:Dialog;text-indent:0;text-align:start;text-decoration:none;text-decoration-line:none;text-decoration-style:solid;text-decoration-color:#000000;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:start;white-space:normal;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1.51450491;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate" />
+</svg>
diff --git a/help/C/gs-execute-commands.page b/help/C/gs-execute-commands.page
new file mode 100644
index 0000000..5c464c7
--- /dev/null
+++ b/help/C/gs-execute-commands.page
@@ -0,0 +1,62 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ xmlns:its="http://www.w3.org/2005/11/its"
+ type="guide"
+ id="gs-execute-commands">
+
+ <info>
+ <link type="guide" xref="index#getting-started"/>
+ <link type="seealso" xref="txt-copy-paste"/>
+ <link type="seealso" xref="overview"/>
+ <revision pkgversion="3.8" date="2013-02-25" status="candidate"/>
+ <revision pkgversion="3.12" date="2014-03-24" status="candidate"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email its:translate="no">sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email its:translate="no">kittykat3756@gmail.com</email>
+ <years>2013–2014</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email its:translate="no">mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Launch programs or run commands using <app>Terminal</app>.</desc>
+ </info>
+
+ <title>Execute a command</title>
+
+ <p>Any input entered in the <app>Terminal</app> to be executed is referred to
+ as a <em>command</em>. You can run both command line and graphical user
+ interface (GUI) programs from the terminal.</p>
+
+ <p>To execute commands:</p>
+
+ <steps>
+ <item>
+ <p>Type the command in the <app>Terminal</app> prompt.</p>
+ </item>
+ <item>
+ <p>Press <key>Enter</key> to execute it.</p>
+ </item>
+ </steps>
+
+ <p>If you have a program that ends abruptly without any warning or error,
+ you may want to run it in <app>Terminal</app>. This will allow the program to
+ output any error or debugging messages to the <app>Terminal</app> window. This
+ information can be helpful when filing a bug report.</p>
+
+ <note style="tip">
+ <p>Read about the
+ <link href="https://www.gnu.org/software/bash/manual/">Bash shell</link>
+ for more information on what you can do in a terminal.</p>
+ </note>
+
+</page>
diff --git a/help/C/gs-tabs.page b/help/C/gs-tabs.page
new file mode 100644
index 0000000..43ad6eb
--- /dev/null
+++ b/help/C/gs-tabs.page
@@ -0,0 +1,176 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ xmlns:its="http://www.w3.org/2005/11/its"
+ type="guide"
+ id="gs-tabs">
+
+ <info>
+ <link type="guide" xref="index#getting-started"/>
+ <revision pkgversion="3.8" date="2013-02-17" status="candidate"/>
+ <revision pkgversion="3.12" date="2014-03-07" status="candidate"/>
+ <revision pkgversion="3.34" date="2020-01-04" status="candidate"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email its:translate="no">sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email its:translate="no">kittykat3756@gmail.com</email>
+ <years>2013–2014</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email its:translate="no">mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Enable, add, remove and reorder <app>Terminal</app> tabs.</desc>
+ </info>
+
+ <title>Use tabs</title>
+
+ <p>The tab bar is shown at the top a <app>Terminal</app> window that has
+ multiple tabs open (it looks like a row of buttons). Click on a tab to switch
+ to it. You can open multiple tabs to manage your work in <app>Terminal</app>.
+ This will allow you to multi-task with activities such as running programs,
+ browsing directories and editing text files in a single <app>Terminal</app>
+ window.</p>
+
+ <section id="add-tab">
+ <title>Open a new tab</title>
+
+ <p>To open a new tab inside your current <app>Terminal</app> window:</p>
+ <steps>
+ <item>
+ <p>Press
+ <keyseq><key>Shift</key><key>Ctrl</key><key>T</key></keyseq>.</p>
+ </item>
+ </steps>
+
+ </section>
+
+<!-- TODO: doesn't work, see bug 720693
+ <section id="rename-tab">
+ <title>Rename a tab</title>
+
+ <p>Each tab has an automatically assigned title. You can rename the tabs
+ individually:</p>
+
+ <steps>
+ <item>
+ <p>Select <guiseq><gui style="menu">Terminal</gui>
+ <gui style="menuitem">Set Title…</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>Enter the desired <gui>Title</gui> that you wish to use for the tab.
+ This will overwrite any titles that would be set by terminal commands.
+ </p>
+ <note>
+ <p>It is not possible to set back the automatically set title once it
+ has been set for a tab. To see the title, you need to allow terminal
+ command titles to be shown in the <gui style="menuitem">Profile
+ Preferences</gui>.</p>
+ </note>
+ </item>
+ <item>
+ <p>Click <gui style="button">OK</gui>.</p>
+ </item>
+ </steps>
+ </section>-->
+
+ <section id="close-tab">
+ <title>Remove a tab</title>
+
+ <p>To close an existing tab inside your current <app>Terminal</app>
+ window:</p>
+
+ <steps>
+ <item>
+ <p>Press <keyseq><key>Shift</key><key>Ctrl</key><key>W</key></keyseq>.</p>
+ </item>
+ </steps>
+
+ <p>Alternatively, you can click on the <gui style="button">×</gui> in the
+ top right corner of the tab or right click on the tab and select
+ <gui style="menuitem">Close Terminal</gui>.</p>
+
+ </section>
+
+ <section id="reorder-tab">
+ <title>Reorder tabs</title>
+
+ <p>To change the ordering of tabs in a window:</p>
+ <steps>
+ <item>
+ <p>Click and hold the left mouse button on the tab.</p>
+ </item>
+ <item>
+ <p>Drag the tab to the desired position among the other tabs.</p>
+ </item>
+ <item>
+ <p>Release the mouse button.</p>
+ </item>
+ </steps>
+
+ <p>The tab will be placed in the position closest to where you released the
+ tab, immediately beside other open tabs.</p>
+
+ <p>Alternatively, you can reorder a tab by right clicking on a tab and
+ selecting <gui style="menuitem">Move Terminal Left</gui> to move the tab to
+ the left or <gui style="menuitem">Move Terminal Right</gui> to move the tab
+ to the right. This will reorder the tab position by moving it one place at
+ a time.</p>
+
+ </section>
+
+ <!--
+ <section id="move-tab-another-window">
+ <title>Move a tab to another <app>Terminal</app> window</title>
+
+ <p>If you want to move a tab from one window to another:</p>
+ <steps>
+ <item>
+ <p>Click and hold the left mouse button on the tab.</p>
+ </item>
+ <item>
+ <p>Drag the tab to the new window.</p>
+ </item>
+ <item>
+ <p>Place it beside other tabs in the new window.</p>
+ </item>
+ <item>
+ <p>Release the mouse button.</p>
+ </item>
+ </steps>
+
+ <note style="tip">
+ <p>You can move a tab from one window to another by dragging the tab to
+ the <gui>Activities</gui> hot-corner of the <gui>GNOME Shell</gui>. This
+ will reveal each of the open <app>Terminal</app> windows. You can release
+ the tab that you are holding over the desired <app>Terminal</app>
+ window.</p>
+ </note>
+ </section>
+
+ <section id="move-tab-create-window">
+ <title>Move a tab to create a new <app>Terminal</app> window</title>
+
+ <p>To create a new window from an existing tab:</p>
+ <steps>
+ <item>
+ <p>Click and hold the left mouse button on the tab.</p>
+ </item>
+ <item>
+ <p>Drag the tab out of the current <app>Terminal</app> window.</p>
+ </item>
+ <item>
+ <p>Release the mouse button.</p>
+ </item>
+ </steps>
+ </section>
+ -->
+
+</page>
diff --git a/help/C/index.page b/help/C/index.page
new file mode 100644
index 0000000..6e8d753
--- /dev/null
+++ b/help/C/index.page
@@ -0,0 +1,63 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ xmlns:its="http://www.w3.org/2005/11/its"
+ type="guide" style="2column task"
+ id="index">
+
+ <info>
+ <revision version="0.1" date="2013-03-02" status="candidate"/>
+ <title type="link">Terminal</title>
+ <title type="text">Terminal</title>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email its:translate="no">sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="editor">
+ <name>Ekaterina Gerasimova</name>
+ <email its:translate="no">kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+ <credit type="editor">
+ <name>Jim Campbell</name>
+ <email its:translate="no">jwcampbell@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Set up and use the highly customizable GNOME terminal
+ emulator.</desc>
+ </info>
+
+ <title>
+ <media type="image" mime="image/png" its:translate="no" src="figures/gnome-terminal-icon.png">
+ </media>
+ Terminal Help
+ </title>
+
+ <section id="getting-started" style="2column">
+ <title>Getting Started</title>
+ </section>
+
+ <section id="textoutput" style="2column">
+ <title>Working With Text</title>
+ </section>
+
+ <section id="appearance" style="2column">
+ <title>Customize Appearance</title>
+ </section>
+
+ <section id="preferences" style="2column">
+ <title>Customize Behavior</title>
+ </section>
+
+ <section id="advanced" style="2column">
+ <title>Advanced Settings</title>
+ </section>
+
+ <section id="troubleshooting" style="2column">
+ <title>Troubleshooting</title>
+ </section>
+
+</page>
diff --git a/help/C/introduction.page b/help/C/introduction.page
new file mode 100644
index 0000000..3474359
--- /dev/null
+++ b/help/C/introduction.page
@@ -0,0 +1,48 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ xmlns:its="http://www.w3.org/2005/11/its"
+ type="guide"
+ id="introduction">
+
+ <info>
+ <revision version="0.1" date="2013-01-08" status="candidate"/>
+ <link type="guide" xref="index"/>
+ <link type="seealso" xref="overview"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email its:translate="no">sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email its:translate="no">kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email its:translate="no">mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Learn about the GNOME terminal emulator.</desc>
+ </info>
+
+ <title>Introduction</title>
+
+ <p><app>Terminal</app> is a terminal emulator application for accessing a
+ UNIX shell environment which can be used to run programs available on your
+ system.</p>
+
+ <p><app>Terminal</app> supports escape sequences that control cursor position
+ and colors.</p>
+
+ <figure>
+ <title>GNOME Terminal</title>
+ <desc>Screenshot of GNOME <app>Terminal</app></desc>
+ <media type="image" src="figures/gnome-terminal.png" width="668">
+ </media>
+ </figure>
+
+</page>
diff --git a/help/C/legal.xml b/help/C/legal.xml
new file mode 100644
index 0000000..14bbfc9
--- /dev/null
+++ b/help/C/legal.xml
@@ -0,0 +1,21 @@
+<license xmlns="http://projectmallard.org/1.0/">
+
+ <p>This work is licensed under a
+ <link href="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons
+ Attribution-Share Alike 3.0 Unported License</link> and a
+ <link href="http://www.gnu.org/licenses/">GNU General Public License version
+ 3</link>. It may be redistributed and/or modified under either license.</p>
+
+ <p>GPL 3 statement:</p>
+ <p>This work is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License version 3 as
+ published by the Free Software Foundation.</p>
+
+ <p>This work is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.</p>
+
+ <p>You should have received a copy of the GNU General Public License
+ along with this program. If not, see http://www.gnu.org/licenses/.</p>
+</license>
diff --git a/help/C/overview.page b/help/C/overview.page
new file mode 100644
index 0000000..ab5046e
--- /dev/null
+++ b/help/C/overview.page
@@ -0,0 +1,101 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide" style="task"
+ id="overview">
+ <info>
+ <revision version="0.1" date="2013-01-10" status="draft"/>
+ <link type="guide" xref="index"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>What is a terminal?</desc>
+ </info>
+
+ <title>Overview of a terminal</title>
+
+ <p><app>Terminal</app> is a terminal program for <gui>GNOME</gui>. The
+ following terms and their descriptions will help you to be familiar with
+ <app>Terminal</app> and its capabilities.</p>
+
+ <terms>
+ <item>
+ <title>A terminal</title>
+ <p>A terminal is a text input point in a computer that is also called
+ the Command Line Interface (CLI).</p>
+ </item>
+ <item>
+ <title>Physical terminals</title>
+ <p>IBM 3270, VT100 and many others are hardware terminals that are no
+ longer produced as physical devices. To emulate these terminals, there are
+ terminal emulators.</p>
+ </item>
+ <item>
+ <title>Terminal emulators</title>
+ <p>Emulation is the ability of a computer program to imitate another
+ program or device.</p>
+
+ <p>A terminal emulator, also called tty, is a software program that emulates
+ a video terminal in modern computers that use graphical user interfaces
+ and provide interactive access to applications that run only in the
+ command line environments. These applications may be running either on the
+ same machine or on a different one via <app>telnet</app>, <app>ssh</app>,
+ or <app>dial-up</app>.</p>
+ </item>
+ <item>
+ <title>VTE</title>
+ <p>Virtual Terminal Environment (VTE) is a terminal emulator which
+ emulates a text terminal inside a graphical user interface (GUI)
+ environment. <app>Terminal</app> is largely based on the <app>VTE</app>.
+ <app>VTE</app> has widgets that implement a fully functional terminal
+ emulator.</p>
+ </item>
+ <item>
+ <title>Shell</title>
+ <p>A <em>shell</em> is a program that provides an interface to invoke or
+ “launch” commands or another program inside a terminal. It also allows you
+ to view and browse the contents of directories. Popular shells include
+ <app>bash</app>, <app>zsh</app>, <app>fish</app>.</p>
+ </item>
+ <item>
+ <title>Escape Sequences</title>
+ <p>An escape sequence is a series of characters used to change the meaning
+ of data in a terminal. Escape sequences are used when a computer has only
+ single channel to send information back and forth. Escape sequences are
+ used to distinguish if data being sent is a command to be executed or
+ information to be stored and displayed.</p>
+ </item>
+
+ <item>
+ <title>Prompt</title>
+ <p>A prompt is also called a <em>command prompt</em>. It is a sequence of
+ characters used in the command line environment to indicate the readiness
+ of the shell to accept commands.</p>
+
+ <p>A prompt usually ends with the characters <sys>$</sys>, <sys>%</sys>,
+ <sys>#</sys> or <sys>&gt;</sys> and includes
+ information about the path of the present working directory. On Unix based
+ systems, it is common for the prompt to end in a <sys>$</sys> or
+ <sys>#</sys> character depending on the user role such as <sys>$</sys>
+ for user and <sys>#</sys> for superuser (also called <sys>root</sys>).
+ </p>
+ </item>
+ <item>
+ <title>Command</title>
+ <p>An input entered in the prompt to be executed is called a
+ <em>command</em>. It is a combination of the program name along with any
+ other additional parameters passed as flags to alter the execution of the
+ program.</p>
+ </item>
+ </terms>
+
+</page>
diff --git a/help/C/pref-bell.page b/help/C/pref-bell.page
new file mode 100644
index 0000000..a750be4
--- /dev/null
+++ b/help/C/pref-bell.page
@@ -0,0 +1,66 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="task"
+ id="pref-bell">
+
+ <info>
+ <revision version="0.1" date="2013-02-17" status="candidate"/>
+ <revision version="0.2" pkgversion="3.34" date="2020-01-04" status="candidate"/>
+ <link type="guide" xref="index#preferences"/>
+ <link type="guide" xref="pref#profile"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Enable audible notification in <app>Terminal</app>.</desc>
+
+ </info>
+
+ <title>Set audible bell</title>
+
+ <p><app>Terminal</app> can sound an audible bell to indicate events in
+ <app>Terminal</app> windows and tabs.</p>
+
+ <p>To be notified of these events:</p>
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Text</gui>.</p>
+ </item>
+ <item>
+ <p>Select <gui style="checkbox">Terminal bell</gui></p>
+ </item>
+ </steps>
+
+ <comment>
+ <p>TODO: Ctrl+G shortcut seems to do nothing in 3.34? When to press and where?
+ Preferences dialog? Before or after enabling the setting?
+ Or in the terminal window itself?</p>
+ </comment>
+ <note style="tip">
+ <p>To preview the bell sound that your system produces, press
+ <keyseq><key>Ctrl</key><key>G</key></keyseq>.</p>
+ </note>
+
+</page>
diff --git a/help/C/pref-custom-command.page b/help/C/pref-custom-command.page
new file mode 100644
index 0000000..f103ad9
--- /dev/null
+++ b/help/C/pref-custom-command.page
@@ -0,0 +1,82 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="topic"
+ id="pref-custom-command">
+
+ <info>
+ <revision pkgversion="3.8" date="2013-03-02" status="candidate"/>
+ <revision pkgversion="3.12" date="2014-09-08" status="candidate"/>
+ <revision pkgversion="3.34" date="2020-01-04" status="candidate"/>
+ <link type="guide" xref="index#preferences"/>
+ <link type="guide" xref="pref#profile"/>
+ <link type="seealso" xref="gs-execute-commands"/>
+<!-- <link type="seealso" xref="prob-add-to-path"/>-->
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013-2014</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Set <app>Terminal</app> to run a command or a different shell on startup.</desc>
+
+ </info>
+
+ <title>Custom commands and shells</title>
+
+ <p>A <em>shell</em> is software that provides an interface for users of an
+ operating system to run <em>commands</em>, which can be programs such as
+ <app>top</app> or a command line shell. The default shell is usually
+ <app>Bash</app>.</p>
+
+ <p>You can set <app>Terminal</app> to run a command when it starts up instead
+ of awaiting input from you:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Command</gui>.</p>
+ </item>
+ <item>
+ <p>Check <gui>Run a custom command instead of my shell</gui>.</p>
+ </item>
+ <item>
+ <p>In the text box, type the command or the desired shell.</p>
+ <p>The command will be passed to the terminal exactly as you write it,
+ including any arguments that you specify. Environment variables will be
+ inherited from the terminal as it is a child process of the terminal.</p>
+ </item>
+ <item>
+ <p>Open a new <app>Terminal</app> tab or window to see how the custom
+ shell or command executes.</p>
+ </item>
+ </steps>
+
+ <p>You can also <link xref="pref-custom-exit">set the behavior</link> of
+ the terminal once the command finishes executing.</p>
+
+ <note style="important">
+ <p>You may have to enter full path to the command or the shell if the
+ directory where the command or shell resides is not in the
+ <code>PATH</code> variable of your system.</p>
+ </note>
+
+</page>
diff --git a/help/C/pref-custom-exit.page b/help/C/pref-custom-exit.page
new file mode 100644
index 0000000..681bdcf
--- /dev/null
+++ b/help/C/pref-custom-exit.page
@@ -0,0 +1,78 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="topic"
+ id="pref-custom-exit">
+
+ <info>
+ <revision pkgversion="3.8" date="2013-03-02" status="candidate"/>
+ <revision pkgversion="3.12" date="2014-09-08" status="candidate"/>
+ <revision pkgversion="3.34" date="2020-01-04" status="candidate"/>
+ <link type="guide" xref="index#preferences"/>
+ <link type="guide" xref="pref#profile"/>
+<!-- <link type="seealso" xref="prob-recover-default-profile"/>-->
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013-2014</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Set the behavior of <app>Terminal</app> when a custom command or the default shell exits.</desc>
+
+ </info>
+
+ <title>Set behavior on command exit</title>
+
+ <p>You can set the terminal to exit, restart or remain open when the shell or
+ a custom command exits:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Command</gui>.</p>
+ </item>
+ <item>
+ <p>From the <gui>When command exits</gui> drop down list, select one of
+ the following options:</p>
+ <list>
+ <item>
+ <p><gui>Exit the terminal</gui></p>
+ </item>
+ <item>
+ <p><gui>Restart the command</gui></p>
+ </item>
+ <item>
+ <p><gui>Hold the terminal open</gui></p>
+ </item>
+ </list>
+ <p>The setting will be saved automatically when you select it.</p>
+ </item>
+ </steps>
+
+ <note style="important">
+ <p>If you have <link xref="pref-custom-command">set a custom command</link>
+ that is non-interactive, have set the exit behavior to <gui>Exit the
+ terminal</gui>, and have set the profile to be the default profile,
+ <app>Terminal</app> may exit before you can see the output of the
+ command.</p>
+ </note>
+
+</page>
diff --git a/help/C/pref-keyboard-access.page b/help/C/pref-keyboard-access.page
new file mode 100644
index 0000000..816c34b
--- /dev/null
+++ b/help/C/pref-keyboard-access.page
@@ -0,0 +1,101 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="pref-keyboard-access">
+
+ <info>
+ <revision version="0.1" date="2013-02-25" status="candidate"/>
+ <revision version="0.2" pkgversion="3.34" date="2020-01-04" status="review"/>
+ <link type="guide" xref="index#preferences"/>
+ <link type="guide" xref="pref#global"/>
+ <link type="seealso" xref="pref-menubar"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Navigate around <app>Terminal</app> menus using keyboard keys.</desc>
+ </info>
+
+ <title>Keyboard accessibility</title>
+
+ <note style="important">
+ <!-- see https://gitlab.gnome.org/GNOME/gnome-terminal/issues/145 -->
+ <p>These keys will only have an effect in windows in which the menubar is
+ set to be visible.</p>
+ <p>Right click in the <app>Terminal</app> window and select
+ <gui style="checkbox">Show Menubar</gui> to display the menubar.</p>
+ </note>
+
+ <p>You can navigate the <app>Terminal</app> menu using a combination of keys
+ that are called <em>mnemonics</em> or a special key that takes you directly
+ to the first menu in the menubar which is called the <em>menu accelerator
+ key</em>.</p>
+
+ <section id="mnemonics">
+ <title>Mnemonics</title>
+
+ <p><app>Terminal</app> menu can be accessed by combining the <key>Alt</key>
+ key and a letter of the menu item. The letter that you need to use to
+ access the menu will be underlined when you hold down the
+ <key>Alt</key>.</p>
+
+ <p>For example, view the <gui style="menu">Edit</gui> menu using
+ <keyseq><key>Alt</key><key>E</key></keyseq>. Similarly, you can access
+ <gui style="menu">File</gui> menu using
+ <keyseq><key>Alt</key><key>F</key></keyseq>.</p>
+
+ <p>To enable mnemonics:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select <gui>General</gui>.</p>
+ </item>
+ <item>
+ <p>Check <gui style="checkbox">Enable mnemonics</gui>.</p>
+ </item>
+ </steps>
+
+ </section>
+
+ <section id="menu-accelerator">
+ <title>Menu accelerator key</title>
+
+ <p>This setting brings up the <gui style="menu">File</gui> menu when the menu
+ accelerator key is pressed. This key is usually <key>F10</key> by
+ default.</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select <gui>General</gui>.</p>
+ </item>
+ <item>
+ <p>Check <gui style="checkbox">Enable the menu accelerator
+ key</gui>.</p>
+ </item>
+ </steps>
+
+ </section>
+
+</page>
diff --git a/help/C/pref-login-shell.page b/help/C/pref-login-shell.page
new file mode 100644
index 0000000..05f665c
--- /dev/null
+++ b/help/C/pref-login-shell.page
@@ -0,0 +1,99 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="pref-login-shell">
+
+ <info>
+ <revision pkgversion="3.8" date="2013-03-03" status="review"/>
+ <revision pkgversion="3.14" date="2014-09-08" status="review"/>
+ <revision version="0.2" pkgversion="3.34" date="2020-01-04" status="review"/>
+ <link type="guide" xref="index#preferences"/>
+ <link type="guide" xref="pref#profile"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013-2014</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Start a login shell in <app>Terminal</app>.</desc>
+ </info>
+
+ <title>Login shells</title>
+
+ <p>Shells in UNIX based systems can be started up in login and non-login
+ modes:</p>
+
+ <terms>
+ <item>
+ <title>Login shell</title>
+ <p>A login shell is a shell given to a user upon login into their user
+ account. This is initiated by using the <cmd>-l</cmd> or
+ <cmd>--login</cmd> option, or placing a dash as the initial character
+ of the command name, for example invoking <cmd>bash</cmd> as
+ <cmd>-bash</cmd>.</p>
+ </item>
+ <item>
+ <title>Sub shell</title>
+ <p>Sub shell, also called a non-login shell is a shell started after
+ the login process without the <cmd>-l</cmd> or <cmd>--login</cmd>
+ option and without an extra dash before the command name.</p>
+ </item>
+ </terms>
+
+ <p>The general cases for having a login shell include:</p>
+ <list>
+ <item>
+ <p>Accessing your computer remotely using <app>ssh</app>.</p>
+ </item>
+ <item>
+ <p>Simulating an initial login shell with <cmd>bash -l</cmd> or
+ <cmd>sh -l</cmd>.</p>
+ </item>
+ <item>
+ <p>Simulating an initial root login shell with <cmd>sudo -i</cmd>.</p>
+ </item>
+ </list>
+
+ <section id="login-shell-howto">
+ <title>Start a login shell</title>
+
+ <p>You can allow <app>Terminal</app> to start a login shell. Your default
+ shell will be started with a dash character prepended to its name.</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Command</gui>.</p>
+ </item>
+ <item>
+ <comment>
+ <cite href="mailto:kittykat3756@gmail.com">Kat</cite>
+ <p>TODO: test when this takes effect.</p>
+ </comment>
+ <p>Under the <gui>Command</gui> label, select
+ <gui style="checkbox">Run command as a login shell</gui>.</p>
+ </item>
+ </steps>
+
+ </section>
+
+</page>
diff --git a/help/C/pref-menubar.page b/help/C/pref-menubar.page
new file mode 100644
index 0000000..76a2e31
--- /dev/null
+++ b/help/C/pref-menubar.page
@@ -0,0 +1,75 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="task"
+ id="pref-menubar">
+
+ <info>
+ <revision version="0.1" date="2013-02-21" status="candidate"/>
+ <revision version="0.2" pkgversion="3.34" date="2020-01-04" status="review"/>
+ <link type="guide" xref="index#preferences"/>
+ <link type="guide" xref="pref#global"/>
+ <link type="seealso" xref="pref-keyboard-access"/>
+ <link type="seealso" xref="app-fullscreen"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Display and hide the menubar.</desc>
+
+ </info>
+
+ <title>Menubar visibility</title>
+
+ <p>You can enable or disable the menubar as desired. This may be useful if
+ you have limited screen space.</p>
+
+ <p>To display the menubar:</p>
+ <steps>
+ <item>
+ <p>Right click in <app>Terminal</app> and select
+ <gui style="menuitem">Show Menubar</gui>.</p>
+ </item>
+ </steps>
+
+ <p>To hide the menubar:</p>
+ <steps>
+ <item>
+ <p>Right click in <app>Terminal</app> and deselect
+ <gui style="checkbox">Show Menubar</gui>.</p>
+ </item>
+ </steps>
+
+<!--
+ <p>To enable or disable the menubar by default in all <app>Terminal</app>
+ windows that you open:</p>
+
+ <steps>
+ <item>
+ <p>Select <guiseq><gui style="menu">Edit</gui> <gui style="menuitem">
+ Preferences</gui> <gui style="tab">General</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>Select or deselect <gui>Show menubar by default in new terminals</gui>.</p>
+ </item>
+ </steps>
+-->
+ <note style="tip">
+ <p>You can <link xref="adv-keyboard-shortcuts">set a keyboard
+ shortcut</link> to show and hide the menubar.</p>
+ </note>
+
+</page>
diff --git a/help/C/pref-profile-char-width.page b/help/C/pref-profile-char-width.page
new file mode 100644
index 0000000..473f8d1
--- /dev/null
+++ b/help/C/pref-profile-char-width.page
@@ -0,0 +1,55 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="task"
+ id="pref-profile-char-width">
+
+ <info>
+ <link type="guide" xref="index#advanced"/>
+ <link type="guide" xref="pref#profile"/>
+ <revision pkgversion="3.14" date="2014-09-08" status="review"/>
+ <revision version="0.2" pkgversion="3.34" date="2020-01-04" status="review"/>
+
+ <credit type="author copyright">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2014</years>
+ </credit>
+ <!--<credit type="copyright editor">
+ <name></name>
+ <email></email>
+ <years></years>
+ </credit>-->
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Display ambiguous-width characters as wide instead of narrow.</desc>
+
+ </info>
+
+ <title>Characters look too narrow</title>
+
+ <p>Some characters, such as some Greek letters and Asian logograms, can take
+ up either one or two cells in a terminal window. These characters are often
+ referred to as <em>ambiguous characters</em>. By default, these characters
+ are displayed with a narrow width in <app>Terminal</app>, which looks better
+ in situations where perfect layout is important, such as in ASCII art. You
+ can change your profile preferences to display ambiguous characters as wide,
+ which can be better if you are reading running prose.</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Open the <gui style="tab">Compatibility</gui> tab.</p>
+ </item>
+ <item>
+ <p>Set <gui>Ambiguous-width characters</gui> to <gui>Wide</gui>.</p>
+ </item>
+ </steps>
+
+</page>
diff --git a/help/C/pref-profile-encoding.page b/help/C/pref-profile-encoding.page
new file mode 100644
index 0000000..b4dd28a
--- /dev/null
+++ b/help/C/pref-profile-encoding.page
@@ -0,0 +1,58 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="task"
+ id="pref-profile-encoding">
+
+ <info>
+ <link type="guide" xref="index#advanced"/>
+ <link type="guide" xref="pref#profile"/>
+ <revision pkgversion="3.14" date="2014-09-08" status="review"/>
+ <revision version="0.2" pkgversion="3.34" date="2020-01-04" status="review"/>
+
+ <credit type="author copyright">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2014</years>
+ </credit>
+ <!--<credit type="copyright editor">
+ <name></name>
+ <email></email>
+ <years></years>
+ </credit>-->
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Set a different encoding for each saved profile.</desc>
+
+ </info>
+
+ <title>Change profile character encoding</title>
+
+ <p>You should normally be able to use the default, UTF-8 encoding for all of
+ your terminal needs. If you do find that you regularly need to use a
+ different character encoding for a specific task, you can
+ <link xref="pref-profiles#new-profile">create a new profile</link> with a
+ different encoding.</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Open the <gui style="tab">Compatibility</gui> tab.</p>
+ </item>
+ <item>
+ <p>Set the character encoding.</p>
+ </item>
+ </steps>
+
+ <note>
+ <p>Most modern operating systems now support and use UTF-8 character
+ encoding by default.</p>
+ </note>
+
+</page>
diff --git a/help/C/pref-profiles.page b/help/C/pref-profiles.page
new file mode 100644
index 0000000..bf10519
--- /dev/null
+++ b/help/C/pref-profiles.page
@@ -0,0 +1,293 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="pref-profiles">
+
+ <info>
+ <revision pkgversion="3.8" date="2013-03-03" status="candidate"/>
+ <revision pkgversion="3.12" date="2014-09-08" status="candidate"/>
+ <link type="guide" xref="index#preferences"/>
+ <link type="guide" xref="pref#manage-profiles"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="author copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013-2014</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Create, rename and delete profiles.</desc>
+ </info>
+
+ <title>Manage profiles</title>
+
+ <comment>
+ <cite href="mailto:kittykat3756@gmail.com">Kat</cite>
+ <p>Repeating that the user can edit the settings in each section is not
+ very nice, we need to find a way around this.</p>
+ </comment>
+
+ <p>A profile is a collection of <app>Terminal</app> settings.
+ <app>Terminal</app> supports multiple profiles. You can configure
+ <app>Terminal</app> profiles to <link xref="pref-custom-command">run a custom
+ command or shell</link>, set a profile exclusively to connect to remote
+ computers using SSH or set a profile that launches a <app>GNU Screen</app>
+ session.</p>
+
+ <p>The available <app>Terminal</app> settings include:</p>
+
+ <list>
+ <item>
+ <p>Profile name.</p>
+ </item>
+ <item>
+ <p>Font and background colors.</p>
+ </item>
+ <item>
+ <p><gui style="tab">Compatibility</gui> with <key>Backspace</key> and
+ <key>Delete</key> keys.</p>
+ </item>
+ <item>
+ <p><gui style="tab">Scrolling</gui>.</p>
+ </item>
+ </list>
+
+ <section id="select-profile" style="task">
+ <title>Select a profile</title>
+
+ <p>If you have two or more profiles defined, you can change the profile in
+ your current <app>Terminal</app> tab or
+ window by selecting a profile from <guiseq><gui style="menu">Terminal</gui>
+ <gui style="menuitem">Change Profile</gui></guiseq>.</p>
+
+ </section>
+
+ <section id="new-profile" style="task">
+ <title>Create a new profile</title>
+
+ <p>To create a new profile with the default settings of
+ <app>Terminal</app>:</p>
+
+ <steps>
+ <item>
+ <p>Select <guiseq><gui style="menu">Edit</gui>
+ <gui style="menuitem">Preferences</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, click on the <gui style="button">+</gui> button
+ next to the <gui>Profiles</gui> label.</p>
+ </item>
+ <item>
+ <p>Enter a name for the new profile. You can change this name later.</p>
+ </item>
+ <item>
+ <p>Click <gui style="button">Create</gui> to create the new profile.</p>
+ </item>
+ <item>
+ <p>Set your desired <link xref="#edit-profile">profile
+ preferences</link>. These will be saved automatically.</p>
+ </item>
+ </steps>
+
+ </section>
+
+ <section id="create-profile-from-existing" style="task">
+ <title>Create a new profile based on an existing profile</title>
+
+ <p>You can create a new profile based on settings from an existing
+ profile:</p>
+
+ <steps>
+ <item>
+ <p>Select <guiseq><gui style="menu">Edit</gui>
+ <gui style="menuitem">Preferences</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>In the sidebar select the profile on which your new profile should
+ be based.</p>
+ </item>
+ <item>
+ <p>Click on the arrow next to the profile name.</p>
+ </item>
+ <item>
+ <p>Select <gui style="menuitem">Clone…</gui>.</p>
+ </item>
+ <item>
+ <p>Enter a name for the new profile. You can change this name later.</p>
+ </item>
+ <item>
+ <p>Click <gui style="button">Clone</gui> to create the new profile.</p>
+ </item>
+ <item>
+ <p>Set your desired <link xref="#edit-profile">profile
+ preferences</link>. These will be saved automatically.</p>
+ </item>
+ </steps>
+
+ <note>
+ <p>Creating a new profile from an existing profile will not affect
+ settings in an existing profile. Any changes to settings will be stored
+ in the new profile.</p>
+ </note>
+
+ </section>
+
+ <section id="edit-profile" style="task">
+ <title>Edit a profile</title>
+
+ <note style="warning">
+ <p>If the default profile is edited, it cannot be restored to its
+ original settings! If you have not already created any other
+ <app>Terminal</app> profiles and have customized the default profile,
+ <app>Terminal</app> <em>may</em> become unusable should any settings
+ cause problems. It is recommended that you
+ <link xref="#create-profile-from-existing">create a copy of the
+ default profile</link> then edit the copy to create a custom profile.</p>
+ </note>
+
+ <p>You can make changes to existing profiles. To edit a profile:</p>
+
+ <steps>
+ <item>
+ <p>Select <guiseq><gui style="menu">Edit</gui>
+ <gui style="menuitem">Preferences</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>Your current profile is selected in the sidebar. If you wish to edit
+ a different profile, click on its name.</p>
+ </item>
+ </steps>
+
+ <p>Once the desired profile is selected, you can:</p>
+
+ <steps>
+ <item>
+ <p>Select <link xref="app-fonts">font</link>,
+ <link xref="app-cursor">cursor shapes</link> and
+ <link xref="app-terminal-sizes"><app>Terminal</app> size</link>.</p>
+ </item>
+ <item>
+ <p>You may also change behavior of <app>Terminal</app> on
+ <link xref="pref-custom-exit">command exit</link>, set a
+ <link xref="pref-login-shell">custom login shell</link> or change
+ <link xref="pref-scrolling">scrollbar preferences</link>.</p>
+ </item>
+ <item>
+ <p>To change the <app>Terminal</app> background and text colors, see
+ <link xref="app-colors"><app>Terminal</app> color schemes</link>.</p>
+ </item>
+ <item>
+ <p>Changes to profile are saved immediately. To return to
+ <app>Terminal</app>, click <gui style="button">Close</gui>.</p>
+ </item>
+ </steps>
+
+ </section>
+
+ <section id="rename-profile" style="task">
+ <title>Rename an existing profile</title>
+
+ <p>You can rename existing profiles, including the default profile:</p>
+
+ <steps>
+ <item>
+ <p>Select <guiseq><gui style="menu">Edit</gui>
+ <gui style="menuitem">Preferences</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>Select the profile you wish to rename.</p>
+ </item>
+ <item>
+ <p>Click on the arrow next to the profile name.</p>
+ </item>
+ <item>
+ <p>Select <gui style="menuitem">Rename…</gui>.</p>
+ </item>
+ <item>
+ <p>Enter the new profile name.</p>
+ </item>
+ <item>
+ <p>Click <gui style="button">Rename</gui> to rename.</p>
+ </item>
+ </steps>
+
+ </section>
+
+ <section id="delete-profile" style="task">
+ <title>Delete a profile</title>
+
+ <p>To delete a profile:</p>
+
+ <steps>
+ <item>
+ <p>Select <guiseq><gui style="menu">Edit</gui>
+ <gui style="menuitem">Preferences</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>Select the profile you wish to delete.</p>
+ </item>
+ <item>
+ <p>Click on the arrow next to the profile name.</p>
+ </item>
+ <item>
+ <p>Select <gui style="menuitem">Delete…</gui>.</p>
+ </item>
+ <item>
+ <p>Click <gui style="button">Delete</gui> to confirm.</p>
+ </item>
+ </steps>
+
+ <note style="tip">
+ <p>The default profile cannot be deleted. If you wish to delete
+ that profile, first set another profile as <link
+ xref="#set-default">default</link>.</p>
+ </note>
+
+ </section>
+
+ <section id="set-default" style="task">
+ <title>Set a default profile</title>
+
+ <p>The default profile is loaded when a new terminal is opened unless you
+ have selected another profile. Any changes that you make to the settings will
+ be stored in the currently selected profile.</p>
+
+ <p>The default profile is used when <app>Terminal</app> could not
+ otherwise decide which profile to use. For example, <app>Terminal</app> is
+ started up freshly and opens its first terminal window. In contrast, when
+ you use a menu entry or keyboard shortcut of <app>Terminal</app> to open a
+ new terminal, the profile of the existing terminal is used.</p>
+
+ <steps>
+ <item>
+ <p>Select <guiseq><gui style="menu">Edit</gui>
+ <gui style="menuitem">Preferences</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>Select the profile you wish to set as the default.</p>
+ </item>
+ <item>
+ <p>Click on the arrow next to the profile name.</p>
+ </item>
+ <item>
+ <p>Select <gui style="menuitem">Set as default</gui>.</p>
+ </item>
+ </steps>
+
+ <note>
+ <p>The default profile is marked with a check mark symbol.</p>
+ </note>
+
+ </section>
+
+</page>
diff --git a/help/C/pref-scrolling.page b/help/C/pref-scrolling.page
new file mode 100644
index 0000000..3d23bb3
--- /dev/null
+++ b/help/C/pref-scrolling.page
@@ -0,0 +1,179 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="pref-scrolling">
+
+ <info>
+ <revision pkgversion="3.8" date="2013-02-25" status="draft"/>
+ <revision pkgversion="3.12" date="2014-09-08" status="review"/>
+ <revision version="0.2" pkgversion="3.34" date="2020-01-04" status="review"/>
+ <link type="guide" xref="index#preferences"/>
+ <link type="guide" xref="pref#profile"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013–2014</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Change the scroll output and scrollbar behavior.</desc>
+ </info>
+
+ <title>Scrollbar preferences</title>
+
+ <p>When a lot of output is printed to your terminal screen, it can be helpful
+ to have your terminal behave in a specific manner so that it is easier to
+ work with.</p>
+
+ <section id="visibility">
+ <title>Scrollbar visibility</title>
+
+ <p>You can disable the scrollbar:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Scrolling</gui>.</p>
+ </item>
+ <item>
+ <p>Uncheck <gui>Show scrollbar</gui>.</p>
+ </item>
+ </steps>
+
+ <p>Your preference is saved immediately.</p>
+
+ </section>
+
+ <section id="on-output">
+ <title>Scroll on output</title>
+
+ <p>You can lock scrolling so that it always shows the newest output while a
+ command executes and produces output.</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Scrolling</gui>.</p>
+ </item>
+ <item>
+ <p>Check <gui style="checkbox">Scroll on output</gui>.</p>
+ </item>
+ </steps>
+
+ </section>
+
+ <section id="on-keystroke">
+ <title>Scroll on input</title>
+
+ <p>You can set the terminal to automatically scroll to the bottom of the
+ window when you input text into the prompt.</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Scrolling</gui>.</p>
+ </item>
+ <item>
+ <p>Check <gui style="checkbox">Scroll on keystroke</gui>.</p>
+ </item>
+ </steps>
+ </section>
+
+ <section id="lines">
+ <title>Scrollback lines</title>
+
+ <p>You can limit the number of lines of terminal output which are
+ remembered.</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Scrolling</gui>.</p>
+ </item>
+ <item>
+ <p>Check <gui>Limit scrollback to</gui> and enter a number of lines
+ to limit scrollback.</p>
+ </item>
+ <item>
+ <p>Optionally, you can click on <gui style="button">+</gui> to
+ increase and <gui style="button">-</gui> to decrease lines.</p>
+ </item>
+ </steps>
+
+ <p>You can choose to have unlimited scrollback.</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select your current profile in the <gui>Profiles</gui>
+ section.</p>
+ </item>
+ <item>
+ <p>Select <gui style="tab">Scrolling</gui>.</p>
+ </item>
+ <item>
+ <p>Uncheck <gui>Limit scrollback to</gui>.</p>
+ </item>
+ </steps>
+
+ <note style="tip">
+ <p>Scrollback data is stored in compressed and encrypted files on disk,
+ under the system’s default location for temporary files (usually
+ <file>/tmp</file>). These files are unlinked immediately after their
+ creation, and as such, do not show up in the directory listing. The
+ occupied disk space is freed up as soon as the corresponding terminal
+ closes.</p>
+ </note>
+
+ <note style="warning">
+ <p>Make sure you have sufficient disk space available for these temporary
+ files. If in doubt, monitor disk usage for example with the command
+ <cmd>du /tmp</cmd>.</p>
+ </note>
+
+ <note style="important">
+ <p>A giant scrollback buffer makes resizing the terminal window slower.
+ As a rule of thumb, resizing gets noticeably slow at around 1 million
+ lines.</p>
+ </note>
+
+ </section>
+
+</page>
diff --git a/help/C/pref-tab-window.page b/help/C/pref-tab-window.page
new file mode 100644
index 0000000..5b2ad79
--- /dev/null
+++ b/help/C/pref-tab-window.page
@@ -0,0 +1,75 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ xmlns:its="http://www.w3.org/2005/11/its"
+ type="guide"
+ id="pref-tab-window">
+
+ <info>
+ <link type="guide" xref="index#appearance"/>
+ <link type="seealso" xref="gs-tabs"/>
+ <revision pkgversion="3.12" date="2014-02-26" status="review"/>
+ <revision pkgversion="3.14.2" date="2015-01-27" status="review"/>
+ <revision pkgversion="3.34" date="2020-02-09" status="review"/>
+
+ <credit type="author copyright">
+ <name>Ekaterina Gerasimova</name>
+ <email its:translate="no">kittykat3756@gmail.com</email>
+ <years>2014–2015</years>
+ </credit>
+ <!--<credit type="copyright editor">
+ <name></name>
+ <email its:translate="no"></email>
+ <years></years>
+ </credit>-->
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Choose whether to open a new window or a new tab by default.</desc>
+ </info>
+
+ <title>Windows and tabs</title>
+
+<note style="tip">
+ <p>This setting only applies when the <link xref="pref-menubar">menubar is
+ enabled</link>, or when <app>Terminal</app> is started from the command line and
+ neither the <cmd>--tab</cmd> nor the <cmd>--window</cmd> options are passed.</p>
+</note>
+
+ <p>You can choose whether to open a new tab or a new <app>Terminal</app>
+ window when you use <gui style="menuitem">New Terminal</gui>.</p>
+
+ <steps>
+ <title>If the menubar is enabled,</title>
+ <item>
+ <p>Select
+ <guiseq><gui style="menu">Edit</gui><gui style="menuitem">Preferences</gui>
+ <gui style="tab">General</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>Set <gui>Open new terminals in:</gui> to <gui>Tab</gui> or
+ <gui>Window</gui>.</p>
+ </item>
+ </steps>
+
+ <steps>
+ <title>If the menubar is not enabled,</title>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and select
+ <gui style="menuitem">Preferences</gui>.</p>
+ </item>
+ <item>
+ <p>In the sidebar, select <gui>General</gui>.</p>
+ </item>
+ <item>
+ <p>Set <gui>Open new terminals in:</gui> to <gui>Tab</gui> or
+ <gui>Window</gui>.</p>
+ </item>
+ </steps>
+
+ <p>Once you have set the preference, you can use <key>Ctrl</key> to invert
+ the preference. For example, if you have your preferences set to open a new
+ terminal in a new tab, then pressing <gui style="menuitem">New Terminal</gui>
+ will open a new tab. On the other hand, if you hold down <key>Ctrl</key> and
+ then press <gui style="menuitem">New Terminal</gui>, then a new window will
+ be opened instead.</p>
+
+</page>
diff --git a/help/C/pref-user-input.page b/help/C/pref-user-input.page
new file mode 100644
index 0000000..84d09c4
--- /dev/null
+++ b/help/C/pref-user-input.page
@@ -0,0 +1,48 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="topic"
+ id="pref-user-input">
+
+ <info>
+ <revision pkgversion="3.14" date="2014-10-23" status="review"/>
+ <revision version="0.2" pkgversion="3.34" date="2020-01-04" status="review"/>
+ <link type="guide" xref="index#preferences"/>
+
+ <credit type="author copyright">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2014</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Do not send user input to the application running in the
+ terminal.</desc>
+
+ </info>
+
+ <title>Disable user input</title>
+
+ <p>You can prevent user input into the terminal from being passed to the
+ application which is currently running in the terminal. This will prevent any
+ keypresses, mouse clicks and mouse movement from affecting the application.
+ You will still be able to interact with the terminal itself using the
+ keyboard for scrolling and your mouse for selecting text. You will also be
+ able to copy selected text from the terminal, but you will not be able to
+ paste text into the terminal.</p>
+
+ <p>To use the read only mode:</p>
+
+ <steps>
+ <item>
+ <p>Right click in the <app>Terminal</app> window or press the menu button
+ in the top-right corner of the window.</p>
+ </item>
+ <item>
+ <p>Select <gui style="menuitem">Read-Only</gui> so that it is checked.</p>
+ </item>
+ </steps>
+
+ <p>You can disable the read only mode by unchecking
+ <gui style="menuitem">Read-Only</gui>.</p>
+
+</page>
diff --git a/help/C/pref.page b/help/C/pref.page
new file mode 100644
index 0000000..99d90c2
--- /dev/null
+++ b/help/C/pref.page
@@ -0,0 +1,32 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide" style="2column task"
+ id="pref">
+
+ <info>
+ <revision version="0.1" date="2013-03-02" status="draft"/>
+
+ <credit type="author">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc></desc>
+ </info>
+
+ <title><app>Terminal</app> preferences</title>
+
+ <section id="global" style="2column">
+ <title>Global Preferences</title>
+ </section>
+
+ <section id="manage-profiles" style="2column">
+ <title>Manage Profiles</title>
+ </section>
+
+ <section id="profile" style="2column">
+ <title>Profile Preferences</title>
+ </section>
+
+</page>
diff --git a/help/C/prob-reset.page b/help/C/prob-reset.page
new file mode 100644
index 0000000..cc5d5ed
--- /dev/null
+++ b/help/C/prob-reset.page
@@ -0,0 +1,76 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="prob-reset">
+
+ <info>
+ <revision version="0.1" date="2013-03-03" status="draft"/>
+ <revision pkgversion="3.34" version="0.2" date="2020-01-04" status="candidate"/>
+ <link type="guide" xref="index#troubleshooting"/>
+ <link type="seealso" xref="pref-keyboard-access"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>How do I recover my <app>Terminal</app> screen when it becomes stuck
+ or has lot of strange symbols on it?</desc>
+ </info>
+
+ <title>Reset your <app>Terminal</app> state</title>
+
+ <p>After viewing a non-text file by mistake, or launching some command, it can
+ happen the <app>Terminal</app> screen is unresponsive, has strange letters
+ printed when you press keys. You can recover your <app>Terminal</app> in
+ the following ways:</p>
+
+ <section id="reset">
+ <title>Reset</title>
+
+ <p>Reset <app>Terminal</app> screen.</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and
+ select <guiseq><gui style="menuitem">Advanced</gui><gui
+ style="menuitem">Reset</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>To obtain the prompt press <key>Enter</key>.</p>
+ </item>
+ </steps>
+
+ </section>
+
+ <section id="reset-clear">
+ <title>Reset and Clear</title>
+
+ <p>In addition to resetting your <app>Terminal</app>,
+ <gui style="menuitem">Reset and Clear</gui> clears the visible
+ <app>Terminal</app> screen space and the scrollback contents. To
+ <gui style="menuitem">Reset and Clear</gui> your <app>Terminal</app>:</p>
+
+ <steps>
+ <item>
+ <p>Press the menu button in the top-right corner of the window and
+ select <guiseq><gui style="menuitem">Advanced</gui><gui
+ style="menuitem">Reset and Clear</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>To obtain the prompt press <key>Enter</key>.</p>
+ </item>
+ </steps>
+
+ <note style="tip"><p><gui>Reset and Clear</gui> provides similar
+ functionality as the terminal command <cmd>reset</cmd>.</p></note>
+
+ </section>
+</page>
diff --git a/help/C/txt-copy-paste.page b/help/C/txt-copy-paste.page
new file mode 100644
index 0000000..6c28698
--- /dev/null
+++ b/help/C/txt-copy-paste.page
@@ -0,0 +1,67 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="topic"
+ id="txt-copy-paste">
+ <info>
+ <link type="guide" xref="index#textoutput"/>
+ <link type="seealso" xref="adv-keyboard-shortcuts"/>
+
+ <revision version="0.1" date="2013-03-03" status="candidate"/>
+ <revision version="0.2" pkgversion="3.34" date="2020-01-04" status="candidate"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Copy and paste text in <app>Terminal</app>.</desc>
+
+ </info>
+
+ <title>Copy and paste</title>
+
+ <p>You can copy and paste text in <app>Terminal</app> in a similar way to
+ other applications. However, the keyboard shortcuts differ.</p>
+
+ <terms>
+ <item>
+ <title><gui>Copy</gui></title>
+ <p>Highlight the text portions you wish to copy, then right click on the
+ text portion and select <gui style="menuitem">Copy</gui>. Alternatively,
+ you can press
+ <keyseq><key>Shift</key><key>Ctrl</key><key>C</key></keyseq>.</p>
+ </item>
+ <item>
+ <title><gui>Copy as HTML</gui></title>
+ <p>Highlight the text portions you wish to copy with color and font
+ attributes, then right click on the text portion and select
+ <gui style="menuitem">Copy as HTML</gui>.</p>
+ </item>
+ <item>
+ <title><gui>Paste</gui></title>
+ <p>Right click in the <app>Terminal</app> and select
+ <gui style="menuitem">Paste</gui>. Alternatively, you
+ can press
+ <keyseq><key>Shift</key><key>Ctrl</key><key>V</key></keyseq>.</p>
+ </item>
+ </terms>
+
+ <note>
+ <p>The standard keyboard shortcuts, such as
+ <keyseq><key>Ctrl</key><key>C</key></keyseq>, cannot be used to copy and
+ paste text.</p>
+ </note>
+
+</page>
diff --git a/help/C/txt-links.page b/help/C/txt-links.page
new file mode 100644
index 0000000..d08c291
--- /dev/null
+++ b/help/C/txt-links.page
@@ -0,0 +1,107 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="txt-links">
+
+ <info>
+ <link type="guide" xref="index#textoutput"/>
+ <revision version="0.1" date="2013-03-03" status="candidate"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Open links to web and email addresses.</desc>
+ </info>
+
+ <title>Hyperlinks and email addresses</title>
+
+ <p><app>Terminal</app> parses the terminal output and automatically detects
+ snippets of text that are web addresses or email addresses. Web and email
+ addresses are automatically highlighted when you point your cursor to the
+ text, indicating that the link can be opened in an application.</p>
+
+ <p>For example, you may see <output>http://www.gnome.org</output> or
+ <output>username@example.com</output> generated as a part of terminal output by
+ programs such as <app>wget</app> or <app>curl</app>.</p>
+
+ <section id="hyperlinks">
+ <title>Open or copy web addresses</title>
+
+ <p>Web addresses are also called hyperlinks. They can be copied to the
+ system clipboard or opened in your preferred web browser.</p>
+
+ <list>
+ <item>
+ <p>Copy a hyperlink:</p>
+ <steps>
+ <item>
+ <p>Right click on the link in <app>Terminal</app>.</p>
+ </item>
+ <item>
+ <p>Select <gui style="menuitem">Copy Link</gui>.</p>
+ </item>
+ </steps>
+ </item>
+ <item>
+ <p>Open a hyperlink in your web browser:</p>
+ <steps>
+ <item>
+ <p>Right click on the hyperlink.</p>
+ </item>
+ <item>
+ <p>Select <gui style="menuitem">Open Link</gui>.</p>
+ </item>
+ </steps>
+ </item>
+ </list>
+
+ </section>
+
+ <section id="email">
+ <title>Email or copy email addresses</title>
+
+ <p>Email addresses can be copied to the system clipboard or opened in your
+ preferred email client.</p>
+
+ <list>
+ <item>
+ <p>Copy an email address:</p>
+ <steps>
+ <item>
+ <p>Right click on the email address in <app>Terminal</app>.</p>
+ </item>
+ <item>
+ <p>Select <gui style="menuitem">Copy Mail Address</gui>.</p>
+ </item>
+ </steps>
+ </item>
+ <item>
+ <p>Send mail to the email address using your email client:</p>
+ <steps>
+ <item>
+ <p>Right click on the address.</p>
+ </item>
+ <item>
+ <p>Select <gui style="menuitem">Send Mail To…</gui>.</p>
+ </item>
+ </steps>
+ </item>
+ </list>
+
+ </section>
+
+</page>
diff --git a/help/C/txt-search.page b/help/C/txt-search.page
new file mode 100644
index 0000000..f10399d
--- /dev/null
+++ b/help/C/txt-search.page
@@ -0,0 +1,87 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ xmlns:its="http://www.w3.org/2005/11/its"
+ type="task"
+ id="txt-search">
+
+ <info>
+ <revision version="0.1" date="2013-03-03" status="candidate"/>
+ <revision pkgversion="3.34" version="0.2" date="2020-01-04" status="candidate"/>
+ <link type="guide" xref="index#textoutput"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Michael Hill</name>
+ <email>mdhillca@gmail.com</email>
+ <years>2013</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Search the <app>Terminal</app> output.</desc>
+
+ </info>
+
+ <title>Search for text</title>
+
+ <p>You can search text in the <app>Terminal</app> output:</p>
+
+ <steps>
+ <item>
+ <p>Press <media its:translate="no" type="image" mime="image/svg" src="figures/keyboard-key-search.svg">
+ <key>Search</key> key symbol</media> in the top-right corner, or press
+ <keyseq><key>Ctrl</key><key>Shift</key><key>F</key></keyseq>.</p>
+ </item>
+ <item>
+ <p>Type in the search keyword and press <key>Enter</key> to search
+ backwards. Alternatively, click on the arrows according to the desired
+ search direction.</p>
+ </item>
+ </steps>
+
+ <p>You can search using the following options to narrow down your
+ results:</p>
+
+ <terms>
+ <item>
+ <title><gui style="checkbox">Match case</gui></title>
+ <p>Make the search case sensitive: this restricts results to only those
+ that match the case of your search keyword.</p>
+ </item>
+ <item>
+ <title><gui style="checkbox">Match entire word only</gui></title>
+ <p><app>Terminal</app> will look for the entire keyword and will ignore
+ results that partially match your search keyword. For example, if
+ you have searched for “cat”, <app>Terminal</app> will show only
+ results that match this keyword exactly and omit results such as
+ “bobcat”.</p>
+ </item>
+ <item>
+ <title><gui style="checkbox">Match as regular expression</gui></title>
+ <p>You can use regular expression patterns, also known as regex
+ patterns, in your search keywords. <app>Terminal</app> will display
+ the results that match these search terms.</p>
+ </item>
+ <item>
+ <title><gui style="checkbox">Wrap around</gui></title>
+ <p><app>Terminal</app> searches from your current location in the
+ scrollback to the end of available terminal output and then restarts the
+ search.</p>
+ </item>
+ </terms>
+
+ <note style="tip">
+ <p>If you expect to work with a lot of <app>Terminal</app> output, increase
+ the <link xref="pref-scrolling#lines">scrollback lines</link> to
+ a higher limit to allow <app>Terminal</app> to search further back.</p>
+ </note>
+
+</page>
diff --git a/help/C/txt-select-text.page b/help/C/txt-select-text.page
new file mode 100644
index 0000000..2287559
--- /dev/null
+++ b/help/C/txt-select-text.page
@@ -0,0 +1,56 @@
+<page xmlns="http://projectmallard.org/1.0/"
+
+ type="topic"
+ id="txt-select-text">
+
+ <info>
+ <revision pkgversion="3.8" date="2013-03-03" status="review"/>
+ <revision pkgversion="3.14.2" date="2015-01-28" status="review"/>
+ <link type="guide" xref="index#textoutput"/>
+ <link type="seealso" xref="txt-copy-paste"/>
+
+ <credit type="author copyright">
+ <name>Sindhu S</name>
+ <email>sindhus@live.in</email>
+ <years>2013</years>
+ </credit>
+ <credit type="copyright editor">
+ <name>Ekaterina Gerasimova</name>
+ <email>kittykat3756@gmail.com</email>
+ <years>2013, 2015</years>
+ </credit>
+
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <desc>Select individual words or lines in the terminal.</desc>
+
+ </info>
+
+ <title>Text selection</title>
+
+ <p>You can select a word or a sentence, or make a rectangular selection from
+ your terminal output:</p>
+
+ <terms>
+ <item>
+ <title>Select a word</title>
+ <p>Double click on the word.</p>
+ </item>
+ <item>
+ <title>Select a line</title>
+ <p>Triple click on the line.</p>
+ </item>
+ <item>
+ <title>Make a rectangular selection</title>
+ <p>Hold down the <key>Ctrl</key>, click and hold down the left mouse
+ button then drag the mouse.</p>
+ </item>
+ </terms>
+
+ <note style="tip">
+ <p>If you are running an application in <app>Terminal</app> which accepts
+ mouse input, you need to use the <key>Shift</key> modifier for the
+ <app>Terminal</app> to catch the mouse input.</p>
+ </note>
+
+</page>