.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .if !\nF .nr F 0 .if \nF>0 \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} .\} .\" ======================================================================== .\" .IX Title "SAKURA 1" .TH SAKURA 1 "2017-03-06" "3.4.0" "" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" sakura \- A simple but powerful libvte\-based terminal emulator. .SH "SYNOPSIS" .IX Header "SYNOPSIS" sakura [options...] .SH "DESCRIPTION" .IX Header "DESCRIPTION" sakura is a terminal emulator based on \s-1GTK+\s0 and \s-1VTE.\s0 It's a terminal emulator with few dependencies, so you don't need a full \s-1GNOME\s0 desktop installed to have a decent terminal emulator. .SH "HELP OPTIONS" .IX Header "HELP OPTIONS" .IP "\fB\-?, \-\-help\fR" 8 .IX Item "-?, --help" Show help options. .IP "\fB\-\-help\-all\fR" 8 .IX Item "--help-all" Show all help options .IP "\fB\-\-help\-gtk\fR" 8 .IX Item "--help-gtk" Show \s-1GTK+\s0 Options .SH "APPLICATION OPTIONS" .IX Header "APPLICATION OPTIONS" .IP "\fB\-v, \-\-version\fR" 8 .IX Item "-v, --version" Print version number .IP "\fB\-f, \-\-font\fR" 8 .IX Item "-f, --font" Select initial terminal font .IP "\fB\-n, \-\-ntabs\fR" 8 .IX Item "-n, --ntabs" Select initial number of tabs .IP "\fB\-x, \-\-execute\fR" 8 .IX Item "-x, --execute" Execute command .IP "\fB\-e, \-\-xterm\-execute\fR" 8 .IX Item "-e, --xterm-execute" Execute command (compatible with xterm's \-e option) .IP "\fB\-l, \-\-login\fR" 8 .IX Item "-l, --login" Login shell .IP "\fB\-t, \-\-title\fR" 8 .IX Item "-t, --title" Set window title .IP "\fB\-c, \-\-columns\fR" 8 .IX Item "-c, --columns" Set columns number .IP "\fB\-r, \-\-rows\fR" 8 .IX Item "-r, --rows" Set rows number .IP "\fB\-h, \-\-hold\fR" 8 .IX Item "-h, --hold" Hold window after execute command .IP "\fB\-d, \-\-working\-directory\fR" 8 .IX Item "-d, --working-directory" Set working directory .IP "\fB\-m, \-\-maximize\fR" 8 .IX Item "-m, --maximize" Maximize window .IP "\fB\-s, \-\-fullscreen\fR" 8 .IX Item "-s, --fullscreen" Fullscreen mode .IP "\fB\-\-display=DISPLAY\fR" 8 .IX Item "--display=DISPLAY" X display to use .IP "\fB\-\-config\-file=FILENAME\fR" 8 .IX Item "--config-file=FILENAME" Use alternate configurtation file. Path is relative to the sakura config dir. (Example: ~/.config/sakura/FILENAME). .SH "GTK+ OPTIONS" .IX Header "GTK+ OPTIONS" .IP "\fB\-\-class=CLASS\fR" 8 .IX Item "--class=CLASS" Program class as used by the window manager .IP "\fB\-\-name=NAME\fR" 8 .IX Item "--name=NAME" Program name as used by the window manager .IP "\fB\-\-screen=SCREEN\fR" 8 .IX Item "--screen=SCREEN" X screen to use .IP "\fB\-\-sync\fR" 8 .IX Item "--sync" Make X calls synchronous .IP "\fB\-\-gtk\-module=MODULES\fR" 8 .IX Item "--gtk-module=MODULES" Load additional \s-1GTK+\s0 modules .IP "\fB\-\-g\-fatal\-warnings\fR" 8 .IX Item "--g-fatal-warnings" Make all warnings fatal .SH "KEYBINDINGS SUPPORT" .IX Header "KEYBINDINGS SUPPORT" \&\fBsakura\fR supports keyboard bindings. They are configurable by setting the following properties in your sakura config file (~/.config/sakura/sakura.conf). .SS "\s-1ACCELERATORS\s0" .IX Subsection "ACCELERATORS" Accelerators can be set to any mask value from the GdkModifierType in gdktypes.h; see: .PP http://www.krugle.org/examples/p\-6R7SuZt1c28ljzpZ/gdktypes.h .PP or, on your own system: .PP /usr/include/gtk\-2.0/gdk/gdkkeysyms.h .PP Mask values can be combined by ORing them. .PP For example, to set the delete tab accelerator to Ctrl + Shift: .PP del_tab_accelerator=5 .PP because \s-1GDK_SHIFT_MASK\s0 has a value of 1 (1 << 0), and \s-1GDK_CONTROL_MASK\s0 has a value of 4 (1 << 2); ORing them together, you get 5. .PP I realise that this configuration is not so friendly to non-programmers, but it is a start. :) .SS "\s-1KEYS\s0" .IX Subsection "KEYS" For example, to set the add tab key to 'T': .PP add_tab_key=T .PP Before sakura used keycodes instead of strings. They're still valid. .SS "\s-1DEFAULTS \s0" .IX Subsection "DEFAULTS " .Vb 10 \& Ctrl + Shift + T \-> New tab \& Ctrl + Shift + W \-> Close current tab \& Ctrl + Shift + C \-> Copy selected text \& Ctrl + Shift + V \-> Paste selected text \& Alt + Left cursor \-> Previous tab \& Alt + Right cursor \-> Next tab \& Alt + [1\-9] \-> Switch to tab N (1\-9) \& Ctrl + Shift + S \-> Toggle scrollbar \& Ctrl + Shift + Mouse left button \-> Open link \& F11 \-> Fullscreen \& Shift + PageUp \-> Move up through scrollback by page \& Shift + PageDown \-> Move down through scrollback by page \& Ctrl + Shift + Up \-> Move up through scrollback by line \& Ctrl + Shift + Down \-> Move down through scrollback by line .Ve .PP You can also increase and decrease the font size in the \s-1GTK+\s0 standard way (not configurable): .PP .Vb 2 \& Ctrl + \*(Aq+\*(Aq \-> Increase font size \& Ctrl + \*(Aq\-\*(Aq \-> Decrease font size .Ve .SH "BUGS" .IX Header "BUGS" \&\fBsakura\fR is hosted on Launchpad. Bugs can be filed at: .PP https://bugs.launchpad.net/sakura .SH "AUTHORS" .IX Header "AUTHORS" \&\fBsakura\fR was written by David Gómez . .PP This manual page was written by Andrew Starr-Bochicchio . .PP Both are released under the \s-1GNU\s0 General Public License, version 2 or later.