Updated and grouped default shortcuts in man page (Steve Boddy)

This commit is contained in:
Stephen Boddy 2015-10-01 20:51:28 +02:00
parent 4f0c4330d2
commit 2fd279ecf1
2 changed files with 156 additions and 110 deletions

View File

@ -15,6 +15,7 @@ terminator trunk:
* remotinator help strings are translatable now * remotinator help strings are translatable now
* PuTTY paste mode (Nemilya, LP#1416682) with some alterations * PuTTY paste mode (Nemilya, LP#1416682) with some alterations
(Steve Boddy) (Steve Boddy)
* Updated and grouped default shortcuts in man page (Steve Boddy)
* Bug fixes * Bug fixes
* Fix for those not running IBus, where the IBus workaround caused * Fix for those not running IBus, where the IBus workaround caused
broken keys in other keymaps set with non-IBus tools (Steve broken keys in other keymaps set with non-IBus tools (Steve

View File

@ -3,36 +3,36 @@
Terminator \- Multiple GNOME terminals in one window Terminator \- Multiple GNOME terminals in one window
.SH "SYNOPSIS" .SH "SYNOPSIS"
.B terminator .B terminator
.RI [ options ] .RI [ options ]
.br .br
.SH "DESCRIPTION" .SH "DESCRIPTION"
This manual page documents \fBTerminator\fP, a terminal emulator application. This manual page documents \fBTerminator\fP, a terminal emulator application.
.PP .PP
\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't want to use a
frame based window manager. frame based window manager.
.SH "OPTIONS" .SH "OPTIONS"
This program follow the usual GNU command line syntax, with long This program follow the usual GNU command line syntax, with long
options starting with two dashes (`\-'). options starting with two dashes (`\-').
A summary of options is included below. A summary of options is included below.
.TP .TP
.B \-h, \-\-help .B \-h, \-\-help
Show summary of options Show summary of options
.TP .TP
.B \-v, \-\-version .B \-v, \-\-version
Show the version of the Terminator installation Show the version of the Terminator installation
.TP .TP
.B \-m, \-\-maximise .B \-m, \-\-maximise
Start with a maximised window Start with a maximised window
.TP .TP
.B \-f, \-\-fullscreen .B \-f, \-\-fullscreen
Start with a fullscreen window Start with a fullscreen window
.TP .TP
.B \-b, \-\-borderless .B \-b, \-\-borderless
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 \-m)
.TP .TP
.B \-H, \-\-hidden .B \-H, \-\-hidden
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\fR keyboard shortcut (Ctrl-Shift-Alt-a by default)
@ -48,7 +48,7 @@ Specifies the preferred size and position of Terminator's window; see X(7).
Runs the specified command instead of your default shell or profile specified command. Note: if Runs the specified command instead of your default shell or profile specified command. Note: if
Terminator is launched as x-terminal-emulator \-e behaves like \-x, and the longform becomes Terminator is launched as x-terminal-emulator \-e behaves like \-x, and the longform becomes
\-\-execute2=COMMAND \-\-execute2=COMMAND
.TP .TP
.B \-x, \-\-execute COMMAND [ARGS] .B \-x, \-\-execute COMMAND [ARGS]
Runs \fBthe rest of the command line\fR instead of your default shell or profile specified command. Runs \fBthe rest of the command line\fR instead of your default shell or profile specified command.
.TP .TP
@ -78,11 +78,11 @@ Set a custom icon for the window (by file or name)
Disable DBus Disable DBus
.TP .TP
.B \-d, \-\-debug .B \-d, \-\-debug
Enable debugging output (please use this when reporting bugs). This Enable debugging output (please use this when reporting bugs). This
can be specified twice to enable a built-in python debugging server. can be specified twice to enable a built-in python debugging server.
.TP .TP
.B \-\-debug\-classes=DEBUG_CLASSES .B \-\-debug\-classes=DEBUG_CLASSES
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 .TP
.B \-\-debug\-methods=DEBUG_METHODS .B \-\-debug\-methods=DEBUG_METHODS
@ -94,48 +94,43 @@ will be displayed
.B \-\-new-tab .B \-\-new-tab
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.
.TP
.SH "KEYBINDINGS" .SH "KEYBINDINGS"
The following keybindings can be used to control Terminator: The following default keybindings can be used to control Terminator:
.TP .TP
.B Super+R .B F1
\fBR\fRotate terminals clockwise. Launches the full HTML manual.
.TP .SS Creation & Destruction
.B Super+Shift+R .PP
\fBR\fRotate terminals counter-clockwise. The following items relate to creating and destroying terminals.
.TP .TP
.B Ctrl+Shift+O .B Ctrl+Shift+O
Split terminals H\fBo\fRrizontally. Split terminals H\fBo\fRrizontally.
.TP .TP
.B Ctrl+Shift+E .B Ctrl+Shift+E
Split terminals V\fBe\fRrtically. Split terminals V\fBe\fRrtically.
.TP
.B Ctrl+Shift+Right
Move parent dragbar \fBRight\fR.
.TP
.B Ctrl+Shift+Left
Move parent dragbar \fBLeft\fR.
.TP
.B Ctrl+Shift+Up
Move parent dragbar \fBUp\fR.
.TP
.B Ctrl+Shift+Down
Move parent dragbar \fBDown\fR.
.TP
.B Ctrl+Shift+S
Hide/Show \fBS\fRcrollbar.
.TP
.B Ctrl+Shift+F
Search within terminal scrollback
.TP .TP
.B Ctrl+Shift+N or Ctrl+Tab .B Ctrl+Shift+T
Move to \fBn\fRext terminal within the same tab, use Ctrl+PageDown to move to the next tab. Open new \fBt\fRab.
If \fBcycle_term_tab\fR is \fBFalse\fR, cycle within the same tab will be disabled .TP
.TP .B Ctrl+Shift+I
.B Ctrl+Shift+P or Ctrl+Shift+Tab Open a new window. (Note: Unlike in previous releases, this window is
Move to \fBp\fRrevious terminal within the same tab, use Ctrl+PageUp to move to the previous tab. part of the same Terminator process.)
If \fBcycle_term_tab\fR is \fBFalse\fR, cycle within the same tab will be disabled .TP
.TP .B Super+I
Spawn a new Terminator process.
.TP
.B Alt+L
Open \fBl\fRayout launcher.
.TP
.B Ctrl+Shift+W
Close the current terminal.
.TP
.B Ctrl+Shift+Q
Close the current window.
.SS Navigation
.PP
The following items relate to moving between and around terminals.
.TP
.B Alt+Up .B Alt+Up
Move to the terminal \fBabove\fR the current one. Move to the terminal \fBabove\fR the current one.
.TP .TP
@ -148,75 +143,40 @@ Move to the terminal \fBleft of\fR the current one.
.B Alt+Right .B Alt+Right
Move to the terminal \fBright of\fR the current one. Move to the terminal \fBright of\fR the current one.
.TP .TP
.B Ctrl+Shift+C
Copy selected text to clipboard
.TP
.B Ctrl+Shift+V
Paste clipboard text
.TP
.B Ctrl+Shift+W
Close the current terminal.
.TP
.B Ctrl+Shift+Q
Quits Terminator
.TP
.B Ctrl+Shift+X
Toggle between showing all terminals and only showing the current one (maximise).
.TP
.B Ctrl+Shift+Z
Toggle between showing all terminals and only showing a scaled version of the current one (zoom).
.TP
.B Ctrl+Shift+T
Open new \fBt\fRab
.TP
.B Ctrl+PageDown .B Ctrl+PageDown
Move to next Tab Move to next Tab.
.TP .TP
.B Ctrl+PageUp .B Ctrl+PageUp
Move to previous Tab Move to previous Tab.
.TP .TP
.B Ctrl+Shift+PageDown .B Ctrl+Shift+N or Ctrl+Tab
Swap tab position with next Tab Move to \fBn\fRext terminal within the same tab, use Ctrl+PageDown to move to the next tab.
If \fBcycle_term_tab\fR is \fBFalse\fR, cycle within the same tab will be disabled.
.TP .TP
.B Ctrl+Shift+PageUp .B Ctrl+Shift+P or Ctrl+Shift+Tab
Swap tab position with previous Tab Move to \fBp\fRrevious terminal within the same tab, use Ctrl+PageUp to move to the previous tab.
If \fBcycle_term_tab\fR is \fBFalse\fR, cycle within the same tab will be disabled.
.SS Organisation
.PP
The following items relate to arranging and resizing terminals.
.TP .TP
.B Ctrl+Plus (+) .B Ctrl+Shift+Right
Increase font size. \fBNote:\fP this may require you to press shift, depending on your keyboard Move parent dragbar \fBRight\fR.
.TP .TP
.B Ctrl+Minus (-) .B Ctrl+Shift+Left
Decrease font size. \fBNote:\fP this may require you to press shift, depending on your keyboard Move parent dragbar \fBLeft\fR.
.TP .TP
.B Ctrl+Zero (0) .B Ctrl+Shift+Up
Restore font size to original setting. Move parent dragbar \fBUp\fR.
.TP .TP
.B F11 .B Ctrl+Shift+Down
Toggle fullscreen Move parent dragbar \fBDown\fR.
.TP .TP
.B Ctrl+Shift+R .B Super+R
Reset terminal state \fBR\fRotate terminals clockwise.
.TP .TP
.B Ctrl+Shift+G .B Super+Shift+R
Reset terminal state and clear window \fBR\fRotate terminals counter-clockwise.
.TP
.B Super+g
Group all terminals so that any input sent to one of them, goes to all of them.
.TP
.B Super+Shift+G
Remove grouping from all terminals.
.TP
.B Super+t
Group all terminals in the current tab so input sent to one of them, goes to all terminals in the current tab.
.TP
.B Super+Shift+T
Remove grouping from all terminals in the current tab.
.TP
.B Ctrl+Shift+I
Open a new window (note: unlike in previous releases, this window is
part of the same Terminator process)
.TP
.B Super+i
Spawn a new Terminator process
.TP .TP
.SH "Drag and Drop" .SH "Drag and Drop"
The layout can be modified by moving terminals with Drag and Drop. The layout can be modified by moving terminals with Drag and Drop.
@ -224,10 +184,95 @@ 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 in the layout you would like it to be.
The zone where the terminal would be inserted will be highlighted. The zone where the terminal would be inserted will be highlighted.
.TP
.B Ctrl+Shift+PageDown
Swap tab position with next Tab.
.TP
.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 Alt+T
Rename titlebar.
.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.
.TP
.B F11
Toggle window to fullscreen.
.TP
.B Ctrl+Shift+X
Toggle between showing all terminals and only showing the current one (maximise).
.TP
.B Ctrl+Shift+Z
Toggle between showing all terminals and only showing a scaled version of the current one (zoom).
.TP
.B Ctrl+Shift+Alt+A
Hide the initial window. Note that this is a global binding, and can only be bound once.
.PP
The following items relate to grouping and broadcasting.
.TP
.B Super+T
Group all terminals in the current tab so input sent to one of them, goes to all terminals in the current tab.
.TP
.B Super+Shift+T
Remove grouping from all terminals in the current tab.
.TP
.B Super+G
Group all terminals so that any input sent to one of them, goes to all of them.
.TP
.B Super+Shift+G
Remove grouping from all terminals.
.TP
.B Alt+A
Broadcast to All terminals.
.TP
.B Alt+G
Broadcast to Grouped terminals.
.TP
.B Alt+O
Broadcast Off.
.PP
Most of these keybindings are changeable in the Preferences.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR terminator_config(5) .BR terminator_config(5)
.SH "AUTHOR" .SH "AUTHOR"
Terminator was written by Chris Jones <cmsj@tenshu.net> and others. Terminator was written by Chris Jones <cmsj@tenshu.net> and others.
.PP .PP
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.