itdominator
/
terminator
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Generate terminator.1 from terminator.adoc using asciidoctor

This commit is contained in:
Vulcalien 2023-03-31 01:17:22 +02:00
parent dd075a243d
commit 1ce3d50069
1 changed files with 442 additions and 247 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

689
doc/terminator.1
View File

@ -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)