gatuno
/
gatuno-terminal
1
0
Fork 0
Code Issues Pull Requests Releases 1 Wiki Activity

Upgrade the manual to docbook 5.0 

To upgrade the manual:
  wget https://docbook.org/xml/5.0.1/tools/db4-upgrade.xsl
  xsltproc --output index-new.docbook db4-upgrade.xsl index.docbook
  xsltproc --output legal-new.xml db4-upgrade.xsl legal.xml

To validate the manual:
  wget https://docbook.org/xml/5.0.1/rng/docbookxi.rng
  jing docbookxi.rng index.docbook

To view the manual:
  yelp file:///full_path/index.docbook
rbuj 2019-04-07 14:43:25 +02:00 committed by raveit65
parent 9d6ac1b459
commit 11909bfdfe
2 changed files with 175 additions and 224 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

329
help/C/index.docbook
View File

@ -1,28 +1,13 @@
<?xml version="1.0"?> <?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" <?db.chunk.max_depth 2?>
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ <article xmlns="http://docbook.org/ns/docbook"
<!ENTITY legal SYSTEM "legal.xml"> xmlns:db="http://docbook.org/ns/docbook"
<!ENTITY app "MATE Terminal"> xmlns:xlink="http://www.w3.org/1999/xlink"
<!ENTITY appversion "1.10"> xmlns:xi="http://www.w3.org/2001/XInclude"
<!ENTITY manrevision "1.10"> version="5.0" xml:id="index" xml:lang="en">
<!ENTITY date "July 2015"> <info>
]> <title>MATE Terminal Manual</title>
<!-- =============Document Header ============================= -->
<!-- (Do not remove this comment block.)
Maintained by the MATE Documentation Project
Template version: 2.0 beta
Template last modified Jan 2, 2002
-->
<article id="index" lang="en">
<articleinfo>
<title>&app; Manual</title>
<abstract role="description">
<para>
The Terminal gives users the power to communicate with their system using
text-based commands through a shell such as Bash.
</para>
</abstract>
<copyright> <copyright>
<year>2019</year> <year>2019</year>
<holder>MATE Documentation Project</holder> <holder>MATE Documentation Project</holder>
@ -56,51 +41,35 @@ text-based commands through a shell such as Bash.
</copyright> </copyright>
<publisher> <publisher>
<publishername>MATE Documentation Project</publishername> <publishername>MATE Documentation Project</publishername>
</publisher> &legal; </publisher>
<xi:include href="legal.xml"/>
<authorgroup> <authorgroup>
<author> <author><personname><surname>MATE Documentation Team</surname></personname><affiliation>
<surname>MATE Documentation Team</surname>
<affiliation>
<orgname>MATE DESKTOP</orgname> <orgname>MATE DESKTOP</orgname>
</affiliation> </affiliation></author>
</author> <author><personname><firstname>Sun</firstname><surname>GNOME Documentation Team</surname></personname><affiliation>
<author>
<firstname>Sun</firstname>
<surname>GNOME Documentation Team</surname>
<affiliation>
<orgname>Sun Microsystems</orgname> <orgname>Sun Microsystems</orgname>
</affiliation> </affiliation></author>
</author> <author><personname><firstname>Miguel</firstname><surname>de Icaza</surname></personname><affiliation>
<author>
<firstname>Miguel</firstname>
<surname>de Icaza</surname>
<affiliation>
<orgname>GNOME Documentation Project</orgname> <orgname>GNOME Documentation Project</orgname>
</affiliation> </affiliation></author>
</author> <author><personname><firstname>Michael</firstname><surname>Zucchi</surname></personname><affiliation>
<author>
<firstname>Michael</firstname>
<surname>Zucchi</surname>
<affiliation>
<orgname>GNOME Documentation Project</orgname> <orgname>GNOME Documentation Project</orgname>
</affiliation> </affiliation></author>
</author> <author><personname><firstname>Alexander</firstname><surname>Kirillov</surname></personname><affiliation>
<author>
<firstname>Alexander</firstname>
<surname>Kirillov</surname>
<affiliation>
<orgname>GNOME Documentation Project</orgname> <orgname>GNOME Documentation Project</orgname>
</affiliation> </affiliation></author>
</author>
</authorgroup> </authorgroup>
<publisher role="maintainer"> <publisher role="maintainer">
<publishername>GNOME Documentation Project</publishername> <publishername>GNOME Documentation Project</publishername>
</publisher> </publisher>
<releaseinfo revision="2.30" role="review">
</releaseinfo>
<revhistory> <revhistory>
<revision> <revision>
<revnumber>GNOME Terminal Manual V2.9</revnumber> <revnumber>2.9</revnumber>
<date>January 2010</date> <date>January 2010</date>
<revdescription> <revdescription>
<para role="author">Paul Cutler <para role="author">Paul Cutler
@ -109,7 +78,7 @@ text-based commands through a shell such as Bash.
</revdescription> </revdescription>
</revision> </revision>
<revision> <revision>
<revnumber>GNOME Terminal Manual V2.8</revnumber> <revnumber>2.8</revnumber>
<date>March 2009</date> <date>March 2009</date>
<revdescription> <revdescription>
<para role="author">Paul Cutler</para> <para role="author">Paul Cutler</para>
@ -117,7 +86,7 @@ text-based commands through a shell such as Bash.
</revdescription> </revdescription>
</revision> </revision>
<revision> <revision>
<revnumber>GNOME Terminal Manual V2.7</revnumber> <revnumber>2.7</revnumber>
<date>November 2003</date> <date>November 2003</date>
<revdescription> <revdescription>
<para role="author">Sun GNOME Documentation Team</para> <para role="author">Sun GNOME Documentation Team</para>
@ -125,7 +94,7 @@ text-based commands through a shell such as Bash.
</revdescription> </revdescription>
</revision> </revision>
<revision> <revision>
<revnumber>GNOME Terminal Manual V2.6</revnumber> <revnumber>2.6</revnumber>
<date>September 2003</date> <date>September 2003</date>
<revdescription> <revdescription>
<para role="author">Sun GNOME Documentation Team</para> <para role="author">Sun GNOME Documentation Team</para>
@ -133,7 +102,7 @@ text-based commands through a shell such as Bash.
</revdescription> </revdescription>
</revision> </revision>
<revision> <revision>
<revnumber>GNOME Terminal Manual V2.5</revnumber> <revnumber>2.5</revnumber>
<date>May 2003</date> <date>May 2003</date>
<revdescription> <revdescription>
<para role="author"> <para role="author">
@ -145,7 +114,7 @@ text-based commands through a shell such as Bash.
</revdescription> </revdescription>
</revision> </revision>
<revision> <revision>
<revnumber>GNOME Terminal Manual V2.4</revnumber> <revnumber>2.4</revnumber>
<date>January 2003</date> <date>January 2003</date>
<revdescription> <revdescription>
<para role="author"> <para role="author">
@ -157,7 +126,7 @@ text-based commands through a shell such as Bash.
</revdescription> </revdescription>
</revision> </revision>
<revision> <revision>
<revnumber>GNOME Terminal Manual V2.3</revnumber> <revnumber>2.3</revnumber>
<date>August 2002</date> <date>August 2002</date>
<revdescription> <revdescription>
<para role="author"> <para role="author">
@ -169,7 +138,7 @@ text-based commands through a shell such as Bash.
</revdescription> </revdescription>
</revision> </revision>
<revision> <revision>
<revnumber>GNOME Terminal Manual V2.2</revnumber> <revnumber>2.2</revnumber>
<date>August 2002</date> <date>August 2002</date>
<revdescription> <revdescription>
<para role="author"> <para role="author">
@ -181,7 +150,7 @@ text-based commands through a shell such as Bash.
</revdescription> </revdescription>
</revision> </revision>
<revision> <revision>
<revnumber>GNOME Terminal Manual V2.1</revnumber> <revnumber>2.1</revnumber>
<date>August 2002</date> <date>August 2002</date>
<revdescription> <revdescription>
<para role="author"> <para role="author">
@ -193,7 +162,7 @@ text-based commands through a shell such as Bash.
</revdescription> </revdescription>
</revision> </revision>
<revision> <revision>
<revnumber>GNOME Terminal Manual V2.0</revnumber> <revnumber>2.0</revnumber>
<date>April 2002</date> <date>April 2002</date>
<revdescription> <revdescription>
<para role="author"> <para role="author">
@ -205,7 +174,7 @@ text-based commands through a shell such as Bash.
</revdescription> </revdescription>
</revision> </revision>
<revision> <revision>
<revnumber>GNOME Terminal User's Guide</revnumber> <revnumber>1.0</revnumber>
<date>May 2000</date> <date>May 2000</date>
<revdescription> <revdescription>
<para role="author"> <para role="author">
@ -218,32 +187,29 @@ text-based commands through a shell such as Bash.
</revdescription> </revdescription>
</revision> </revision>
</revhistory> </revhistory>
<releaseinfo> This manual describes version &appversion; of &app;.
</releaseinfo> <releaseinfo>This manual describes version 1.22 of MATE Terminal.</releaseinfo>
<legalnotice>
<title>Feedback</title> </info>
<para> To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the <ulink url="help:mate-user-guide/feedback" type="help">MATE Feedback Page</ulink>. </para>
</legalnotice>
</articleinfo>
<indexterm> <indexterm>
<primary>&app;</primary> <primary>MATE Terminal</primary>
</indexterm> </indexterm>
<indexterm> <indexterm>
<primary>terminal application</primary> <primary>terminal application</primary>
</indexterm> </indexterm>
<!-- ============= Introduction ============================== --> <!-- ============= Introduction ============================== -->
<sect1 id="mate-terminal-introduction"> <section xml:id="mate-terminal-introduction"><info><title>Introduction</title></info>
<title>Introduction</title>
<para> <para>
<application>&app;</application> is a terminal emulation application that you can use to perform the following tasks: <application>MATE Terminal</application> is a terminal emulation application that you can use to perform the following tasks:
</para> </para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>Access a UNIX shell in the MATE environment</term> <term>Access a UNIX shell in the MATE environment</term>
<listitem> <listitem>
<para> <para>
A shell is a program that interprets and executes the commands that you type at a command line prompt. When you start <application>&app;</application>, the application starts the default shell that is specified in your system account. You can switch to a different shell at any time. A shell is a program that interprets and executes the commands that you type at a command line prompt. When you start <application>MATE Terminal</application>, the application starts the default shell that is specified in your system account. You can switch to a different shell at any time.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -251,24 +217,23 @@ text-based commands through a shell such as Bash.
<term>Run any application that is designed to run on VT102, VT220, and <application>xterm</application> terminals</term> <term>Run any application that is designed to run on VT102, VT220, and <application>xterm</application> terminals</term>
<listitem> <listitem>
<para> <para>
<application>&app;</application> emulates the <application>xterm</application> application developed by the X Consortium. In turn, the <application>xterm</application> application emulates the DEC VT102 terminal and also supports the DEC VT220 escape sequences. An escape sequence is a series of characters that starts with the <keycap>Esc</keycap> character. <application>&app;</application> accepts all of the escape sequences that the VT102 and VT220 terminals use for functions such as to position the cursor and to clear the screen. <application>MATE Terminal</application> emulates the <application>xterm</application> application developed by the X Consortium. In turn, the <application>xterm</application> application emulates the DEC VT102 terminal and also supports the DEC VT220 escape sequences. An escape sequence is a series of characters that starts with the <keycap>Esc</keycap> character. <application>MATE Terminal</application> accepts all of the escape sequences that the VT102 and VT220 terminals use for functions such as to position the cursor and to clear the screen.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect1> </section>
<!--=========== Getting Started ============================== --> <!--=========== Getting Started ============================== -->
<sect1 id="mate-terminal-get-started"> <section xml:id="mate-terminal-get-started"><info><title>Getting Started</title></info>
<title>Getting Started</title>
<para> <para>
The following sections describe how to start <application>&app;</application>. The following sections describe how to start <application>MATE Terminal</application>.
</para> </para>
<sect2 id="mate-terminal-to-start">
<title>Starting &app;</title> <section xml:id="mate-terminal-to-start"><info><title>Starting MATE Terminal</title></info>
<para> <para>
You can start <application>&app;</application> in the following ways: You can start <application>MATE Terminal</application> in the following ways:
</para> </para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
@ -285,35 +250,34 @@ text-based commands through a shell such as Bash.
Execute the following command: <command>mate-terminal</command> Execute the following command: <command>mate-terminal</command>
</para> </para>
<para> <para>
You can use command line options to modify the way in which you run <application>&app;</application>. To view the command line options, execute the following command: <command>mate-terminal --help</command> You can use command line options to modify the way in which you run <application>MATE Terminal</application>. To view the command line options, execute the following command: <command>mate-terminal --help</command>
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </section>
<sect2 id="mate-terminal-first-start">
<title>When You First Start &app;</title> <section xml:id="mate-terminal-first-start"><info><title>When You First Start MATE Terminal</title></info>
<para> <para>
When you start <application>&app;</application> for the first time, the application opens a terminal window with a group of default settings. The group of default settings is called the Default profile. </para> When you start <application>MATE Terminal</application> for the first time, the application opens a terminal window with a group of default settings. The group of default settings is called the Default profile. </para>
<figure id="mate-terminal_default"> <figure xml:id="mate-terminal_default"><info><title>Example of a Default MATE Terminal Window</title></info>
<title>Example of a Default &app; Window</title>
<screenshot> <screenshot>
<screeninfo>&app; default window</screeninfo> <info><abstract><para>MATE Terminal default window</para></abstract></info>
<mediaobject> <mediaobject>
<imageobject> <imageobject>
<imagedata fileref="figures/mate-terminal-default.png" format="PNG"/> <imagedata fileref="figures/mate-terminal-default.png" format="PNG"/>
</imageobject> </imageobject>
<textobject> <textobject>
<phrase>&app; default window</phrase> <phrase>MATE Terminal default window</phrase>
</textobject> </textobject>
</mediaobject> </mediaobject>
</screenshot> </screenshot>
</figure> </figure>
<para> <para>
The terminal window displays a command prompt where you can type UNIX commands. The command prompt can be a %, #, >, $, or any other special character. The cursor is positioned at the command prompt. When you type a UNIX command and press <keycap>Return</keycap>, the computer executes the command. By default, <application>&app;</application> uses the default shell specified for the user who starts the application. The terminal window displays a command prompt where you can type UNIX commands. The command prompt can be a %, #, &gt;, $, or any other special character. The cursor is positioned at the command prompt. When you type a UNIX command and press <keycap>Return</keycap>, the computer executes the command. By default, <application>MATE Terminal</application> uses the default shell specified for the user who starts the application.
</para> </para>
<para> <para>
<application>&app;</application> also sets the following environment variables: <application>MATE Terminal</application> also sets the following environment variables:
</para> </para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
@ -335,37 +299,35 @@ text-based commands through a shell such as Bash.
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </section>
<sect2 id="mate-terminal-profiles"> <section xml:id="mate-terminal-profiles"><info><title>Terminal Profiles</title></info>
<title>Terminal Profiles</title>
<para> <para>
You can create a new profile, and apply the new profile to the terminal to modify characteristics such as font, color and effects, scroll behavior, window title, and compatibility. You can also specify a command that runs automatically when you start <application>&app;</application> in the profile. </para> You can create a new profile, and apply the new profile to the terminal to modify characteristics such as font, color and effects, scroll behavior, window title, and compatibility. You can also specify a command that runs automatically when you start <application>MATE Terminal</application> in the profile. </para>
<para>You define each terminal profile in the <guilabel>Profiles</guilabel> dialog, which you access from the <guimenu>Edit</guimenu> menu. You can define as many different profiles as you require. When you start a terminal, you can choose the profile that you want to use for the terminal. Alternatively, you can change the terminal profile while you use the terminal. To specify an initial profile for a terminal when you start the application from a command line, use the following command: </para> <para>You define each terminal profile in the <guilabel>Profiles</guilabel> dialog, which you access from the <guimenu>Edit</guimenu> menu. You can define as many different profiles as you require. When you start a terminal, you can choose the profile that you want to use for the terminal. Alternatively, you can change the terminal profile while you use the terminal. To specify an initial profile for a terminal when you start the application from a command line, use the following command: </para>
<para> <para>
<command>mate-terminal --window-with-profile=<replaceable>profilename</replaceable></command> <command>mate-terminal --window-with-profile=<replaceable>profilename</replaceable></command>
</para> </para>
<para> <para>
The name of the current profile appears in the titlebar of the <application>&app;</application>, unless you specify a different titlebar name in the <guilabel>Editing Profile</guilabel> dialog. </para> The name of the current profile appears in the titlebar of the <application>MATE Terminal</application>, unless you specify a different titlebar name in the <guilabel>Editing Profile</guilabel> dialog. </para>
<para> <para>
See <xref linkend="mate-terminal-manage-profiles"/> for information about how to define and use a new terminal profile. </para> See <xref linkend="mate-terminal-manage-profiles"/> for information about how to define and use a new terminal profile. </para>
</sect2> </section>
<sect2 id="mate-terminal-more-windows">
<title>Working With Multiple Terminals</title> <section xml:id="mate-terminal-more-windows"><info><title>Working With Multiple Terminals</title></info>
<para> <para>
<application>&app;</application> provides a tab feature that enables you to open several terminals in a single window. Each terminal opens in a separate tab. Click on the appropriate tab to display the terminal in the window. Each tabbed terminal in a window is a separate subprocess, so you can use each terminal for different tasks. You can apply a different profile to each tabbed terminal in the window. </para> <application>MATE Terminal</application> provides a tab feature that enables you to open several terminals in a single window. Each terminal opens in a separate tab. Click on the appropriate tab to display the terminal in the window. Each tabbed terminal in a window is a separate subprocess, so you can use each terminal for different tasks. You can apply a different profile to each tabbed terminal in the window. </para>
<para> <para>
The titlebar of the terminal window shows either the name of the current profile, or the name specified by the current profile. <xref linkend="mate-terminal-tabbed"/> shows a <application>&app;</application> window with four tabs. In this case, each of the four tabs has a different profile. The name of the profile in the active tab, Profile 1, appears in the titlebar. </para> The titlebar of the terminal window shows either the name of the current profile, or the name specified by the current profile. <xref linkend="mate-terminal-tabbed"/> shows a <application>MATE Terminal</application> window with four tabs. In this case, each of the four tabs has a different profile. The name of the profile in the active tab, Profile 1, appears in the titlebar. </para>
<figure id="mate-terminal-tabbed"> <figure xml:id="mate-terminal-tabbed"><info><title>Example of a Terminal Window With Tabs</title></info>
<title>Example of a Terminal Window With Tabs</title>
<screenshot> <screenshot>
<screeninfo>&app; default window</screeninfo> <info><abstract><para>MATE Terminal default window</para></abstract></info>
<mediaobject> <mediaobject>
<imageobject> <imageobject>
<imagedata fileref="figures/mate-terminal-tabbed.png" format="PNG"/> <imagedata fileref="figures/mate-terminal-tabbed.png" format="PNG"/>
</imageobject> </imageobject>
<textobject> <textobject>
<phrase>&app; window with four tabs</phrase> <phrase>MATE Terminal window with four tabs</phrase>
</textobject> </textobject>
</mediaobject> </mediaobject>
</screenshot> </screenshot>
@ -373,17 +335,15 @@ text-based commands through a shell such as Bash.
<para> <para>
See <xref linkend="mate-terminal-windows"/> for information about how to open a new tabbed terminal. See <xref linkend="mate-terminal-windows"/> for information about how to open a new tabbed terminal.
</para> </para>
</sect2> </section>
</sect1> </section>
<!--=========== Usage ============================== --> <!--=========== Usage ============================== -->
<sect1 id="mate-terminal-usage"> <section xml:id="mate-terminal-usage"><info><title>Usage</title></info>
<title>Usage</title>
<sect2 id="mate-terminal-windows"> <section xml:id="mate-terminal-windows"><info><title>Opening and Closing Terminals</title></info>
<title>Opening and Closing Terminals</title>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>To open a new terminal window:</term> <term>To open a new terminal window:</term>
@ -400,7 +360,7 @@ text-based commands through a shell such as Bash.
<para> <para>
Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Close Window</guimenuitem></menuchoice>. </para> Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Close Window</guimenuitem></menuchoice>. </para>
<para> <para>
This action closes the terminal and any subprocesses that you opened from the terminal. If you close the last terminal window, the <application>&app;</application> application exits. </para> This action closes the terminal and any subprocesses that you opened from the terminal. If you close the last terminal window, the <application>MATE Terminal</application> application exits. </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
@ -425,7 +385,7 @@ text-based commands through a shell such as Bash.
<term>To close a tabbed terminal:</term> <term>To close a tabbed terminal:</term>
<listitem> <listitem>
<para> <para>
<orderedlist> <orderedlist inheritnum="ignore" continuation="restarts">
<listitem> <listitem>
<para> <para>
Display the tabbed terminal that you want to close. Display the tabbed terminal that you want to close.
@ -440,15 +400,15 @@ text-based commands through a shell such as Bash.
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </section>
<sect2 id="mate-terminal-manage-profiles">
<title>Managing Profiles</title> <section xml:id="mate-terminal-manage-profiles"><info><title>Managing Profiles</title></info>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>To add a new profile:</term> <term>To add a new profile:</term>
<listitem> <listitem>
<para> <para>
<orderedlist> <orderedlist inheritnum="ignore" continuation="restarts">
<listitem> <listitem>
<para> <para>
Choose <menuchoice><guimenu>File</guimenu><guimenuitem>New Profile</guimenuitem></menuchoice> to display the <guilabel>New Profile</guilabel> dialog. </para> Choose <menuchoice><guimenu>File</guimenu><guimenuitem>New Profile</guimenuitem></menuchoice> to display the <guilabel>New Profile</guilabel> dialog. </para>
@ -467,7 +427,7 @@ text-based commands through a shell such as Bash.
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Click <guibutton>Close</guibutton>. <application>&app;</application> adds the profile to the <menuchoice><guimenu>Terminal</guimenu><guisubmenu>Change Profile</guisubmenu></menuchoice> submenu. </para> Click <guibutton>Close</guibutton>. <application>MATE Terminal</application> adds the profile to the <menuchoice><guimenu>Terminal</guimenu><guisubmenu>Change Profile</guisubmenu></menuchoice> submenu. </para>
</listitem> </listitem>
</orderedlist> </orderedlist>
</para> </para>
@ -477,7 +437,7 @@ text-based commands through a shell such as Bash.
<term>To change the profile of a tabbed terminal:</term> <term>To change the profile of a tabbed terminal:</term>
<listitem> <listitem>
<para> <para>
<orderedlist> <orderedlist inheritnum="ignore" continuation="restarts">
<listitem> <listitem>
<para> <para>
Click on the tab of the tabbed terminal for which you want to change the profile. </para> Click on the tab of the tabbed terminal for which you want to change the profile. </para>
@ -515,7 +475,7 @@ text-based commands through a shell such as Bash.
<term>To delete a profile:</term> <term>To delete a profile:</term>
<listitem> <listitem>
<para> <para>
<orderedlist> <orderedlist inheritnum="ignore" continuation="restarts">
<listitem> <listitem>
<para> <para>
Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Profiles</guimenuitem></menuchoice>. </para> Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Profiles</guimenuitem></menuchoice>. </para>
@ -537,9 +497,9 @@ text-based commands through a shell such as Bash.
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </section>
<sect2 id="mate-terminal-tabs">
<title>Modifying a Terminal Window</title> <section xml:id="mate-terminal-tabs"><info><title>Modifying a Terminal Window</title></info>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>To hide the menubar:</term> <term>To hide the menubar:</term>
@ -555,7 +515,7 @@ text-based commands through a shell such as Bash.
Right-click on the terminal window, then choose <guimenuitem>Show Menubar</guimenuitem> from the popup menu. </para> Right-click on the terminal window, then choose <guimenuitem>Show Menubar</guimenuitem> from the popup menu. </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry><term>To display the <application>&app;</application> window in full-screen mode:</term> <varlistentry><term>To display the <application>MATE Terminal</application> window in full-screen mode:</term>
<listitem> <listitem>
<para>Choose <menuchoice><guimenu>View</guimenu><guimenuitem>Full Screen</guimenuitem></menuchoice>. Full-screen mode displays the text in a window that fills the full screen. The window does not contain a window frame or titlebar. To exit from this mode, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Full Screen</guimenuitem></menuchoice> again.</para> <para>Choose <menuchoice><guimenu>View</guimenu><guimenuitem>Full Screen</guimenuitem></menuchoice>. Full-screen mode displays the text in a window that fills the full screen. The window does not contain a window frame or titlebar. To exit from this mode, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Full Screen</guimenuitem></menuchoice> again.</para>
</listitem> </listitem>
@ -568,9 +528,9 @@ text-based commands through a shell such as Bash.
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </section>
<sect2 id="mate-terminal-contents">
<title>Working with the Contents of Terminal Windows</title> <section xml:id="mate-terminal-contents"><info><title>Working with the Contents of Terminal Windows</title></info>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>To scroll through previous commands and output:</term> <term>To scroll through previous commands and output:</term>
@ -613,7 +573,7 @@ text-based commands through a shell such as Bash.
</listitem> </listitem>
</itemizedlist> </itemizedlist>
<para> <para>
These actions select all text between the first and last items. For all text selections, <application>&app;</application> copies the selected text into the clipboard when you release the mouse button. To explicitly copy the selected text, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice>.</para> These actions select all text between the first and last items. For all text selections, <application>MATE Terminal</application> copies the selected text into the clipboard when you release the mouse button. To explicitly copy the selected text, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
@ -645,7 +605,7 @@ text-based commands through a shell such as Bash.
<listitem> <listitem>
<para> <para>
To access a Uniform Resource Locator (URL) that is displayed in a terminal, perform the following steps: </para> To access a Uniform Resource Locator (URL) that is displayed in a terminal, perform the following steps: </para>
<orderedlist> <orderedlist inheritnum="ignore" continuation="restarts">
<listitem> <listitem>
<para> <para>
Move the mouse over the URL until the URL is underlined. </para> Move the mouse over the URL until the URL is underlined. </para>
@ -662,12 +622,11 @@ text-based commands through a shell such as Bash.
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </section>
<sect2 id="mate-terminal-shortcuts"> <section xml:id="mate-terminal-shortcuts"><info><title>Viewing the Keyboard Shortcut Settings</title></info>
<title>Viewing the Keyboard Shortcut Settings</title>
<para> <para>
To view the keyboard shortcut settings that are defined for <application>&app;</application>, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Keyboard Shortcuts</guimenuitem></menuchoice>. The <guilabel>Keyboard Shortcuts</guilabel> dialog contains the following items: </para> To view the keyboard shortcut settings that are defined for <application>MATE Terminal</application>, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Keyboard Shortcuts</guimenuitem></menuchoice>. The <guilabel>Keyboard Shortcuts</guilabel> dialog contains the following items: </para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><guilabel>Disable all menu access keys (such as Alt+f to open File menu)</guilabel></term> <term><guilabel>Disable all menu access keys (such as Alt+f to open File menu)</guilabel></term>
@ -680,7 +639,7 @@ text-based commands through a shell such as Bash.
<term><guilabel>Disable menu shortcut key (F10 by default)</guilabel></term> <term><guilabel>Disable menu shortcut key (F10 by default)</guilabel></term>
<listitem> <listitem>
<para> <para>
Deselect this option to disable the shortcut key that is defined to enable you to access the <application>&app;</application> menus. The default shortcut key to access the menus is <keycap>F10</keycap>. </para> Deselect this option to disable the shortcut key that is defined to enable you to access the <application>MATE Terminal</application> menus. The default shortcut key to access the menus is <keycap>F10</keycap>. </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
@ -692,11 +651,10 @@ text-based commands through a shell such as Bash.
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </section>
<sect2 id="mate-terminal-resize"> <section xml:id="mate-terminal-resize"><info><title>Text Size</title></info>
<title>Text Size</title> <para>You can use the following methods to resize the text in the MATE Terminal window:</para>
<para>You can use the following methods to resize the text in the &app; window:</para>
<itemizedlist> <itemizedlist>
<listitem><para>To increase the size of the text, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Zoom In</guimenuitem></menuchoice>.</para> <listitem><para>To increase the size of the text, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Zoom In</guimenuitem></menuchoice>.</para>
</listitem> </listitem>
@ -705,38 +663,34 @@ text-based commands through a shell such as Bash.
<listitem><para>To view the text at actual size, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Normal Size</guimenuitem></menuchoice>. </para> <listitem><para>To view the text at actual size, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Normal Size</guimenuitem></menuchoice>. </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</section>
</sect2> <section xml:id="mate-terminal-title"><info><title>To Change the Terminal Title</title></info>
<sect2 id="mate-terminal-title">
<title>To Change the Terminal Title</title>
<para> <para>
To change the title of the currently displayed terminal, perform the following steps:</para> To change the title of the currently displayed terminal, perform the following steps:</para>
<orderedlist> <orderedlist inheritnum="ignore" continuation="restarts">
<listitem> <listitem>
<para>Choose <menuchoice><guimenu>Terminal</guimenu><guimenuitem>Set Title</guimenuitem></menuchoice>. </para> <para>Choose <menuchoice><guimenu>Terminal</guimenu><guimenuitem>Set Title</guimenuitem></menuchoice>. </para>
</listitem> </listitem>
<listitem> <listitem>
<para>Type the new title in the <guilabel>Title</guilabel> text box. <application>&app;</application> applies the change immediately. </para> <para>Type the new title in the <guilabel>Title</guilabel> text box. <application>MATE Terminal</application> applies the change immediately. </para>
</listitem> </listitem>
<listitem> <listitem>
<para>Click <guibutton>Close</guibutton> to close the <guilabel>Set Title</guilabel> dialog. </para> <para>Click <guibutton>Close</guibutton> to close the <guilabel>Set Title</guilabel> dialog. </para>
</listitem> </listitem>
</orderedlist> </orderedlist>
</sect2> </section>
<sect2 id="mate-terminal-encoding"> <section xml:id="mate-terminal-encoding"><info><title>To Change the Character Encoding</title></info>
<title>To Change the Character Encoding</title>
<para> <para>
To change the character encoding, choose <menuchoice><guimenu>Terminal</guimenu><guisubmenu>Set Character Encoding</guisubmenu></menuchoice>, then select the appropriate encoding. To change the character encoding, choose <menuchoice><guimenu>Terminal</guimenu><guisubmenu>Set Character Encoding</guisubmenu></menuchoice>, then select the appropriate encoding.
</para> </para>
<sect3 id="mate-terminal-encoding-add"> <section xml:id="mate-terminal-encoding-add"><info><title>To Change the List of Character Encodings</title></info>
<title>To Change the List of Character Encodings</title>
<para> <para>
To change the list of character encodings displayed in the <guisubmenu>Set Character Encoding</guisubmenu> menu, perform the following steps: To change the list of character encodings displayed in the <guisubmenu>Set Character Encoding</guisubmenu> menu, perform the following steps:
</para> </para>
<orderedlist> <orderedlist inheritnum="ignore" continuation="restarts">
<listitem> <listitem>
<para>Choose <menuchoice><guimenu>Terminal</guimenu><guisubmenu>Set Character Encoding</guisubmenu><guimenuitem>Add or Remove</guimenuitem></menuchoice>. <para>Choose <menuchoice><guimenu>Terminal</guimenu><guisubmenu>Set Character Encoding</guisubmenu><guimenuitem>Add or Remove</guimenuitem></menuchoice>.
</para> </para>
@ -753,12 +707,11 @@ text-based commands through a shell such as Bash.
<para>Click <guibutton>Close</guibutton> to close the <guilabel>Add or Remove Terminal Encodings</guilabel> dialog. </para> <para>Click <guibutton>Close</guibutton> to close the <guilabel>Add or Remove Terminal Encodings</guilabel> dialog. </para>
</listitem> </listitem>
</orderedlist> </orderedlist>
</sect3> </section>
</sect2> </section>
<sect2 id="mate-terminal-reset"> <section xml:id="mate-terminal-reset"><info><title>To Recover Your Terminal</title></info>
<title>To Recover Your Terminal</title>
<para> <para>
This section provides some advice if you have problems with terminals. This section provides some advice if you have problems with terminals.
</para> </para>
@ -781,18 +734,17 @@ text-based commands through a shell such as Bash.
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </section>
</sect1> </section>
<!--=========== Preferences ============================== --> <!--=========== Preferences ============================== -->
<sect1 id="mate-terminal-prefs"> <section xml:id="mate-terminal-prefs"><info><title>Preferences</title></info>
<title>Preferences</title>
<para> <para>
To configure <application>&app;</application>, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Current Profile</guimenuitem></menuchoice>. To configure another profile that you set up choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Profiles</guimenuitem></menuchoice>, select the profile you want to edit, then click <guibutton>Edit</guibutton>. </para> To configure <application>MATE Terminal</application>, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Current Profile</guimenuitem></menuchoice>. To configure another profile that you set up choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Profiles</guimenuitem></menuchoice>, select the profile you want to edit, then click <guibutton>Edit</guibutton>. </para>
<para> <para>
The <guilabel>Editing Profile</guilabel> dialog contains the following tabbed sections that you can use to configure <application>&app;</application>: </para> The <guilabel>Editing Profile</guilabel> dialog contains the following tabbed sections that you can use to configure <application>MATE Terminal</application>: </para>
<itemizedlist> <itemizedlist>
<listitem><para><xref linkend="mate-terminal-prefs-general"/></para> <listitem><para><xref linkend="mate-terminal-prefs-general"/></para>
</listitem> </listitem>
@ -808,9 +760,7 @@ text-based commands through a shell such as Bash.
</listitem> </listitem>
</itemizedlist> </itemizedlist>
<section xml:id="mate-terminal-prefs-general"><info><title>General</title></info>
<sect2 id="mate-terminal-prefs-general">
<title>General</title>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term> <term>
@ -871,15 +821,14 @@ text-based commands through a shell such as Bash.
<guilabel>Select-by-word characters</guilabel> </term> <guilabel>Select-by-word characters</guilabel> </term>
<listitem> <listitem>
<para> <para>
Use this text box to specify characters or groups of characters that <application>&app;</application> considers to be words when you select text by word. See <xref linkend="mate-terminal-contents"/> for more information about how to select text by word. Use this text box to specify characters or groups of characters that <application>MATE Terminal</application> considers to be words when you select text by word. See <xref linkend="mate-terminal-contents"/> for more information about how to select text by word.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </section>
<sect2 id="mate-terminal-prefs-title">
<title>Title and Command</title> <section xml:id="mate-terminal-prefs-title"><info><title>Title and Command</title></info>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term> <term>
@ -937,9 +886,9 @@ text-based commands through a shell such as Bash.
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </section>
<sect2 id="mate-terminal-prefs-colors">
<title>Colours</title> <section xml:id="mate-terminal-prefs-colors"><info><title>Colours</title></info>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term> <term>
@ -947,10 +896,10 @@ text-based commands through a shell such as Bash.
</term> </term>
<listitem> <listitem>
<para> <para>
Select the <guilabel>Use colours from system theme</guilabel> option to use the colors that are specified in the MATE Desktop theme that is selected in the <guilabel>Theme</guilabel> tab of the <ulink type="help" url="help:mate-user-guide/prefs-theme"><application>Appearance</application> preference tool</ulink>. Select the <guilabel>Use colours from system theme</guilabel> option to use the colors that are specified in the MATE Desktop theme that is selected in the <guilabel>Theme</guilabel> tab of the <link xlink:href="help:mate-user-guide/prefs-theme"><application>Appearance</application> preference tool</link>.
</para> </para>
<para> <para>
Use the <guilabel>Built-in schemes</guilabel> drop-down list to specify the foreground and background colors for the terminal. <application>&app;</application> supports the following foreground and background color combinations: Use the <guilabel>Built-in schemes</guilabel> drop-down list to specify the foreground and background colors for the terminal. <application>MATE Terminal</application> supports the following foreground and background color combinations:
</para> </para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
@ -1010,9 +959,9 @@ text-based commands through a shell such as Bash.
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </section>
<sect2 id="mate-terminal-prefs-effects">
<title>Effects</title> <section xml:id="mate-terminal-prefs-effects"><info><title>Effects</title></info>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term> <term>
@ -1061,10 +1010,9 @@ text-based commands through a shell such as Bash.
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </section>
<sect2 id="mate-terminal-prefs-scrolling"> <section xml:id="mate-terminal-prefs-scrolling"><info><title>Scrolling</title></info>
<title>Scrolling</title>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term> <term>
@ -1103,10 +1051,9 @@ text-based commands through a shell such as Bash.
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </section>
<sect2 id="mate-terminal-prefs-compatibility"> <section xml:id="mate-terminal-prefs-compatibility"><info><title>Compatibility</title></info>
<title>Compatibility</title>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term> <term>
@ -1136,6 +1083,6 @@ text-based commands through a shell such as Bash.
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </section>
</sect1> </section>
</article> </article>

12
help/C/legal.xml
View File

@ -1,12 +1,13 @@
<legalnotice id="legalnotice"> <legalnotice xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0" xml:id="legalnotice" xml:lang="en">
<para> <para>
Permission is granted to copy, distribute and/or modify this Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation document under the terms of the GNU Free Documentation
License (GFDL), Version 1.1 or any later version published License (GFDL), Version 1.1 or any later version published
by the Free Software Foundation with no Invariant Sections, by the Free Software Foundation with no Invariant Sections,
no Front-Cover Texts, and no Back-Cover Texts. You can find no Front-Cover Texts, and no Back-Cover Texts. You can find
a copy of the GFDL at this <ulink type="help" a copy of the GFDL at this <link xlink:href="help:fdl" type="help">link</link> or in the file COPYING-DOCS
url="help:fdl">link</ulink> or in the file COPYING-DOCS
distributed with this manual. distributed with this manual.
</para> </para>
<para> This manual is part of a collection of MATE manuals <para> This manual is part of a collection of MATE manuals
@ -72,5 +73,8 @@
</listitem> </listitem>
</orderedlist> </orderedlist>
</para> </para>
<formalpara>
<title>Feedback</title>
<para>To report a bug or make a suggestion regarding the MATE Terminal application or this manual, follow the directions in the <link xlink:href="help:mate-user-guide/feedback">MATE Feedback Page</link>.</para>
</formalpara>
</legalnotice> </legalnotice>