Rewrite manpage: mate-terminal.1

master-1.22
Abel McClendon 2014-12-15 09:41:22 -06:00 committed by infirit
parent 73634ff66f
commit 8e837bc071
1 changed files with 147 additions and 98 deletions

View File

@ -1,101 +1,150 @@
.\" mate-terminal manual page .TH MATE-TERMINAL "1" "11 December 2014" "MATE Desktop Environment" "User Commands"
.TH "MATE-TERMINAL" 1 "12 February 2014" "MATE Desktop Environment"
.\" Please adjust this date whenever revising the manpage. .\" Please adjust this date whenever revising the manpage.
.\" .\"
.SH "NAME" .SH NAME
mate-terminal \- The MATE Terminal Emulator mate-terminal \- manual page for MATE Terminal Emulator
.SH "SYNOPSIS" .SH DESCRIPTION
\fBmate-terminal\fR [\fB-e, \-\-command\fI=STRING\fR\fP] [\fB\-\-window-with-profile\fI=PROFILENAME\fR\fP] [\fB\-\-tab-with-profile\fI=PROFILENAME\fR\fP] [\fB\-\-window-with-profile-internal-id\fI=PROFILEID\fR\fP] [\fB\-\-tab-with-profile-internal-id\fI=PROFILEID\fR\fP] [\fB\-\-role\fI=ROLE\fR\fP] [\fB\-\-show-menubar\fP] [\fB\-\-hide-menubar\fP] [\fB\-\-geometry\fI=GEOMETRY\fR\fP] [\fB\-\-disable-factory\fP] [\fB-t, \-\-title\fI=TITLE\fR\fP] [\fB\-\-working-directory\fI=DIRNAME\fR\fP] [\fB-?, \-\-help\fP] .SS "Usage:"
.SH "DESCRIPTION" .IP
.SS MATE Terminal is a terminal emulation application that you can use to perform the following actions: mate\-terminal [OPTION...]
.PP .SS "Help Options:"
Access a UNIX shell in the MATE environment. .TP
.PP \fB\-h\fR, \fB\-\-help\fR
A shell is a program that interprets and executes the commands Show help options
that you type at a command line prompt. When you start MATE Terminal, .TP
the application starts the default shell that is specified in your \fB\-\-help\-all\fR
system account. You can switch to a different shell at any Show all help options
time. .TP
.PP \fB\-\-help\-terminal\fR
Run any application that is designed to run on VT102, VT220, Show terminal options
and xterm terminals. .TP
.PP \fB\-\-help\-window\-options\fR
MATE Terminal emulates the xterm program developed by the X Show per\-window options
Consortium. In turn, the xterm program emulates the DEC VT102 terminal .TP
and also supports the DEC VT220 escape sequences. An escape sequence \fB\-\-help\-terminal\-options\fR
is a series of characters that starts with the Esc character. Show per\-terminal options
.PP .TP
MATE Terminal accepts all of the escape sequences that the VT102 \fB\-\-help\-gtk\fR
and VT220 terminals use for functions such as positioning the cursor Show GTK+ Options
and clearing the screen. .TP
.SH "OPTIONS" \fB\-\-help\-sm\-client\fR
.IP "\fB\-e, \-\-command=\fISTRING\fR\fP" 7 Show session management options
Execute the argument to this option inside the terminal. .SS "Options to open new windows or terminal tabs; more than one of these may be specified:"
.IP "\fB\-\-window-with-profile=\fIPROFILENAME\fR\fP" .TP
Open a new window containing a tab with the given profile. \fB\-\-window\fR
More than one of these options can be provided. Open a new window containing a tab with the default profile
.IP "\fB\-\-tab-with-profile=\fIPROFILENAME\fR\fP" .TP
Open a tab in the window with the given profile. More than \fB\-\-tab\fR
one of these options can be provided, to open Open a new tab in the last\-opened window with the default profile
several tabs . .SS "Window options; if used before the first --window or --tab argument, sets the default for all windows:"
.IP "\fB\-\-window-with-profile-internal-id=\fIPROFILEID\fR\fP" .TP
Open a new window containing a tab with the given profile \fB\-\-show\-menubar\fR
ID. Used internally to save sessions. Turn on the menubar
.IP "\fB\-\-tab-with-profile-internal-id=\fIPROFILEID\fR\fP" .TP
Open a tab in the window with the given profile ID. \fB\-\-hide\-menubar\fR
Used internally to save sessions. Turn off the menubar
.IP "\fB\-\-tab\fP" .TP
.br \fB\-\-maximize\fR
Open a new tab in the last-opened window with the default profile. Maximize the window
.IP "\fB\-\-window\fP" .TP
Open a new window containing a tab with the default profile. \fB\-\-full\-screen\fR
.IP "\fB\-\-role=\fIROLE\fR\fP" Full\-screen the window
Set the role for the last-specified window; applies to only .TP
one window; can be specified once for each window you create \fB\-\-geometry\fR=\fIGEOMETRY\fR
from the command line. Set the window size; for example: 80x24, or 80x24+200+200 (ROWSxCOLS+X+Y)
.IP "\fB\-\-active\fP" .TP
Set the last specified tab as the active one in its window. \fB\-\-role\fR=\fIROLE\fR
.IP "\fB\-\-show-menubar\fP" Set the window role
Turn on the menu bar for the last-specified window; applies .TP
to only one window; can be specified once for each window you \fB\-\-active\fR
create from the command line. Set the last specified tab as the active one in its window
.IP "\fB\-\-hide-menubar\fP" .SS "Terminal options; if used before the first --window or --tab argument, sets the default for all terminals:"
Turn off the menu bar for the last-specified window; applies .TP
to only one window; can be specified once for each window you \fB\-e\fR, \fB\-\-command\fR
create from the command line. Execute the argument to this option inside the terminal
.IP "\fB\-\-maximize\fP" .TP
Open a new maximized terminal window. \fB\-\-profile\fR=\fIPROFILE\-NAME\fR
.IP "\fB\-\-fullscreen\fP" Use the given profile instead of the default profile
Open a new fullscreen terminal window. .TP
.IP "\fB\-\-geometry=\fIGEOMETRY\fR\fP" \fB\-t\fR, \fB\-\-title\fR=\fITITLE\fR
X geometry specification (see "X" man page), can be Set the terminal title
specified once per window to be opened. .TP
.IP "\fB\-\-disable-factory\fP" \fB\-\-working\-directory\fR=\fIDIRNAME\fR
Do not register with the activation name server, do not Set the working directory
re-use an active terminal. .TP
.IP "\fB\-t, \-\-title=\fITITLE\fR\fP" \fB\-\-zoom\fR=\fIZOOM\fR
Set the terminal's title to \fITITLE\fR.
.IP "\fB\-\-working-directory=\fIDIRNAME\fR\fP"
Set the terminal's working directory to \fIDIRNAME\fR.
.IP "\fB\-\-zoom=\fIZOOM\fR\fP"
Set the terminal's zoom factor (1.0 = normal size) Set the terminal's zoom factor (1.0 = normal size)
.IP "\fB\-?, \-h \-\-help\fP" .PP
Show help message. GTK+ Options
.IP "\fB\-\-help\-terminal\fP" .TP
Print terminal options. \fB\-\-class\fR=\fICLASS\fR
.IP "\fB\-\-help\-window-options\fP" Program class as used by the window manager
Print window options. .TP
.IP "\fB\-\-help\-all\fP" \fB\-\-name\fR=\fINAME\fR
Show all help options. Program name as used by the window manager
.SH "BUGS" .TP
.SS Should you encounter any bugs, they may be reported at: \fB\-\-screen\fR=\fISCREEN\fR
http://github.com/mate-desktop/mate-terminal/issues X screen to use
.SH "AUTHOR" .TP
.SS This manual page was originally written by for the Debian GNU/Linux system by: \fB\-\-sync\fR
Christian Marillat <marillat@debian.org> (2013) Make X calls synchronous
.SS It has been updated for the MATE Desktop Environment by: .TP
Adam Erdman <hekel@archlinux.info> (2014) \fB\-\-gtk\-module\fR=\fIMODULES\fR
.SH "SEE ALSO" Load additional GTK+ modules
.SS .TP
MATE Terminal documentation can be found from the "Help" menu, or by pressing the F1 key. \fB\-\-g\-fatal\-warnings\fR
Further information may also be available at: http://wiki.mate-desktop.org/docs Make all warnings fatal
.SS "Session management options:"
.TP
\fB\-\-sm\-client\-disable\fR
Disable connection to session manager
.TP
\fB\-\-sm\-client\-state\-file\fR=\fIFILE\fR
Specify file containing saved configuration
.TP
\fB\-\-sm\-client\-id\fR=\fIID\fR
Specify session management ID
.SS "Application Options:"
.TP
\fB\-\-disable\-factory\fR
Do not register with the activation nameserver, do not re\-use an active terminal
.TP
\fB\-\-load\-config\fR=\fIFILE\fR
Load a terminal configuration file
.TP
\fB\-\-save\-config\fR=\fIFILE\fR
Save the terminal configuration to a file
.TP
\fB\-\-display\fR=\fIDISPLAY\fR
X display to use
.PP
.SH "Author"
Adam Erdman <hekel@archlinux.info> (2014) and Abel McClendon <hcmmac@hosscomm.com> (2014)
.P
for the
.B Mate Documentation Team.
.SH "See Also"
The full documentation for
.B mate-terminal
is maintained as a Texinfo manual.
.PP
If the
.B info
and
.B mate-terminal
programs are properly installed at your site, the command
.IP
.B info mate-terminal
.PP
should give you access to the complete manual.
.PP
More
.B MATE Terminal
documentation can be found from the
.B "Help"
menu, or by pressing the
.B F1
key.
.PP
Further information may also be available at:
.B http://wiki.mate-desktop.org/docs