terminator/doc/terminator.1
2009-02-08 21:15:43 +00:00

173 lines
4.9 KiB
Groff

.TH "TERMINATOR" "1" "Jan 5, 2008" "" ""
.SH "NAME"
Terminator \- Multiple GNOME terminals in one window
.SH "SYNOPSIS"
.B terminator
.RI [ options ]
.br
.SH "DESCRIPTION"
This manual page documents \fBTerminator\fP, a terminal emulator application.
.PP
\fBTerminator\fP 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.
.SH "OPTIONS"
This program follow the usual GNU command line syntax, with long
options starting with two dashes (`\-').
A summary of options is included below.
.TP
.B \-h, \-\-help
Show summary of options
.TP
.B \-d, \-\-debug
Enable debugging output (please use this when reporting bugs)
.TP
.B \-m, \-\-maximise
Maximise the Terminator window when it starts
.TP
.B \-f, \-\-fullscreen
Place the Terminator window in its fullscreen state when it starts
.TP
.B \-b, \-\-borderless
Instruct the window manager not to render borders/decoration on the
Terminator window (good with \-m)
.TP
.B \-H, \-\-hidden
Hide the Terminator window by default. Its visibility can be toggled
with the \fBhide_window\fR keyboard shortcut (Ctrl-Shift-Alt-a by default)
.TP
.B \-\-no_gconf
Ignore the gconf settings of gnome-terminal
.TP
.B \-p, \-\-profile PROFILE
Loads the GNOME Terminal profile named PROFILE. Note that doing this will override the settings
in your Terminator config file with those from the GNOME Terminal profile.
.TP
.B \-\-geometry=GEOMETRY
Specifies the preferred size and position of Terminator's window; see X(7).
.TP
.B \-e, \-\-command=COMMAND
Runs the specified command instead of your default shell or profile specified command
.TP
.B \-x, \-\-execute COMMAND [ARGS]
Runs \fBthe rest of the command line\fR instead of your default shell or profile specified command.
.TP
.B \-\-working\-directory=DIR
Set the terminal's working directory
.SH "KEYBINDINGS"
The following keybindings can be used to control Terminator:
.TP
.B Ctrl+Shift+O
Split terminals H\fBo\fRrizontally.
.TP
.B Ctrl+Shift+E
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
.B Ctrl+Shift+N or Ctrl+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
.B Ctrl+Shift+P or Ctrl+Shift+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
.TP
.B Alt+Up
Move to the terminal \fBabove\fR the current one.
.TP
.B Alt+Down
Move to the terminal \fBbelow\fR the current one.
.TP
.B Alt+Left
Move to the terminal \fBleft of\fR the current one.
.TP
.B Alt+Right
Move to the terminal \fBright of\fR the current one.
.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+Shift+Alt+T
Open new \fBt\fRab at root level, if using \fBextreme_tabs\fR.
.TP
.B Ctrl+PageDown
Move to next Tab
.TP
.B Ctrl+PageUp
Move to previous Tab
.TP
.B Ctrl+Shift+PageDown
Swap tab position with next Tab
.TP
.B Ctrl+Shift+PageUp
Swap tab position with previous Tab
.TP
.B Ctrl+Shift+F
Open buffer search bar to find substrings in the scrollback buffer. Hit Escape to cancel.
.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 F11
Toggle fullscreen
.TP
.B Ctrl+Shift+R
Reset terminal state
.TP
.B Ctrl+Shift+G
Reset terminal state and clear window
.SH "Drag and Drop"
The layout can be modified by moving terminals with Drag and Drop.
To start dragging a terminal, 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.
The zone where the terminal would be inserted will be highlighted.
.SH "SEE ALSO"
.BR gnome\-terminal(1),terminator_config(5)
.SH "AUTHOR"
Terminator was written by Chris Jones <cmsj@tenshu.net> and others.
.PP
This manual page was written by Chris Jones <cmsj@tenshu.net>
and others.