From 11909bfdfe0af08ad2494c985957339739b9112f Mon Sep 17 00:00:00 2001 From: rbuj Date: Sun, 7 Apr 2019 14:43:25 +0200 Subject: 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 --- help/C/index.docbook | 385 ++++++++++++++++++++++----------------------------- help/C/legal.xml | 14 +- 2 files changed, 175 insertions(+), 224 deletions(-) diff --git a/help/C/index.docbook b/help/C/index.docbook index 2cc57cb..e66d292 100644 --- a/help/C/index.docbook +++ b/help/C/index.docbook @@ -1,28 +1,13 @@ - - - - - - -]> - - -
- - &app; Manual - - - The Terminal gives users the power to communicate with their system using -text-based commands through a shell such as Bash. - - + + +
+ + MATE Terminal Manual + 2019 MATE Documentation Project @@ -56,51 +41,35 @@ text-based commands through a shell such as Bash. MATE Documentation Project - &legal; + + + + - - MATE Documentation Team - + MATE Documentation Team MATE DESKTOP - - - - Sun - GNOME Documentation Team - + + SunGNOME Documentation Team Sun Microsystems - - - - Miguel - de Icaza - + + Miguelde Icaza GNOME Documentation Project - - - - Michael - Zucchi - + + MichaelZucchi GNOME Documentation Project - - - - Alexander - Kirillov - + + AlexanderKirillov GNOME Documentation Project - - + + GNOME Documentation Project - - + - GNOME Terminal Manual V2.9 + 2.9 January 2010 Paul Cutler @@ -109,7 +78,7 @@ text-based commands through a shell such as Bash. - GNOME Terminal Manual V2.8 + 2.8 March 2009 Paul Cutler @@ -117,7 +86,7 @@ text-based commands through a shell such as Bash. - GNOME Terminal Manual V2.7 + 2.7 November 2003 Sun GNOME Documentation Team @@ -125,7 +94,7 @@ text-based commands through a shell such as Bash. - GNOME Terminal Manual V2.6 + 2.6 September 2003 Sun GNOME Documentation Team @@ -133,7 +102,7 @@ text-based commands through a shell such as Bash. - GNOME Terminal Manual V2.5 + 2.5 May 2003 @@ -144,8 +113,8 @@ text-based commands through a shell such as Bash. - - GNOME Terminal Manual V2.4 + + 2.4 January 2003 @@ -157,7 +126,7 @@ text-based commands through a shell such as Bash. - GNOME Terminal Manual V2.3 + 2.3 August 2002 @@ -169,7 +138,7 @@ text-based commands through a shell such as Bash. - GNOME Terminal Manual V2.2 + 2.2 August 2002 @@ -181,7 +150,7 @@ text-based commands through a shell such as Bash. - GNOME Terminal Manual V2.1 + 2.1 August 2002 @@ -193,7 +162,7 @@ text-based commands through a shell such as Bash. - GNOME Terminal Manual V2.0 + 2.0 April 2002 @@ -205,7 +174,7 @@ text-based commands through a shell such as Bash. - GNOME Terminal User's Guide + 1.0 May 2000 @@ -218,32 +187,29 @@ text-based commands through a shell such as Bash. - This manual describes version &appversion; of &app;. - - - Feedback - To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the MATE Feedback Page. - - + + This manual describes version 1.22 of MATE Terminal. + + + - &app; + MATE Terminal terminal application - - Introduction +
Introduction - &app; is a terminal emulation application that you can use to perform the following tasks: + MATE Terminal is a terminal emulation application that you can use to perform the following tasks: Access a UNIX shell in the MATE environment - A shell is a program that interprets and executes the commands that you type at a command line prompt. When you start &app;, 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 MATE Terminal, the application starts the default shell that is specified in your system account. You can switch to a different shell at any time. @@ -251,24 +217,23 @@ text-based commands through a shell such as Bash. Run any application that is designed to run on VT102, VT220, and xterm terminals - &app; emulates the xterm application developed by the X Consortium. In turn, the xterm 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 Esc character. &app; 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. + MATE Terminal emulates the xterm application developed by the X Consortium. In turn, the xterm 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 Esc character. MATE Terminal 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. - +
- - Getting Started +
Getting Started - The following sections describe how to start &app;. + The following sections describe how to start MATE Terminal. - - Starting &app; + +
Starting MATE Terminal - You can start &app; in the following ways: + You can start MATE Terminal in the following ways: @@ -285,35 +250,34 @@ text-based commands through a shell such as Bash. Execute the following command: mate-terminal - You can use command line options to modify the way in which you run &app;. To view the command line options, execute the following command: mate-terminal --help + You can use command line options to modify the way in which you run MATE Terminal. To view the command line options, execute the following command: mate-terminal --help - - - When You First Start &app; +
+ +
When You First Start MATE Terminal - When you start &app; 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. -
- Example of a Default &app; Window - - &app; default window - + When you start MATE Terminal 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. +
Example of a Default MATE Terminal Window + + MATE Terminal default window + - &app; default window + MATE Terminal default window
- 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 Return, the computer executes the command. By default, &app; 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 %, #, >, $, or any other special character. The cursor is positioned at the command prompt. When you type a UNIX command and press Return, the computer executes the command. By default, MATE Terminal uses the default shell specified for the user who starts the application. - &app; also sets the following environment variables: + MATE Terminal also sets the following environment variables: @@ -335,37 +299,35 @@ text-based commands through a shell such as Bash. - +
- - Terminal Profiles +
Terminal Profiles - 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 &app; in the profile. + 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 MATE Terminal in the profile. You define each terminal profile in the Profiles dialog, which you access from the Edit 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: mate-terminal --window-with-profile=profilename - The name of the current profile appears in the titlebar of the &app;, unless you specify a different titlebar name in the Editing Profile dialog. + The name of the current profile appears in the titlebar of the MATE Terminal, unless you specify a different titlebar name in the Editing Profile dialog. See for information about how to define and use a new terminal profile. - - - Working With Multiple Terminals +
+ +
Working With Multiple Terminals - &app; 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. + MATE Terminal 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. - The titlebar of the terminal window shows either the name of the current profile, or the name specified by the current profile. shows a &app; 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. -
- Example of a Terminal Window With Tabs + The titlebar of the terminal window shows either the name of the current profile, or the name specified by the current profile. shows a MATE Terminal 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. +
Example of a Terminal Window With Tabs - &app; default window + MATE Terminal default window - &app; window with four tabs + MATE Terminal window with four tabs @@ -373,17 +335,15 @@ text-based commands through a shell such as Bash. See for information about how to open a new tabbed terminal. - +
- +
- - Usage +
Usage - - Opening and Closing Terminals +
Opening and Closing Terminals To open a new terminal window: @@ -400,7 +360,7 @@ text-based commands through a shell such as Bash. Choose FileClose Window. - This action closes the terminal and any subprocesses that you opened from the terminal. If you close the last terminal window, the &app; application exits. + This action closes the terminal and any subprocesses that you opened from the terminal. If you close the last terminal window, the MATE Terminal application exits. @@ -425,7 +385,7 @@ text-based commands through a shell such as Bash. To close a tabbed terminal: - + Display the tabbed terminal that you want to close. @@ -440,15 +400,15 @@ text-based commands through a shell such as Bash. - - - Managing Profiles +
+ +
Managing Profiles To add a new profile: - + Choose FileNew Profile to display the New Profile dialog. @@ -467,7 +427,7 @@ text-based commands through a shell such as Bash. - Click Close. &app; adds the profile to the TerminalChange Profile submenu. + Click Close. MATE Terminal adds the profile to the TerminalChange Profile submenu. @@ -477,7 +437,7 @@ text-based commands through a shell such as Bash. To change the profile of a tabbed terminal: - + Click on the tab of the tabbed terminal for which you want to change the profile. @@ -515,7 +475,7 @@ text-based commands through a shell such as Bash. To delete a profile: - + Choose EditProfiles. @@ -537,9 +497,9 @@ text-based commands through a shell such as Bash. - - - Modifying a Terminal Window +
+ +
Modifying a Terminal Window To hide the menubar: @@ -555,7 +515,7 @@ text-based commands through a shell such as Bash. Right-click on the terminal window, then choose Show Menubar from the popup menu. - To display the &app; window in full-screen mode: + To display the MATE Terminal window in full-screen mode: Choose ViewFull Screen. 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 ViewFull Screen again. @@ -568,9 +528,9 @@ text-based commands through a shell such as Bash. - - - Working with the Contents of Terminal Windows +
+ +
Working with the Contents of Terminal Windows To scroll through previous commands and output: @@ -613,7 +573,7 @@ text-based commands through a shell such as Bash. - These actions select all text between the first and last items. For all text selections, &app; copies the selected text into the clipboard when you release the mouse button. To explicitly copy the selected text, choose EditCopy. + These actions select all text between the first and last items. For all text selections, MATE Terminal copies the selected text into the clipboard when you release the mouse button. To explicitly copy the selected text, choose EditCopy. @@ -645,7 +605,7 @@ text-based commands through a shell such as Bash. To access a Uniform Resource Locator (URL) that is displayed in a terminal, perform the following steps: - + Move the mouse over the URL until the URL is underlined. @@ -662,12 +622,11 @@ text-based commands through a shell such as Bash. - +
- - Viewing the Keyboard Shortcut Settings +
Viewing the Keyboard Shortcut Settings - To view the keyboard shortcut settings that are defined for &app;, choose EditKeyboard Shortcuts. The Keyboard Shortcuts dialog contains the following items: + To view the keyboard shortcut settings that are defined for MATE Terminal, choose EditKeyboard Shortcuts. The Keyboard Shortcuts dialog contains the following items: Disable all menu access keys (such as Alt+f to open File menu) @@ -680,7 +639,7 @@ text-based commands through a shell such as Bash. Disable menu shortcut key (F10 by default) - Deselect this option to disable the shortcut key that is defined to enable you to access the &app; menus. The default shortcut key to access the menus is F10. + Deselect this option to disable the shortcut key that is defined to enable you to access the MATE Terminal menus. The default shortcut key to access the menus is F10. @@ -692,11 +651,10 @@ text-based commands through a shell such as Bash. - +
- - Text Size - You can use the following methods to resize the text in the &app; window: +
Text Size + You can use the following methods to resize the text in the MATE Terminal window: To increase the size of the text, choose ViewZoom In. @@ -705,60 +663,55 @@ text-based commands through a shell such as Bash. To view the text at actual size, choose ViewNormal Size. +
- - - - To Change the Terminal Title +
To Change the Terminal Title To change the title of the currently displayed terminal, perform the following steps: - + Choose TerminalSet Title. - Type the new title in the Title text box. &app; applies the change immediately. + Type the new title in the Title text box. MATE Terminal applies the change immediately. Click Close to close the Set Title dialog. - +
- - To Change the Character Encoding +
To Change the Character Encoding To change the character encoding, choose TerminalSet Character Encoding, then select the appropriate encoding. - - To Change the List of Character Encodings - - To change the list of character encodings displayed in the Set Character Encoding menu, perform the following steps: - - - - Choose TerminalSet Character EncodingAdd or Remove. - - - - To add an encoding to the Set Character Encoding menu, select the encoding in the Available encodings list box, then click the right arrow button. - - - - To remove an encoding from the Set Character Encoding menu, select the encoding in the Encodings shown in menu list box, then click the left arrow button. - - - - Click Close to close the Add or Remove Terminal Encodings dialog. - - - +
To Change the List of Character Encodings + + To change the list of character encodings displayed in the Set Character Encoding menu, perform the following steps: + + + + Choose TerminalSet Character EncodingAdd or Remove. + + + + To add an encoding to the Set Character Encoding menu, select the encoding in the Available encodings list box, then click the right arrow button. + + + + To remove an encoding from the Set Character Encoding menu, select the encoding in the Encodings shown in menu list box, then click the left arrow button. + + + + Click Close to close the Add or Remove Terminal Encodings dialog. + + +
- +
- - To Recover Your Terminal +
To Recover Your Terminal This section provides some advice if you have problems with terminals. @@ -781,18 +734,17 @@ text-based commands through a shell such as Bash. - +
- +
- - Preferences +
Preferences - To configure &app;, choose EditCurrent Profile. To configure another profile that you set up choose EditProfiles, select the profile you want to edit, then click Edit. + To configure MATE Terminal, choose EditCurrent Profile. To configure another profile that you set up choose EditProfiles, select the profile you want to edit, then click Edit. - The Editing Profile dialog contains the following tabbed sections that you can use to configure &app;: + The Editing Profile dialog contains the following tabbed sections that you can use to configure MATE Terminal: @@ -808,9 +760,7 @@ text-based commands through a shell such as Bash. - - - General +
General @@ -871,15 +821,14 @@ text-based commands through a shell such as Bash. Select-by-word characters - Use this text box to specify characters or groups of characters that &app; considers to be words when you select text by word. See for more information about how to select text by word. + Use this text box to specify characters or groups of characters that MATE Terminal considers to be words when you select text by word. See for more information about how to select text by word. - - - - Title and Command +
+ +
Title and Command @@ -937,20 +886,20 @@ text-based commands through a shell such as Bash. - - - Colours +
+ +
Colours - + Foreground and Background - Select the Use colours from system theme option to use the colors that are specified in the MATE Desktop theme that is selected in the Theme tab of the Appearance preference tool. + Select the Use colours from system theme option to use the colors that are specified in the MATE Desktop theme that is selected in the Theme tab of the Appearance preference tool. - Use the Built-in schemes drop-down list to specify the foreground and background colors for the terminal. &app; supports the following foreground and background color combinations: + Use the Built-in schemes drop-down list to specify the foreground and background colors for the terminal. MATE Terminal supports the following foreground and background color combinations: @@ -1010,9 +959,9 @@ text-based commands through a shell such as Bash. - - - Effects +
+ +
Effects @@ -1061,12 +1010,11 @@ text-based commands through a shell such as Bash. - +
- - Scrolling - - +
Scrolling + + Scrollbar is @@ -1102,11 +1050,10 @@ text-based commands through a shell such as Bash. - - + +
- - Compatibility +
Compatibility @@ -1136,6 +1083,6 @@ text-based commands through a shell such as Bash. - - -
+ + +
\ No newline at end of file diff --git a/help/C/legal.xml b/help/C/legal.xml index fe75213..4f4ba22 100644 --- a/help/C/legal.xml +++ b/help/C/legal.xml @@ -1,12 +1,13 @@ - + Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find - a copy of the GFDL at this link or in the file COPYING-DOCS + a copy of the GFDL at this link or in the file COPYING-DOCS distributed with this manual. This manual is part of a collection of MATE manuals @@ -72,5 +73,8 @@ - - \ No newline at end of file + + Feedback + To report a bug or make a suggestion regarding the MATE Terminal application or this manual, follow the directions in the MATE Feedback Page. + + \ No newline at end of file -- cgit v1.2.1