Initial commit of a man page
This finally closes issue #48. Special thanks to Jakob Wrigley for the first draft.
This commit is contained in:
Simon Gomizelj
parent
74621daafe
commit
224c76ea37
1
Makefile
1
Makefile
|
|
@ -40,6 +40,7 @@ install: termite termite.desktop termite.terminfo
|
|||
mkdir -p ${DESTDIR}${TERMINFO}
|
||||
install -Dm755 termite ${DESTDIR}${PREFIX}/bin/termite
|
||||
install -Dm644 termite.desktop ${DESTDIR}${PREFIX}/share/applications/termite.desktop
|
||||
install -Dm644 termite.1 ${DESTDIR}${PREFIX}/share/man/man1/termite.1
|
||||
tic termite.terminfo -o ${DESTDIR}${TERMINFO}
|
||||
|
||||
uninstall:
|
||||
|
|
|
|||
|
|
@ -0,0 +1,170 @@
|
|||
.TH termite 1 "2013-03-26" "termite" "User Commands"
|
||||
.SH NAME
|
||||
termite \- A keyboard-centric VTE-based terminal aimed for use with
|
||||
a tiling and/or tabbing enabled window manager.
|
||||
.SH SYNOPSIS
|
||||
\fBtermite\fP [options]
|
||||
.SH DESCRIPTION
|
||||
\fBtermite\fP is a GTK-based terminal emulator inteded for use within
|
||||
window managers with tiling and/or tabbing support. It provides a fast
|
||||
terminal experience and pleasant array of keyboard-centric features.
|
||||
.SH OPTIONS
|
||||
.PP
|
||||
.IP "\fB\-h\fR, \fB\-\-help\fR"
|
||||
Display help message.
|
||||
.IP "\fB\-v\fR, \fB\-\-version\fR"
|
||||
Display version information.
|
||||
.IP "\fB\-r\fR, \fB\-\-role\fR\fB=\fR\fIROLE\fR
|
||||
The role to set the termite window to report itself with.
|
||||
.IP "\fB\-d\fR, \fB\-\-directory\fR\fB=\fR\fIDIRECTORY\fR
|
||||
Tell termite to change to \fIDIRECTORY\fP when launching.
|
||||
.IP "\fB\-e\fR, \fB\-\-exec\fR\fB=\fR\fICOMMAND\fR
|
||||
Tell termite start \fICOMMAND\fP instead of the shell.
|
||||
.IP "\fB\-c\fR, \fB\-\-config\fR\fB=\fR\fICONFIG\fR
|
||||
Specify a path to an alternative config file to use.
|
||||
.IP "\fB\-\-geometry\fR\fB=\fR\fIGEOMETRY\fR
|
||||
Override the window geometry in pixels.
|
||||
.IP "\fB\-\-display\fR\fB=\fR\fIDISPLAY\fR
|
||||
Launch on \fIDISPLAY\fP X display.
|
||||
.IP "\fB\-\-hold\fR"
|
||||
Keep termite open after the child process exits.
|
||||
.SH KEYBINDINGS
|
||||
.SS Insert Mode
|
||||
\fBInsert Mode\fP is the default mode common to most terminal emulators.
|
||||
This is where you enter commands and interact with the programs running
|
||||
within \fBtermite\fP.
|
||||
.PP
|
||||
.IP "\fBctrl-shift-x\fP"
|
||||
activate url hints mode
|
||||
.IP "\fBctrl-shift-r\fP"
|
||||
reload configuration file
|
||||
.IP "\fBctrl-shift-c\fP"
|
||||
copy to \fICLIPBOARD\fP
|
||||
.IP "\fBctrl-shift-v \fP"
|
||||
paste to \fICLIPBOARD\fP
|
||||
.IP "\fBctrl-shift-u\fP"
|
||||
unicode input (standard GTK binding)
|
||||
.IP "\fBctrl-tab\fP"
|
||||
start scrollback completion
|
||||
.IP "\fBctrl-shift-space\fP"
|
||||
start command mode
|
||||
.IP "\fBctrl-shift-t\fP"
|
||||
open a new terminal in the current directory
|
||||
.IP "\fBctrl-shift-up\fP"
|
||||
scroll up a line
|
||||
.IP "\fBctrl-shift-down\fP"
|
||||
scroll down a line
|
||||
.IP "\fBshift-pageup\fP"
|
||||
scroll up a page
|
||||
.IP "\fBshift-pagedown\fP"
|
||||
scroll down a page
|
||||
.SS Command Mode
|
||||
In \fBCommand Mode\fP you interact with the interface of \fBtermite\fP
|
||||
and the visual representation of the programs running within it. You can
|
||||
search, mark and copy contents from the display for use in other
|
||||
programs.
|
||||
.PP
|
||||
.IP "\fBescape\fP"
|
||||
deactivate command mode
|
||||
.IP "\fBx\fP"
|
||||
activate url hints mode
|
||||
.IP "\fBv\fP"
|
||||
visual mode
|
||||
.IP "\fBV\fP"
|
||||
visual line mode
|
||||
.IP "\fBctrl-v\fP"
|
||||
visual block mode
|
||||
.IP "\fBhjkl\fP or \fBarrow keys\fP"
|
||||
move cursor left/down/up/right
|
||||
.IP "\fBw\fP or \fBshift-right\fP"
|
||||
forward word
|
||||
.IP "\fBb\fP or \fBshift-left\fP"
|
||||
backward word
|
||||
.IP "\fBW\fP or \fBctrl-right\fP"
|
||||
forward \fIWORD\fP (non-whitespace)
|
||||
.IP "\fBB\fP or \fBctrl-left\fP"
|
||||
backward \fIWORD\fP (non-whitespace)
|
||||
.IP "\fB0\fP"
|
||||
move cursor to the first column in the row\fP"
|
||||
.IP "\fB^\fP"
|
||||
beginning-of-line (first non-blank character)
|
||||
.IP "\fB$\fP"
|
||||
end-of-line
|
||||
.IP "\fBg\fP"
|
||||
jump to start of first row
|
||||
.IP "\fBG\fP"
|
||||
jump to start of last row
|
||||
.IP "\fBctrl-u\fP"
|
||||
move cursor half a screen up
|
||||
.IP "\fBctrl-d\fP"
|
||||
move cursor half a screen down
|
||||
.IP "\fBy\fP"
|
||||
copy to \fICLIPBOARD\fP
|
||||
.IP "\fB/\fP"
|
||||
forward search
|
||||
.IP "\fB?\fP"
|
||||
reverse search
|
||||
.IP "\fBu\fP"
|
||||
forward url search
|
||||
.IP "\fBU\fP"
|
||||
reverse url search
|
||||
.IP "\fBo\fP"
|
||||
open the current selection as a url
|
||||
.IP "\fBReturn\fP"
|
||||
open the current selection as a url and exit command mode
|
||||
.IP "\fBn\fP"
|
||||
next search match
|
||||
.IP "\fBN\fP"
|
||||
previous search match
|
||||
.IP "\fB+\fP"
|
||||
increase font size
|
||||
.IP "\fB-\fP"
|
||||
decrease font size
|
||||
.SS Hints Mode
|
||||
The
|
||||
\fBHints Mode\fP is meant for accessing urls outputted to the terminal.
|
||||
When active, links can be launched with a few keypresses.
|
||||
.SH FILES
|
||||
\fBtermite\fP looks for the configuration file in the following order:
|
||||
\fI"$XDG_CONFIG_HOME/termite/config"\fP,
|
||||
\fI"~/.config/termite/config"\fP,
|
||||
\fI"$XDG_CONFIG_DIRS/termite/config"\fP and \fI"/etc/xdg/termite.cfg"
|
||||
.SH EXIT STATUS
|
||||
\fBtermite\fP returns \fI1\fR on failure, including a termination of the
|
||||
child process from an uncaught signal. Otherwise the status is that of
|
||||
the child process.
|
||||
.SH REMARKS
|
||||
During scrollback search, the current selection is changed to the search
|
||||
match and copied to the PRIMARY clipboard buffer.
|
||||
.P
|
||||
With the text input widget focused, up/down (or tab/shift-tab) cycle
|
||||
through completions, escape closes the widget and enter accepts the
|
||||
input.
|
||||
.P
|
||||
In hints mode, the input will be accepted as soon as termite considers
|
||||
it a unique match.
|
||||
.SS Current Directory
|
||||
The directory can be set by a process running in the terminal. For
|
||||
example, with \fRzsh\fP:
|
||||
.IP
|
||||
.nf
|
||||
if [[ $TERM == xterm -termite ]]; then
|
||||
. /etc/profile.d/vte.sh
|
||||
|
||||
__vte_ps1
|
||||
|
||||
chpwd() {
|
||||
__vte_ps1
|
||||
}
|
||||
fi
|
||||
.fi
|
||||
.PP
|
||||
or for example, with \fRbash\fP:
|
||||
.IP
|
||||
.nf
|
||||
if [[ $TERM == xterm-termite ]]; then
|
||||
. /etc/profile.d/vte.sh
|
||||
PROMPT_COMMAND=${PROMPT_COMMAND:+$PROMPT_COMMAND; }'__vte_ps1'
|
||||
fi
|
||||
.fi
|
||||
.PP
|
||||
Loading…
Reference in New Issue