terminology/man/terminology.1

389 lines
8.8 KiB
Groff
Raw Normal View History

.\" Manpage for Terminology
2013-11-16 06:27:18 -08:00
.TH man 1 "18 Nov 2013" "0.4" "Terminology man page"
.SH NAME
Terminology \- Terminal Emulator written with EFL (Enlightenment Foundation Libraries).
.SH SYNOPSIS
.B terminology [options]
.SH DESCRIPTION
This is an EFL terminal emulator with some extra bells and whistles.
It has many features including split terminal support, support for tabs, preview
2013-11-16 06:27:18 -08:00
icons for files and so on...
.SH OPTIONS
.
.TP
.B \-e, \-\-exec <cmnd>
Specify command to execute.
2013-11-28 01:08:53 -08:00
Defaults to $SHELL (or passwd shell or /bin/sh)
.
.TP
.B \-d=CURRENT-DIRECTORY, \-\-current\-directory=CURRENT-DIRECTORY
Change to directory for execution of terminal command.
Type: STR.
.
.TP
.B \-t=THEME, \-\-theme=THEME
Use the named edje theme or path to theme file.
Type: STR.
.
.TP
.B \-b=BACKGROUND, \-\-background=BACKGROUND
Use the named file as a background wallpaper for terminology.
Type: STR.
.
.TP
.B \-g=GEOMETRY, \-\-geometry=GEOMETRY
Terminal geometry to use (eg 80x24 or 80x24+50+20 etc.).
Type: STR.
.
.TP
2013-11-16 06:27:18 -08:00
.B \-n=NAME, \-\-name=NAME
Set window name.
Type: STR.
.
.TP
2013-11-16 06:27:18 -08:00
.B \-r=ROLE, \-\-role=ROLE
Set window role.
Type: STR.
.
.TP
.B \-T=TITLE, \-\-title=TITLE
Set window title.
Type: STR.
.
.TP
.B \-i=ICON\-NAME, \-\-icon-name=ICON\-NAME
Set icon name.
Type: STR.
.
.TP
2013-11-16 06:27:18 -08:00
.B \-f=FONT, \-\-font=FONT
Set font (NAME/SIZE for scalable, NAME for bitmap.
Type: STR.
.
.TP
.B \-v=VIDEO\-MODULE, \-\-video-module=VIDEO\-MODULE
Set emotion module to use. Choices are: auto, gstreamer, xine, generic.
.
2013-11-28 01:08:53 -08:00
.TP
.B \-l=LOGIN, \-\-login=LOGIN
Run the shell as a login shell.
Type: BOOL.
.
.TP
.B \-m=VIDEO\-MUTE, \-\-video-mute=VIDEO\-MUTE
Set mute mode for video playback.
Type: BOOL.
.
.TP
.B \-c=CURSOR\-BLINK, \-\-cursor-blink=CURSOR\-BLINK
Set cursor blink mode.
Type: BOOL.
.
.TP
.B \-G=VISUAL\-BELL, \-\-visual\-bell=VISUAL\-BELL
Set visual bell mode.
Type: BOOL.
.
.TP
2013-11-16 06:27:18 -08:00
.B \-F, \-\-fullscreen
Go into the fullscreen mode from start.
.
.TP
2013-11-16 06:27:18 -08:00
.B \-I, \-\-iconic
Go into an iconic state from the start.
.
.TP
2013-11-16 06:27:18 -08:00
.B \-B, \-\-borderless
Become a borderless managed window.
.
.TP
.B \-O, \-\-override
Become an override-redirect window.
.
.TP
2013-11-16 06:27:18 -08:00
.B \-M, \-\-maximized
Become maximized from the start.
.
.TP
2013-11-16 06:27:18 -08:00
.B \-W, \-\-nowm
Terminology is run without a wm.
.
.TP
2013-11-16 06:27:18 -08:00
.B \-H, \-\-hold
Don't exit when the command process exits.
.
.TP
.B \-s, \-\-single
Force single executable if multi-instance is enabled..
.
.TP
.B \-2, \-\-256color
Set TERM to \fBxterm-256color\fP instead of \fBxterm\fP.
.
.TP
.B \-V, \-\-version
Show program version.
.
.TP
2013-11-16 06:27:18 -08:00
.B \-C, \-\-copyright
Show copyright.
.
.TP
.B \-L, \-\-license
Show license.
.
.TP
.B \-h, \-\-help
Show this message.
.SH CONTROLS / SHORTCUTS
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+PgUp
Scroll terminology one page up
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+PgDn
Scroll terminology one page down
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+Insert
Paste Clipboard (ctrl+v/c) selection
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+Ctrl+Insert
Paste Primary (highlight) selection
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+Keypad\-Plus
Font size up by one unit.
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+Keypad\-Minus
Font size down by one unit.
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+Keypad\-Multiply
Reset font size to 10.
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+Keypad\-Divide
Copy highlight to Clipboard (same as ctrl+c in gui apps).
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+PgUp
Switch focus to previous terminal inside a window (when using splits).
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+PgDn
Switch focus to next terminal inside a window (when using splits).
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+Shift+t
Create a new terminal on top of current inside window (tabs).
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+Shift+Home
Bring up "tab" switcher.
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+Shift+PgUp
Split terminal horizontally (one terminal above the other).
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+Shift+PgDn
Split terminal vertically (one terminal to the left of the other).
.
.TP
2013-11-16 06:27:18 -08:00
.B Alt+Home
Enter command mode (enter commands to control terminology itself)
.
.TP
2013-11-16 06:27:18 -08:00
.B Alt+Return
Paste primary selection.
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+Shift+c
Copy current selection to clipboard.
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+Shift+v
Paste current clipboard selection.
.
.TP
2013-05-06 22:51:02 -07:00
.B Ctrl+1 through Ctrl+0
Switch to terminal tab 1 through 10
.SH MOUSE CONTROLS
.
.TP
.B Right mouse click
Bring up controls menus.
.
.TP
.B Middle mouse click
Paste highlight selection.
.
.TP
.B Left mouse click/drag
Make a selection highlight.
.
.TP
.B Ctrl + Left mouse click/drag
Make a block selection.
.
.TP
.B Wheel
Scroll up or down in history.
.
.TP
.B Ctrl + Wheel
Zoom font size up/down.
.SH COMMAND MODE COMMANDS
To enter command mode in terminology press Alt+Home. Currently command mode
understands the following commands:
.
.TP
.B f
Reset font to default setting saved in config.
.
.TP
.B f+
Increase font size. Note that it works on scalable fonts only.
.
.TP
.B f\-
Decrease font size. Note that it works on scalable fonts only.
.
.TP
.B fb
Display big font size (10x20 bitmap, or size 20 with scalable).
.
.TP
2013-11-16 06:27:18 -08:00
.B gNxM
Make terminal NxM chars in size (if possible). e.g. g80x48 g40x20.
If just one number is provided, it will use the following shortcuts:
g0=80x24; g1=80x40; g2=80x60; g3=80x80; g4=120x24; g5=120x40; g6=120x60;
g7=120x80; g8=120x120
.
.TP
2013-11-16 06:27:18 -08:00
.B b
Reset the background (no media)
.
.TP
2013-11-16 06:27:18 -08:00
.B bPATH
Set the background media to an absolute file PATH
.SH EXTENDED ESCAPES FOR TERMINOLOGY:
.
.TP
.B [\\\033][}][COMMAND][\\\000]
i.e.
1. ESC char (\\033 or 0x1b)
2. } char
3... sequence of UTF8 chars other than nul (\\000 or 0x00).
4 \\000 char (nul byte or 0x00 to indicate end of sequence)
e.g.
echo \-n '\\033}Hello world\\000'
2013-11-16 06:27:18 -08:00
.B Commands:
any values inside square brackets [] are to be replaced by some content (numbers, strings, paths, url's etc.). example:
aa[PATH\-OF\-FILE] should be come something like:
aa/tmp/file.png\n
or aa[true/false] should become something like:
aatrue\n
or
aafalse\n
\-\-\-
pn[FULL\-PATH\-OR\-URL]
popup the given media file/url now
pq[FULL\-PATH\-OR\-URL]
quque a popup for the given media file/url
bt[FULL\-PATH\-OR\-URL]
set the terminal background media file/url temporarily
bp[FULL\-PATH\-OR\-URL]
set the terminal background media file/url permanently
at[on/true/yes/off/false/no]
set the terminal alpha state to be on, or off temporarily
ap[on/true/yes/off/false/no]
set the terminal alpha state to be on, or off permanently
qs
query grid and font size. stdin will have written to it:
W;H;FW;FH\n
where W is the width of the terminal grid in characters\n
where H is the height of the terminal grid in characters\n
where FW is the width of 1 character cell in pixels\n
where FH is the height of 1 character cell in pixels\n
is[CW;H;FULL\-PATH\-OR\-URL]
insert STRETCHED media (where image will stretch to fill the
cell area) and define expected cell area to be W cells
wide and H cells high, with the image/media/url.\n
where C is the replace character to be identified in later
text where W is the width in character cells (up to 511).\n
where H is the height in character cells (up to 511).\n
2013-11-16 06:27:18 -08:00
note that this escape alone has no effect. it indicates a future intention of inserting media into the terminal. the terminal will EXPECT a grid of WxH "replace characters" to follow, with each sequence of such replace characters bebung with a 'ib' escape command and ending with an 'ie' escape command.\n
2013-11-16 06:27:18 -08:00
the FULL\-PATH\-OR\-URL for all the i commands (is, ic, if, it) may be of the form:
2013-11-16 06:27:18 -08:00
/full/path/to/file.png
2013-11-16 06:27:18 -08:00
OR
2013-11-16 06:27:18 -08:00
/full/path/to/link\n/full/path/to/file.png
2013-11-16 06:27:18 -08:00
where a newline character separates a URI for a link and
a full path to a file to display in the region. the link
is the destination URI when a user may clikc on the given
media image.
2013-11-16 06:27:18 -08:00
example:
2013-11-16 06:27:18 -08:00
printf("\\\033}is#5;3;%s\000"
"\\\033}ib#####\\\033}ie\\\n"
"\\\033}ib#####\\\033}ie\\\n"
"\\\033}ib#####\\\033}ie\\\n", "/tmp/icon.png");
2013-11-16 06:27:18 -08:00
note that '#' is the replace character, and later '#' chars if inside begin/end escapes, will be replaced by the given media indicated in the insert media escape.
ic[CW;H;FULL\-PATH\-OR\-URL]
insert CENTERED media (centered in cell area). otherwise
paramaters are identical to the "is" command, but
retains aspect and is padded by blank space.
if[CW;H;FULL\-PATH\-OR\-URL]
insert FILLED media (fill in cell area). otherwise paramaters
are identical to the "is" command but ensures the entire
area is filled like a background even if media goes beyond
cell bounds and is clipped.
it[CW;H;FULL\-PATH\-OR\-URL]
insert THUMB media (thumbnail cell area). otherwise paramaters
are identical to the "is" command, but uses thumbnail
generation to make a fast to load but low resolution version
(cached) of the media.
ib
begin media replace sequence run
ie
end media replace sequence run
.SH BUGS
If you find a bug or for known issues/bugs/feature requests please email enlightenment-devel@lists.sourceforge.net or visit the place where all the hard work is done http://phab.enlightenment.org/
.SH AUTHOR
Terminology was written by Carsten Haitzler <raster@rasterman.com> and others. See AUTHORS file for other contributors.