Merge pull request #733 from Vulcalien/asciidoc-manpages
Rewrite terminator.1 man page in AsciiDoc format
This commit is contained in:
Matt Rose
GitHub
commit
4ec2add3e3
689
doc/terminator.1
689
doc/terminator.1
|
|
@ -1,286 +1,481 @@
|
||||||
.TH "TERMINATOR" "1" "Jan 5, 2008" "" ""
|
'\" t
|
||||||
|
.\" Title: terminator
|
||||||
|
.\" Author: [see the "AUTHOR(S)" section]
|
||||||
|
.\" Generator: Asciidoctor 2.0.18
|
||||||
|
.\" Date: 2023-03-30
|
||||||
|
.\" Manual: Manual for Terminator
|
||||||
|
.\" Source: Terminator
|
||||||
|
.\" Language: English
|
||||||
|
.\"
|
||||||
|
.TH "TERMINATOR" "1" "2023-03-30" "Terminator" "Manual for Terminator"
|
||||||
|
.ie \n(.g .ds Aq \(aq
|
||||||
|
.el .ds Aq '
|
||||||
|
.ss \n[.ss] 0
|
||||||
|
.nh
|
||||||
|
.ad l
|
||||||
|
.de URL
|
||||||
|
\fI\\$2\fP <\\$1>\\$3
|
||||||
|
..
|
||||||
|
.als MTO URL
|
||||||
|
.if \n[.g] \{\
|
||||||
|
. mso www.tmac
|
||||||
|
. am URL
|
||||||
|
. ad l
|
||||||
|
. .
|
||||||
|
. am MTO
|
||||||
|
. ad l
|
||||||
|
. .
|
||||||
|
. LINKSTYLE blue R < >
|
||||||
|
.\}
|
||||||
.SH "NAME"
|
.SH "NAME"
|
||||||
Terminator \- Multiple GNOME terminals in one window
|
terminator \- multiple GNOME terminals in one window
|
||||||
.SH "SYNOPSIS"
|
.SH "SYNOPSIS"
|
||||||
.B terminator
|
.sp
|
||||||
.RI [ options ]
|
\fBterminator\fP [\fIoptions\fP]
|
||||||
.br
|
|
||||||
.SH "DESCRIPTION"
|
.SH "DESCRIPTION"
|
||||||
|
.sp
|
||||||
This manual page documents \fBTerminator\fP, a terminal emulator application.
|
This manual page documents \fBTerminator\fP, a terminal emulator application.
|
||||||
.PP
|
.sp
|
||||||
\fBTerminator\fP is a program that allows users to set up flexible
|
\fBTerminator\fP is a program that allows users to set up flexible
|
||||||
arrangements of GNOME terminals. It is aimed at those who normally
|
arrangements of GNOME terminals. It is aimed at those who normally
|
||||||
arrange lots of terminals near each other, but don't want to use a
|
arrange lots of terminals near each other, but don\(cqt want to use a
|
||||||
frame based window manager.
|
frame based window manager.
|
||||||
.SH "OPTIONS"
|
.SH "OPTIONS"
|
||||||
|
.sp
|
||||||
This program follows the usual GNU command line syntax, with long
|
This program follows the usual GNU command line syntax, with long
|
||||||
options starting with two dashes (`\-').
|
options starting with two dashes (`\-\*(Aq).
|
||||||
A summary of options is included below.
|
A summary of options is included below.
|
||||||
.TP
|
.sp
|
||||||
.B \-h, \-\-help
|
\fB\-h\fP, \fB\-\-help\fP
|
||||||
Show summary of options
|
.RS 4
|
||||||
.TP
|
Show summary of options.
|
||||||
.B \-v, \-\-version
|
.RE
|
||||||
Show the version of the Terminator installation
|
.sp
|
||||||
.TP
|
\fB\-v\fP, \fB\-\-version\fP
|
||||||
.B \-m, \-\-maximise
|
.RS 4
|
||||||
Start with a maximised window
|
Show the version of the Terminator installation.
|
||||||
.B \-M, \-\-maximize
|
.RE
|
||||||
Start with a maximized window
|
.sp
|
||||||
.TP
|
\fB\-m\fP, \fB\-M\fP, \fB\-\-maximise\fP, \fB\-\-maximize\fP
|
||||||
.B \-f, \-\-fullscreen
|
.RS 4
|
||||||
Start with a fullscreen window
|
Start with a maximised window.
|
||||||
.TP
|
.RE
|
||||||
.B \-b, \-\-borderless
|
.sp
|
||||||
|
\fB\-f\fP, \fB\-\-fullscreen\fP
|
||||||
|
.RS 4
|
||||||
|
Start with a fullscreen window.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fB\-b\fP, \fB\-\-borderless\fP
|
||||||
|
.RS 4
|
||||||
Instruct the window manager not to render borders/decoration on the
|
Instruct the window manager not to render borders/decoration on the
|
||||||
Terminator window (this works well with \-m)
|
Terminator window (this works well with \-\-maximise).
|
||||||
.TP
|
.RE
|
||||||
.B \-H, \-\-hidden
|
.sp
|
||||||
|
\fB\-H\fP, \fB\-\-hidden\fP
|
||||||
|
.RS 4
|
||||||
Hide the Terminator window by default. Its visibility can be toggled
|
Hide the Terminator window by default. Its visibility can be toggled
|
||||||
with the \fBhide_window\fR keyboard shortcut (Ctrl-Shift-Alt-a by default)
|
with the \fBhide_window\fP keyboard shortcut (Ctrl+Shift+Alt+A by default).
|
||||||
.TP
|
.RE
|
||||||
.B \-T, \-\-title
|
.sp
|
||||||
Force the Terminator window to use a specific name rather than updating it dynamically
|
\fB\-T\fP \fIFORCEDTITLE\fP, \fB\-\-title\fP=\fIFORCEDTITLE\fP
|
||||||
based on the wishes of the child shell.
|
.RS 4
|
||||||
.TP
|
Force the Terminator window to use a specific name rather than updating
|
||||||
.B \-\-geometry=GEOMETRY
|
it dynamically based on the wishes of the child shell.
|
||||||
Specifies the preferred size and position of Terminator's window; see X(7).
|
.RE
|
||||||
.TP
|
.sp
|
||||||
.B \-e, \-\-command=COMMAND
|
\fB\-\-geometry\fP=\fIGEOMETRY\fP
|
||||||
Runs the specified command instead of your default shell or profile specified command. Note: if
|
.RS 4
|
||||||
Terminator is launched as x-terminal-emulator \-e behaves like \-x, and the longform becomes
|
Specify the preferred size and position of Terminator\(cqs window;
|
||||||
\-\-execute2=COMMAND
|
see \fBX\fP(7).
|
||||||
.TP
|
.RE
|
||||||
.B \-x, \-\-execute COMMAND [ARGS]
|
.sp
|
||||||
Runs \fBthe rest of the command line\fR instead of your default shell or profile specified command.
|
\fB\-e\fP \fICOMMAND\fP, \fB\-\-command\fP=\fICOMMAND\fP
|
||||||
.TP
|
.RS 4
|
||||||
.B \-\-working\-directory=DIR
|
Run the specified command instead of the default shell or profile
|
||||||
Set the terminal's working directory
|
specified command.
|
||||||
.TP
|
.br
|
||||||
.B \-g, \-\-config FILE
|
Note: if Terminator is launched as x\-terminal\-emulator \-e behaves like
|
||||||
Use the specified FILE for configuration
|
\-x, and the longform becomes \-\-execute2=COMMAND.
|
||||||
.TP
|
.RE
|
||||||
.B \-r, \-\-role=ROLE
|
.sp
|
||||||
Set a custom WM_WINDOW_ROLE property on the window
|
\fB\-x\fP \fICOMMAND\fP [\fIARGS\fP], \fB\-\-execute\fP=\fICOMMAND\fP [\fIARGS\fP]
|
||||||
.TP
|
.RS 4
|
||||||
.B \-l, \-\-layout=LAYOUT
|
Run \fBthe rest of the command line\fP instead of the default shell or
|
||||||
|
profile specified command.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fB\-\-working\-directory\fP=\fIDIR\fP
|
||||||
|
.RS 4
|
||||||
|
Set the terminal\(cqs working directory.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fB\-g\fP \fIFILE\fP, \fB\-\-config\fP=\fIFILE\fP
|
||||||
|
.RS 4
|
||||||
|
Use the specified file for configuration.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fB\-r\fP \fIROLE\fP, \fB\-\-role\fP=\fIROLE\fP
|
||||||
|
.RS 4
|
||||||
|
Set a custom WM_WINDOW_ROLE property on the window.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fB\-l\fP \fILAYOUT\fP, \fB\-\-layout\fP=\fILAYOUT\fP
|
||||||
|
.RS 4
|
||||||
Start Terminator with a specific layout. The argument here is the name
|
Start Terminator with a specific layout. The argument here is the name
|
||||||
of a saved layout.
|
of a saved layout.
|
||||||
.TP
|
.RE
|
||||||
.B \-s, \-\-select-layout=LAYOUT
|
.sp
|
||||||
|
\fB\-s\fP \fILAYOUT\fP, \fB\-\-select\-layout\fP=\fILAYOUT\fP
|
||||||
|
.RS 4
|
||||||
Open the layout launcher window instead of the normal terminal.
|
Open the layout launcher window instead of the normal terminal.
|
||||||
.TP
|
.RE
|
||||||
.B \-p, \-\-profile=PROFILE
|
.sp
|
||||||
Use a different profile as the default
|
\fB\-p\fP, \fB\-\-profile\fP=\fIPROFILE\fP
|
||||||
.TP
|
.RS 4
|
||||||
.B \-i, \-\-icon=FORCEDICON
|
Use a different profile as the default.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fB\-i\fP, \fB\-\-icon\fP=\fIFORCEDICON\fP
|
||||||
|
.RS 4
|
||||||
Set a custom icon for the window (by file or name)
|
Set a custom icon for the window (by file or name)
|
||||||
.TP
|
.RE
|
||||||
.B \-u, \-\-no-dbus
|
.sp
|
||||||
Disable DBus
|
\fB\-u\fP, \fB\-\-no\-dbus\fP
|
||||||
.TP
|
.RS 4
|
||||||
.B \-d, \-\-debug
|
Disable DBus.
|
||||||
Enable debugging output (please use this when reporting bugs). This
|
.RE
|
||||||
can be specified twice to enable a built-in python debugging server.
|
.sp
|
||||||
.TP
|
\fB\-d\fP, \fB\-\-debug\fP
|
||||||
.B \-\-debug\-classes=DEBUG_CLASSES
|
.RS 4
|
||||||
|
Enable debugging output (please use this when reporting bugs). This can
|
||||||
|
be specified twice to enable a built\-in python debugging server.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fB\-\-debug\-classes\fP=\fIDEBUG_CLASSES\fP
|
||||||
|
.RS 4
|
||||||
If this is specified as a comma separated list, debugging output will
|
If this is specified as a comma separated list, debugging output will
|
||||||
only be printed from the specified classes.
|
only be printed from the specified classes.
|
||||||
.TP
|
.RE
|
||||||
.B \-\-debug\-methods=DEBUG_METHODS
|
.sp
|
||||||
|
\fB\-\-debug\-methods\fP=\fIDEBUG_METHODS\fP
|
||||||
|
.RS 4
|
||||||
If this is specified as a comma separated list, debugging output will
|
If this is specified as a comma separated list, debugging output will
|
||||||
only be printed from the specified functions. If this is specified in
|
only be printed from the specified functions. If this is specified in
|
||||||
addition to \-\-debug-classes, only the intersection of the two lists
|
addition to \-\-debug\-classes, only the intersection of the two lists will
|
||||||
will be displayed
|
be displayed.
|
||||||
.TP
|
.RE
|
||||||
.B \-\-new-tab
|
.sp
|
||||||
|
\fB\-\-new\-tab\fP
|
||||||
|
.RS 4
|
||||||
If this is specified and Terminator is already running, DBus will be
|
If this is specified and Terminator is already running, DBus will be
|
||||||
used to spawn a new tab in the first Terminator window.
|
used to spawn a new tab in the first Terminator window.
|
||||||
|
.RE
|
||||||
.SH "KEYBINDINGS"
|
.SH "KEYBINDINGS"
|
||||||
The following default keybindings can be used to control Terminator:
|
.sp
|
||||||
.TP
|
The following default keybindings can be used to control Terminator.
|
||||||
.B F1
|
Most of these keybindings can be changed in the Preferences.
|
||||||
|
.sp
|
||||||
|
\fBF1\fP
|
||||||
|
.RS 4
|
||||||
Launches the full HTML manual.
|
Launches the full HTML manual.
|
||||||
.SS Creation & Destruction
|
.RE
|
||||||
.PP
|
.SS "Creation & Destruction"
|
||||||
|
.sp
|
||||||
The following items relate to creating and destroying terminals.
|
The following items relate to creating and destroying terminals.
|
||||||
.TP
|
.sp
|
||||||
.B Ctrl+Shift+O
|
\fBCtrl+Shift+O\fP
|
||||||
Split terminals H\fBo\fRrizontally.
|
.RS 4
|
||||||
.TP
|
Split terminals H\fIo\fPrizontally.
|
||||||
.B Ctrl+Shift+E
|
.RE
|
||||||
Split terminals V\fBe\fRrtically.
|
.sp
|
||||||
.TP
|
\fBCtrl+Shift+E\fP
|
||||||
.B Ctrl+Shift+T
|
.RS 4
|
||||||
Open new \fBt\fRab.
|
Split terminals V\fIe\fPrtically.
|
||||||
.TP
|
.RE
|
||||||
.B Ctrl+Shift+I
|
.sp
|
||||||
Open a new window. (Note: Unlike in previous releases, this window is
|
\fBCtrl+Shift+T\fP
|
||||||
part of the same Terminator process.)
|
.RS 4
|
||||||
.TP
|
Open new \fIt\fPab.
|
||||||
.B Super+I
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Shift+I\fP
|
||||||
|
.RS 4
|
||||||
|
Open a new window.
|
||||||
|
.br
|
||||||
|
(Note: unlike in previous releases, this window is part of the same
|
||||||
|
Terminator process.)
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBSuper+I\fP
|
||||||
|
.RS 4
|
||||||
Spawn a new Terminator process.
|
Spawn a new Terminator process.
|
||||||
.TP
|
.RE
|
||||||
.B Alt+L
|
.sp
|
||||||
Open \fBl\fRayout launcher.
|
\fBAlt+L\fP
|
||||||
.TP
|
.RS 4
|
||||||
.B Ctrl+Shift+W
|
Open \fIl\fPayout launcher.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Shift+W\fP
|
||||||
|
.RS 4
|
||||||
Close the current terminal.
|
Close the current terminal.
|
||||||
.TP
|
.RE
|
||||||
.B Ctrl+Shift+Q
|
.sp
|
||||||
|
\fBCtrl+Shift+Q\fP
|
||||||
|
.RS 4
|
||||||
Close the current window.
|
Close the current window.
|
||||||
.SS Navigation
|
.RE
|
||||||
.PP
|
.SS "Navigation"
|
||||||
|
.sp
|
||||||
The following items relate to moving between and around terminals.
|
The following items relate to moving between and around terminals.
|
||||||
.TP
|
.sp
|
||||||
.B Alt+Up
|
\fBAlt+Up\fP
|
||||||
Move to the terminal \fBabove\fR the current one.
|
.RS 4
|
||||||
.TP
|
Move to the terminal \fBabove\fP the current one.
|
||||||
.B Alt+Down
|
.RE
|
||||||
Move to the terminal \fBbelow\fR the current one.
|
.sp
|
||||||
.TP
|
\fBAlt+Down\fP
|
||||||
.B Alt+Left
|
.RS 4
|
||||||
Move to the terminal \fBleft of\fR the current one.
|
Move to the terminal \fBbelow\fP the current one.
|
||||||
.TP
|
.RE
|
||||||
.B Alt+Right
|
.sp
|
||||||
Move to the terminal \fBright of\fR the current one.
|
\fBAlt+Left\fP
|
||||||
.TP
|
.RS 4
|
||||||
.B Ctrl+PageDown
|
Move to the terminal \fBleft of\fP the current one.
|
||||||
Move to next Tab.
|
.RE
|
||||||
.TP
|
.sp
|
||||||
.B Ctrl+PageUp
|
\fBAlt+Right\fP
|
||||||
Move to previous Tab.
|
.RS 4
|
||||||
.TP
|
Move to the terminal \fBright of\fP the current one.
|
||||||
.B Ctrl+Shift+N or Ctrl+Tab
|
.RE
|
||||||
Move to \fBn\fRext terminal within the same tab, use Ctrl+PageDown to move to the next tab.
|
.sp
|
||||||
If \fBcycle_term_tab\fR is \fBFalse\fR, cycle within the same tab will be disabled.
|
\fBCtrl+PageDown\fP
|
||||||
.TP
|
.RS 4
|
||||||
.B Ctrl+Shift+P or Ctrl+Shift+Tab
|
Move to next tab.
|
||||||
Move to \fBp\fRrevious terminal within the same tab, use Ctrl+PageUp to move to the previous tab.
|
.RE
|
||||||
If \fBcycle_term_tab\fR is \fBFalse\fR, cycle within the same tab will be disabled.
|
.sp
|
||||||
.SS Organisation
|
\fBCtrl+PageUp\fP
|
||||||
.PP
|
.RS 4
|
||||||
|
Move to previous tab.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Shift+N\fP or \fBCtrl+Tab\fP
|
||||||
|
.RS 4
|
||||||
|
Move to the \fIn\fPext terminal within the same tab.
|
||||||
|
.br
|
||||||
|
If \fBcycle_term_tab\fP is \fBFalse\fP, cycle within the same tab will be
|
||||||
|
disabled.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Shift+P\fP or \fBCtrl+Shift+Tab\fP
|
||||||
|
.RS 4
|
||||||
|
Move to the \fIp\fPrevious terminal within the same tab.
|
||||||
|
.br
|
||||||
|
If \fBcycle_term_tab\fP is \fBFalse\fP, cycle within the same tab will be
|
||||||
|
disabled.
|
||||||
|
.RE
|
||||||
|
.SS "Organisation"
|
||||||
|
.sp
|
||||||
The following items relate to arranging and resizing terminals.
|
The following items relate to arranging and resizing terminals.
|
||||||
.TP
|
.sp
|
||||||
.B Ctrl+Shift+Right
|
\fBCtrl+Shift+Right\fP
|
||||||
Move parent dragbar \fBRight\fR.
|
.RS 4
|
||||||
.TP
|
Move parent dragbar \fBright\fP.
|
||||||
.B Ctrl+Shift+Left
|
.RE
|
||||||
Move parent dragbar \fBLeft\fR.
|
.sp
|
||||||
.TP
|
\fBCtrl+Shift+Left\fP
|
||||||
.B Ctrl+Shift+Up
|
.RS 4
|
||||||
Move parent dragbar \fBUp\fR.
|
Move parent dragbar \fBleft\fP.
|
||||||
.TP
|
.RE
|
||||||
.B Ctrl+Shift+Down
|
.sp
|
||||||
Move parent dragbar \fBDown\fR.
|
\fBCtrl+Shift+Up\fP
|
||||||
.TP
|
.RS 4
|
||||||
.B Super+R
|
Move parent dragbar \fBup\fP.
|
||||||
\fBR\fRotate terminals clockwise.
|
.RE
|
||||||
.TP
|
.sp
|
||||||
.B Super+Shift+R
|
\fBCtrl+Shift+Down\fP
|
||||||
\fBR\fRotate terminals counter-clockwise.
|
.RS 4
|
||||||
.TP
|
Move parent dragbar \fBdown\fP.
|
||||||
.SH "Drag and Drop"
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBSuper+R\fP
|
||||||
|
.RS 4
|
||||||
|
\fIR\fPotate terminals clockwise.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBSuper+Shift+R\fP
|
||||||
|
.RS 4
|
||||||
|
\fIR\fPotate terminals counter\-clockwise.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Shift+PageDown\fP
|
||||||
|
.RS 4
|
||||||
|
Swap tab position with next tab.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Shift+PageUp\fP
|
||||||
|
.RS 4
|
||||||
|
Swap tab position with previous tab.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBDrag and Drop\fP
|
||||||
|
.RS 4
|
||||||
The layout can be modified by moving terminals with Drag and Drop.
|
The layout can be modified by moving terminals with Drag and Drop.
|
||||||
To start dragging a terminal, click and hold on its titlebar.
|
To start dragging a terminal, click and hold on its titlebar.
|
||||||
Alternatively, hold down \fBCtrl\fP, click and hold the \fBright\fP mouse button.
|
Alternatively, hold down \fBCtrl\fP, click and hold the \fBright\fP mouse button.
|
||||||
Then, \fB**Release Ctrl**\fP. You can now drag the terminal to the point in the layout you would like it to be.
|
Then, \fB**release Ctrl**\fP. You can now drag the terminal to the point
|
||||||
The zone where the terminal would be inserted will be highlighted.
|
in the layout you would like it to be. The zone where the terminal would
|
||||||
.TP
|
be inserted will be highlighted.
|
||||||
.B Ctrl+Shift+PageDown
|
.RE
|
||||||
Swap tab position with next Tab.
|
.SS "Focus"
|
||||||
.TP
|
.sp
|
||||||
.B Ctrl+Shift+PageUp
|
|
||||||
Swap tab position with previous Tab.
|
|
||||||
.SS Miscellaneous
|
|
||||||
.PP
|
|
||||||
The following items relate to miscellaneous terminal related functions.
|
|
||||||
.TP
|
|
||||||
.B Ctrl+Shift+C
|
|
||||||
Copy selected text to clipboard.
|
|
||||||
.TP
|
|
||||||
.B Ctrl+Shift+V
|
|
||||||
Paste clipboard text.
|
|
||||||
.TP
|
|
||||||
.B Ctrl+Shift+S
|
|
||||||
Hide/Show \fBS\fRcrollbar.
|
|
||||||
.TP
|
|
||||||
.B Ctrl+Shift+F
|
|
||||||
Search within terminal scrollback.
|
|
||||||
.TP
|
|
||||||
.B Ctrl+Shift+R
|
|
||||||
Reset terminal state.
|
|
||||||
.TP
|
|
||||||
.B Ctrl+Shift+G
|
|
||||||
Reset terminal state and clear window.
|
|
||||||
.TP
|
|
||||||
.B Ctrl+Plus (+)
|
|
||||||
Increase font size. \fBNote:\fP This may require you to press shift, depending on your keyboard.
|
|
||||||
.TP
|
|
||||||
.B Ctrl+Minus (-)
|
|
||||||
Decrease font size. \fBNote:\fP This may require you to press shift, depending on your keyboard.
|
|
||||||
.TP
|
|
||||||
.B Ctrl+Zero (0)
|
|
||||||
Restore font size to original setting.
|
|
||||||
.TP
|
|
||||||
.B Ctrl+Alt+W
|
|
||||||
Rename window title.
|
|
||||||
.TP
|
|
||||||
.B Ctrl+Alt+A
|
|
||||||
Rename tab title.
|
|
||||||
.TP
|
|
||||||
.B Ctrl+Alt+X
|
|
||||||
Rename terminal title.
|
|
||||||
.TP
|
|
||||||
.B Super+1
|
|
||||||
Insert terminal number, i.e. 1 to 12.
|
|
||||||
.TP
|
|
||||||
.B Super+0
|
|
||||||
Insert padded terminal number, i.e. 01 to 12.
|
|
||||||
.SS Grouping & Broadcasting
|
|
||||||
.PP
|
|
||||||
The following items relate to helping to focus on a specific terminal.
|
The following items relate to helping to focus on a specific terminal.
|
||||||
.TP
|
.sp
|
||||||
.B F11
|
\fBF11\fP
|
||||||
|
.RS 4
|
||||||
Toggle window to fullscreen.
|
Toggle window to fullscreen.
|
||||||
.TP
|
.RE
|
||||||
.B Ctrl+Shift+X
|
.sp
|
||||||
Toggle between showing all terminals and only showing the current one (maximise).
|
\fBCtrl+Shift+X\fP
|
||||||
.TP
|
.RS 4
|
||||||
.B Ctrl+Shift+Z
|
Toggle between showing all terminals and only showing the current one
|
||||||
Toggle between showing all terminals and only showing a scaled version of the current one (zoom).
|
(maximise).
|
||||||
.TP
|
.RE
|
||||||
.B Ctrl+Shift+Alt+A
|
.sp
|
||||||
Hide the initial window. Note that this is a global binding, and can only be bound once.
|
\fBCtrl+Shift+Z\fP
|
||||||
.PP
|
.RS 4
|
||||||
|
Toggle between showing all terminals and only showing a scaled version
|
||||||
|
of the current one (zoom).
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Shift+Alt+A\fP
|
||||||
|
.RS 4
|
||||||
|
Hide the initial window. Note that this is a global binding, and can
|
||||||
|
only be bound once.
|
||||||
|
.RE
|
||||||
|
.SS "Grouping & Broadcasting"
|
||||||
|
.sp
|
||||||
The following items relate to grouping and broadcasting.
|
The following items relate to grouping and broadcasting.
|
||||||
.TP
|
.sp
|
||||||
.B Super+T
|
\fBSuper+T\fP
|
||||||
Group all terminals in the current tab so input sent to one of them, goes to all terminals in the current tab.
|
.RS 4
|
||||||
.TP
|
Group all terminals in the current tab so that any input sent to one of
|
||||||
.B Super+Shift+T
|
them goes to all of them.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBSuper+Shift+T\fP
|
||||||
|
.RS 4
|
||||||
Remove grouping from all terminals in the current tab.
|
Remove grouping from all terminals in the current tab.
|
||||||
.TP
|
.RE
|
||||||
.B Super+G
|
.sp
|
||||||
Group all terminals so that any input sent to one of them, goes to all of them.
|
\fBSuper+G\fP
|
||||||
.TP
|
.RS 4
|
||||||
.B Super+Shift+G
|
Group all terminals so that any input sent to one of them goes to all of
|
||||||
|
them.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBSuper+Shift+G\fP
|
||||||
|
.RS 4
|
||||||
Remove grouping from all terminals.
|
Remove grouping from all terminals.
|
||||||
.TP
|
.RE
|
||||||
.B Alt+A
|
.sp
|
||||||
Broadcast to All terminals.
|
\fBAlt+A\fP
|
||||||
.TP
|
.RS 4
|
||||||
.B Alt+G
|
Broadcast to \fIa\fPll terminals.
|
||||||
Broadcast to Grouped terminals.
|
.RE
|
||||||
.TP
|
.sp
|
||||||
.B Alt+O
|
\fBAlt+G\fP
|
||||||
Broadcast Off.
|
.RS 4
|
||||||
.PP
|
Broadcast to \fIg\fProuped terminals.
|
||||||
Most of these keybindings are changeable in the Preferences.
|
.RE
|
||||||
.SH "SEE ALSO"
|
.sp
|
||||||
.BR terminator_config(5)
|
\fBAlt+O\fP
|
||||||
.SH "AUTHOR"
|
.RS 4
|
||||||
|
Broadcast \fIo\fPff.
|
||||||
|
.RE
|
||||||
|
.SS "Miscellaneous"
|
||||||
|
.sp
|
||||||
|
The following items relate to miscellaneous terminal related functions.
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Shift+C\fP
|
||||||
|
.RS 4
|
||||||
|
Copy selected text to clipboard.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Shift+V\fP
|
||||||
|
.RS 4
|
||||||
|
Paste clipboard text.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Shift+S\fP
|
||||||
|
.RS 4
|
||||||
|
Toggle \fIs\fPcrollbar.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Shift+F\fP
|
||||||
|
.RS 4
|
||||||
|
Search within terminal scrollback.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Shift+R\fP
|
||||||
|
.RS 4
|
||||||
|
Reset terminal state.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Shift+G\fP
|
||||||
|
.RS 4
|
||||||
|
Reset terminal state and clear window.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Plus (+)\fP
|
||||||
|
.RS 4
|
||||||
|
Increase font size.
|
||||||
|
.br
|
||||||
|
Note: this may require you to press shift, depending on your keyboard.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Minus (\-)\fP
|
||||||
|
.RS 4
|
||||||
|
Decrease font size.
|
||||||
|
.br
|
||||||
|
Note: this may require you to press shift, depending on your keyboard.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Zero (0)\fP
|
||||||
|
.RS 4
|
||||||
|
Restore font size to original setting.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Alt+W\fP
|
||||||
|
.RS 4
|
||||||
|
Rename window title.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Alt+A\fP
|
||||||
|
.RS 4
|
||||||
|
Rename tab title.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBCtrl+Alt+X\fP
|
||||||
|
.RS 4
|
||||||
|
Rename terminal title.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBSuper+1\fP
|
||||||
|
.RS 4
|
||||||
|
Insert terminal number, i.e. 1 to 12.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
\fBSuper+0\fP
|
||||||
|
.RS 4
|
||||||
|
Insert padded terminal number, i.e. 01 to 12.
|
||||||
|
.RE
|
||||||
|
.SH "AUTHORS"
|
||||||
|
.sp
|
||||||
Terminator was written by Chris Jones <cmsj@tenshu.net> and others.
|
Terminator was written by Chris Jones <cmsj@tenshu.net> and others.
|
||||||
.PP
|
.sp
|
||||||
This manual page was written by Chris Jones <cmsj@tenshu.net>
|
This manual page was written by Chris Jones <cmsj@tenshu.net> and others.
|
||||||
and others.
|
.SH "SEE ALSO"
|
||||||
|
.sp
|
||||||
|
\fBterminator_config\fP(5)
|
||||||
|
|
@ -0,0 +1,310 @@
|
||||||
|
= Terminator(1)
|
||||||
|
:doctype: manpage
|
||||||
|
:manmanual: Manual for Terminator
|
||||||
|
:mansource: Terminator
|
||||||
|
:revdate: 2023-03-30
|
||||||
|
:docdate: {revdate}
|
||||||
|
|
||||||
|
== NAME
|
||||||
|
terminator - multiple GNOME terminals in one window
|
||||||
|
|
||||||
|
== SYNOPSIS
|
||||||
|
*terminator* [_options_]
|
||||||
|
|
||||||
|
== DESCRIPTION
|
||||||
|
This manual page documents *Terminator*, a terminal emulator application.
|
||||||
|
|
||||||
|
*Terminator* is a program that allows users to set up flexible
|
||||||
|
arrangements of GNOME terminals. It is aimed at those who normally
|
||||||
|
arrange lots of terminals near each other, but don't want to use a
|
||||||
|
frame based window manager.
|
||||||
|
|
||||||
|
== OPTIONS
|
||||||
|
This program follows the usual GNU command line syntax, with long
|
||||||
|
options starting with two dashes (`-').
|
||||||
|
A summary of options is included below.
|
||||||
|
|
||||||
|
*-h*, *--help*::
|
||||||
|
Show summary of options.
|
||||||
|
|
||||||
|
*-v*, *--version*::
|
||||||
|
Show the version of the Terminator installation.
|
||||||
|
|
||||||
|
*-m*, *-M*, *--maximise*, *--maximize*::
|
||||||
|
Start with a maximised window.
|
||||||
|
|
||||||
|
*-f*, *--fullscreen*::
|
||||||
|
Start with a fullscreen window.
|
||||||
|
|
||||||
|
*-b*, *--borderless*::
|
||||||
|
Instruct the window manager not to render borders/decoration on the
|
||||||
|
Terminator window (this works well with --maximise).
|
||||||
|
|
||||||
|
*-H*, *--hidden*::
|
||||||
|
Hide the Terminator window by default. Its visibility can be toggled
|
||||||
|
with the *hide_window* keyboard shortcut (Ctrl+Shift+Alt+A by default).
|
||||||
|
|
||||||
|
*-T* _FORCEDTITLE_, **--title**=__FORCEDTITLE__::
|
||||||
|
Force the Terminator window to use a specific name rather than updating
|
||||||
|
it dynamically based on the wishes of the child shell.
|
||||||
|
|
||||||
|
**--geometry**=__GEOMETRY__::
|
||||||
|
Specify the preferred size and position of Terminator's window;
|
||||||
|
see *X*(7).
|
||||||
|
|
||||||
|
*-e* _COMMAND_, **--command**=__COMMAND__::
|
||||||
|
Run the specified command instead of the default shell or profile
|
||||||
|
specified command. +
|
||||||
|
Note: if Terminator is launched as x-terminal-emulator -e behaves like
|
||||||
|
-x, and the longform becomes --execute2=COMMAND.
|
||||||
|
|
||||||
|
*-x* _COMMAND_ [__ARGS__], **--execute**=__COMMAND__ [__ARGS__]::
|
||||||
|
Run *the rest of the command line* instead of the default shell or
|
||||||
|
profile specified command.
|
||||||
|
|
||||||
|
**--working-directory**=__DIR__::
|
||||||
|
Set the terminal's working directory.
|
||||||
|
|
||||||
|
*-g* _FILE_, **--config**=__FILE__::
|
||||||
|
Use the specified file for configuration.
|
||||||
|
|
||||||
|
// TODO --config-json option
|
||||||
|
|
||||||
|
*-r* _ROLE_, **--role**=__ROLE__::
|
||||||
|
Set a custom WM_WINDOW_ROLE property on the window.
|
||||||
|
|
||||||
|
*-l* _LAYOUT_, **--layout**=__LAYOUT__::
|
||||||
|
Start Terminator with a specific layout. The argument here is the name
|
||||||
|
of a saved layout.
|
||||||
|
|
||||||
|
*-s* _LAYOUT_, **--select-layout**=__LAYOUT__::
|
||||||
|
Open the layout launcher window instead of the normal terminal.
|
||||||
|
|
||||||
|
*-p*, **--profile**=__PROFILE__::
|
||||||
|
Use a different profile as the default.
|
||||||
|
|
||||||
|
*-i*, **--icon**=__FORCEDICON__::
|
||||||
|
Set a custom icon for the window (by file or name)
|
||||||
|
|
||||||
|
*-u*, *--no-dbus*::
|
||||||
|
Disable DBus.
|
||||||
|
// Could 'Start Terminator with DBus disabled.' be better?
|
||||||
|
|
||||||
|
*-d*, *--debug*::
|
||||||
|
Enable debugging output (please use this when reporting bugs). This can
|
||||||
|
be specified twice to enable a built-in python debugging server.
|
||||||
|
|
||||||
|
**--debug-classes**=__DEBUG_CLASSES__::
|
||||||
|
If this is specified as a comma separated list, debugging output will
|
||||||
|
only be printed from the specified classes.
|
||||||
|
|
||||||
|
**--debug-methods**=__DEBUG_METHODS__::
|
||||||
|
If this is specified as a comma separated list, debugging output will
|
||||||
|
only be printed from the specified functions. If this is specified in
|
||||||
|
addition to --debug-classes, only the intersection of the two lists will
|
||||||
|
be displayed.
|
||||||
|
|
||||||
|
*--new-tab*::
|
||||||
|
If this is specified and Terminator is already running, DBus will be
|
||||||
|
used to spawn a new tab in the first Terminator window.
|
||||||
|
|
||||||
|
== KEYBINDINGS
|
||||||
|
The following default keybindings can be used to control Terminator.
|
||||||
|
Most of these keybindings can be changed in the Preferences.
|
||||||
|
|
||||||
|
*F1*::
|
||||||
|
Launches the full HTML manual.
|
||||||
|
|
||||||
|
=== Creation & Destruction
|
||||||
|
The following items relate to creating and destroying terminals.
|
||||||
|
|
||||||
|
*Ctrl+Shift+O*::
|
||||||
|
Split terminals H__o__rizontally.
|
||||||
|
|
||||||
|
*Ctrl+Shift+E*::
|
||||||
|
Split terminals V__e__rtically.
|
||||||
|
|
||||||
|
*Ctrl+Shift+T*::
|
||||||
|
Open new __t__ab.
|
||||||
|
|
||||||
|
*Ctrl+Shift+I*::
|
||||||
|
Open a new window. +
|
||||||
|
(Note: unlike in previous releases, this window is part of the same
|
||||||
|
Terminator process.)
|
||||||
|
|
||||||
|
*Super+I*::
|
||||||
|
Spawn a new Terminator process.
|
||||||
|
|
||||||
|
*Alt+L*::
|
||||||
|
Open __l__ayout launcher.
|
||||||
|
|
||||||
|
*Ctrl+Shift+W*::
|
||||||
|
Close the current terminal.
|
||||||
|
|
||||||
|
*Ctrl+Shift+Q*::
|
||||||
|
Close the current window.
|
||||||
|
|
||||||
|
=== Navigation
|
||||||
|
The following items relate to moving between and around terminals.
|
||||||
|
|
||||||
|
*Alt+Up*::
|
||||||
|
Move to the terminal *above* the current one.
|
||||||
|
|
||||||
|
*Alt+Down*::
|
||||||
|
Move to the terminal *below* the current one.
|
||||||
|
|
||||||
|
*Alt+Left*::
|
||||||
|
Move to the terminal *left of* the current one.
|
||||||
|
|
||||||
|
*Alt+Right*::
|
||||||
|
Move to the terminal *right of* the current one.
|
||||||
|
|
||||||
|
*Ctrl+PageDown*::
|
||||||
|
Move to next tab.
|
||||||
|
|
||||||
|
*Ctrl+PageUp*::
|
||||||
|
Move to previous tab.
|
||||||
|
|
||||||
|
*Ctrl+Shift+N* or *Ctrl+Tab*::
|
||||||
|
Move to the __n__ext terminal within the same tab. +
|
||||||
|
If *cycle_term_tab* is *False*, cycle within the same tab will be
|
||||||
|
disabled.
|
||||||
|
|
||||||
|
*Ctrl+Shift+P* or *Ctrl+Shift+Tab*::
|
||||||
|
Move to the __p__revious terminal within the same tab. +
|
||||||
|
If *cycle_term_tab* is *False*, cycle within the same tab will be
|
||||||
|
disabled.
|
||||||
|
|
||||||
|
=== Organisation
|
||||||
|
The following items relate to arranging and resizing terminals.
|
||||||
|
|
||||||
|
*Ctrl+Shift+Right*::
|
||||||
|
Move parent dragbar *right*.
|
||||||
|
|
||||||
|
*Ctrl+Shift+Left*::
|
||||||
|
Move parent dragbar *left*.
|
||||||
|
|
||||||
|
*Ctrl+Shift+Up*::
|
||||||
|
Move parent dragbar *up*.
|
||||||
|
|
||||||
|
*Ctrl+Shift+Down*::
|
||||||
|
Move parent dragbar *down*.
|
||||||
|
|
||||||
|
*Super+R*::
|
||||||
|
__R__otate terminals clockwise.
|
||||||
|
|
||||||
|
*Super+Shift+R*::
|
||||||
|
__R__otate terminals counter-clockwise.
|
||||||
|
|
||||||
|
*Ctrl+Shift+PageDown*::
|
||||||
|
Swap tab position with next tab.
|
||||||
|
|
||||||
|
*Ctrl+Shift+PageUp*::
|
||||||
|
Swap tab position with previous tab.
|
||||||
|
|
||||||
|
*Drag and Drop*::
|
||||||
|
The layout can be modified by moving terminals with Drag and Drop.
|
||||||
|
To start dragging a terminal, click and hold on its titlebar.
|
||||||
|
Alternatively, hold down *Ctrl*, click and hold the *right* mouse button.
|
||||||
|
Then, *+**release Ctrl**+*. You can now drag the terminal to the point
|
||||||
|
in the layout you would like it to be. The zone where the terminal would
|
||||||
|
be inserted will be highlighted.
|
||||||
|
|
||||||
|
=== Focus
|
||||||
|
The following items relate to helping to focus on a specific terminal.
|
||||||
|
|
||||||
|
*F11*::
|
||||||
|
Toggle window to fullscreen.
|
||||||
|
|
||||||
|
*Ctrl+Shift+X*::
|
||||||
|
Toggle between showing all terminals and only showing the current one
|
||||||
|
(maximise).
|
||||||
|
|
||||||
|
*Ctrl+Shift+Z*::
|
||||||
|
Toggle between showing all terminals and only showing a scaled version
|
||||||
|
of the current one (zoom).
|
||||||
|
|
||||||
|
*Ctrl+Shift+Alt+A*::
|
||||||
|
Hide the initial window. Note that this is a global binding, and can
|
||||||
|
only be bound once.
|
||||||
|
|
||||||
|
=== Grouping & Broadcasting
|
||||||
|
The following items relate to grouping and broadcasting.
|
||||||
|
|
||||||
|
*Super+T*::
|
||||||
|
Group all terminals in the current tab so that any input sent to one of
|
||||||
|
them goes to all of them.
|
||||||
|
|
||||||
|
*Super+Shift+T*::
|
||||||
|
Remove grouping from all terminals in the current tab.
|
||||||
|
|
||||||
|
*Super+G*::
|
||||||
|
Group all terminals so that any input sent to one of them goes to all of
|
||||||
|
them.
|
||||||
|
|
||||||
|
*Super+Shift+G*::
|
||||||
|
Remove grouping from all terminals.
|
||||||
|
|
||||||
|
*Alt+A*::
|
||||||
|
Broadcast to __a__ll terminals.
|
||||||
|
|
||||||
|
*Alt+G*::
|
||||||
|
Broadcast to __g__rouped terminals.
|
||||||
|
|
||||||
|
*Alt+O*::
|
||||||
|
Broadcast __o__ff.
|
||||||
|
|
||||||
|
=== Miscellaneous
|
||||||
|
The following items relate to miscellaneous terminal related functions.
|
||||||
|
|
||||||
|
*Ctrl+Shift+C*::
|
||||||
|
Copy selected text to clipboard.
|
||||||
|
|
||||||
|
*Ctrl+Shift+V*::
|
||||||
|
Paste clipboard text.
|
||||||
|
|
||||||
|
*Ctrl+Shift+S*::
|
||||||
|
Toggle __s__crollbar.
|
||||||
|
|
||||||
|
*Ctrl+Shift+F*::
|
||||||
|
Search within terminal scrollback.
|
||||||
|
|
||||||
|
*Ctrl+Shift+R*::
|
||||||
|
Reset terminal state.
|
||||||
|
|
||||||
|
*Ctrl+Shift+G*::
|
||||||
|
Reset terminal state and clear window.
|
||||||
|
|
||||||
|
*Ctrl+Plus (+)*::
|
||||||
|
Increase font size. +
|
||||||
|
Note: this may require you to press shift, depending on your keyboard.
|
||||||
|
|
||||||
|
*Ctrl+Minus (-)*::
|
||||||
|
Decrease font size. +
|
||||||
|
Note: this may require you to press shift, depending on your keyboard.
|
||||||
|
|
||||||
|
*Ctrl+Zero (0)*::
|
||||||
|
Restore font size to original setting.
|
||||||
|
|
||||||
|
*Ctrl+Alt+W*::
|
||||||
|
Rename window title.
|
||||||
|
|
||||||
|
*Ctrl+Alt+A*::
|
||||||
|
Rename tab title.
|
||||||
|
|
||||||
|
*Ctrl+Alt+X*::
|
||||||
|
Rename terminal title.
|
||||||
|
|
||||||
|
*Super+1*::
|
||||||
|
Insert terminal number, i.e. 1 to 12.
|
||||||
|
|
||||||
|
*Super+0*::
|
||||||
|
Insert padded terminal number, i.e. 01 to 12.
|
||||||
|
|
||||||
|
== AUTHORS
|
||||||
|
Terminator was written by Chris Jones <\cmsj@tenshu.net> and others.
|
||||||
|
|
||||||
|
This manual page was written by Chris Jones <\cmsj@tenshu.net> and others.
|
||||||
|
|
||||||
|
== SEE ALSO
|
||||||
|
*terminator_config*(5)
|
||||||
Loading…
Reference in New Issue