diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 15:21:32 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 15:21:32 +0000 |
commit | f8a786c8f7878517aa695a69322bc9f2c8b92b6a (patch) | |
tree | 0cb8f00f8c10625d5d75244ef9dde521d94f8678 /help/C | |
parent | Initial commit. (diff) | |
download | gnome-terminal-upstream.tar.xz gnome-terminal-upstream.zip |
Adding upstream version 3.38.3.upstream/3.38.3upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
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 Binary files differnew file mode 100644 index 0000000..ca094b4 --- /dev/null +++ b/help/C/figures/gnome-terminal-icon.png diff --git a/help/C/figures/gnome-terminal.png b/help/C/figures/gnome-terminal.png Binary files differnew file mode 100644 index 0000000..4c954a2 --- /dev/null +++ b/help/C/figures/gnome-terminal.png 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>></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> |