forked from enlightenment/terminology
659 lines
17 KiB
Groff
659 lines
17 KiB
Groff
.\" Manpage for Terminology
|
|
.TH TERMINOLOGY 1 "May 10, 2020" "1.7.0" "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
|
|
icons for files and so on...
|
|
.SH OPTIONS
|
|
.
|
|
.TP
|
|
.B \-e, \-\-exec <cmnd>
|
|
Specify command to execute.
|
|
Defaults to \fB$SHELL\fP (or passwd shell or \fB/bin/sh\fP)
|
|
When used along with \fB\-S\fP/\fB\-\-split\fP, each argument is used as a command for a
|
|
split, leaving away the extra arguments.
|
|
With 3 splits, one vertical, a command on the right, an horizontal split on
|
|
the left with only a command on the bottom, the following arguments should be used:
|
|
\fB\-\-split v\-h\-\- \-e command1 $SHELL command2\fP
|
|
.
|
|
.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 \fB80x24\fP or \fB80x24+50+20\fP etc.).
|
|
Type: STR.
|
|
.
|
|
.TP
|
|
.B \-n=NAME, \-\-name=NAME
|
|
Set window name.
|
|
Type: STR.
|
|
.
|
|
.TP
|
|
.B \-r=ROLE, \-\-role=ROLE
|
|
Set window role.
|
|
Type: STR.
|
|
.
|
|
.TP
|
|
.B \-S=vh\-, \-\-split=vh\-
|
|
Terminology can start with splits opened as described below.
|
|
The arguments are a string with the following characters:
|
|
\fB\-S v\fP splits terminal vertically
|
|
\fB\-S h\fP splits horizontally
|
|
\fB\-\fP defines a placeholder for a shell or a command when used with
|
|
\fB\-\-exec\fP/\fB\-e\fP
|
|
Examples:
|
|
______
|
|
| | |
|
|
$ \fBterminology \-S v\fP |__|__|
|
|
|
|
______
|
|
|_____|
|
|
$ \fBterminology \-S h\fP |_____|
|
|
|
|
______
|
|
|__| |
|
|
$ \fBterminology \-S vh\fP |__|__|
|
|
|
|
______
|
|
| |__|
|
|
$ \fBterminology \-S v-h\fP |__|__|
|
|
|
|
______
|
|
$ \fBterminology \-S vh--h\fP |__|__|
|
|
\fBhv--v\fP |__|__|
|
|
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
|
|
.B \-f=FONT, \-\-font=FONT
|
|
Set font (NAME/SIZE for scalable, NAME for bitmap.
|
|
Type: STR.
|
|
.
|
|
.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
|
|
.B \-F, \-\-fullscreen
|
|
Go into the fullscreen mode from start.
|
|
.
|
|
.TP
|
|
.B \-I, \-\-iconic
|
|
Go into an iconic state from the start.
|
|
.
|
|
.TP
|
|
.B \-B, \-\-borderless
|
|
Become a borderless managed window.
|
|
.
|
|
.TP
|
|
.B \-O, \-\-override
|
|
Become an override-redirect window.
|
|
.
|
|
.TP
|
|
.B \-M, \-\-maximized
|
|
Become maximized from the start.
|
|
.
|
|
.TP
|
|
.B \-W, \-\-nowm
|
|
Terminology is run without a wm.
|
|
.
|
|
.TP
|
|
.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 \-\-active\-links=ACTIVATE\-LINKS
|
|
Whether to highlight links.
|
|
Type: BOOL.
|
|
.
|
|
.TP
|
|
.B \-\-no\-wizard
|
|
Do not display the wizard on start up.
|
|
Type: BOOL.
|
|
.
|
|
.TP
|
|
.B \-\-scale=SCALE
|
|
Scaling factor to use on the UI.
|
|
Type: DOUBLE.
|
|
.
|
|
.TP
|
|
.B \-V, \-\-version
|
|
Show program version.
|
|
.
|
|
.TP
|
|
.B \-C, \-\-copyright
|
|
Show copyright.
|
|
.
|
|
.TP
|
|
.B \-L, \-\-license
|
|
Show license.
|
|
.
|
|
.TP
|
|
.B \-h, \-\-help
|
|
Show this message.
|
|
|
|
.SH CONTROLS / SHORTCUTS
|
|
.
|
|
.TP
|
|
.B Shift+PgUp
|
|
Scroll terminology one page up.
|
|
.
|
|
.TP
|
|
.B Shift+PgDn
|
|
Scroll terminology one page down.
|
|
.
|
|
.TP
|
|
.B Shift+Up
|
|
Scroll terminology one line up.
|
|
.
|
|
.TP
|
|
.B Shift+Down
|
|
Scroll terminology one line down.
|
|
.
|
|
.TP
|
|
.B Shift+Home
|
|
Scroll terminology to the top of the backlog.
|
|
.
|
|
.TP
|
|
.B Shift+End
|
|
Reset scroll in terminology.
|
|
.
|
|
.TP
|
|
.B Shift+Left
|
|
Switch focus to previous terminal inside a window when using splits, or the
|
|
previous tab.
|
|
.
|
|
.TP
|
|
.B Shift+Right
|
|
Switch focus to next terminal inside a window when using splits, or the next
|
|
tab.
|
|
.
|
|
.TP
|
|
.B Shift+Insert
|
|
Paste Clipboard (ctrl+v/c) selection.
|
|
.
|
|
.TP
|
|
.B Shift+Ctrl+Insert
|
|
Paste Primary (highlight) selection.
|
|
.
|
|
.TP
|
|
.B Shift+Keypad\-Plus
|
|
Font size up by one unit.
|
|
.
|
|
.TP
|
|
.B Shift+Keypad\-Minus
|
|
Font size down by one unit.
|
|
.
|
|
.TP
|
|
.B Shift+Keypad\-Multiply
|
|
Reset font size.
|
|
.
|
|
.TP
|
|
.B Shift+Keypad\-Divide
|
|
Copy highlight to Clipboard (same as ctrl+c in gui apps).
|
|
.
|
|
.TP
|
|
.B Ctrl+PgUp
|
|
Switch focus to previous terminal inside a window when using splits, or the
|
|
previous tab.
|
|
.
|
|
.TP
|
|
.B Ctrl+PgDn
|
|
Switch focus to next terminal inside a window when using splits, or the next
|
|
tab.
|
|
.
|
|
.TP
|
|
.B Ctrl+Shift+h
|
|
Toggle displaying the miniview of the history.
|
|
.
|
|
.TP
|
|
.B Ctrl+Alt+t
|
|
Set tab's title.
|
|
.
|
|
.TP
|
|
.B Ctrl+Shift+t
|
|
Create a new terminal on top of current inside window (tabs).
|
|
.
|
|
.TP
|
|
.B Ctrl+Shift+n
|
|
Launch new terminology.
|
|
.
|
|
.TP
|
|
.B Ctrl+Shift+End
|
|
Close the current terminal.
|
|
.
|
|
.TP
|
|
.B Ctrl+Shift+Home
|
|
Bring up "tab" switcher.
|
|
.
|
|
.TP
|
|
.B Ctrl+Shift+PgUp
|
|
Split terminal horizontally (one terminal above the other).
|
|
.
|
|
.TP
|
|
.B Ctrl+Shift+PgDn
|
|
Split terminal vertically (one terminal to the left of the other).
|
|
.
|
|
.TP
|
|
.B Alt+Home
|
|
Enter command mode (enter commands to control terminology itself).
|
|
.
|
|
.TP
|
|
.B Alt+Return
|
|
Paste primary selection.
|
|
.
|
|
.TP
|
|
.B Alt+g
|
|
Group input: send input to all visible terminals in the window
|
|
.
|
|
.TP
|
|
.B Alt+Shift+g
|
|
Group input: send input to all terminals in the window
|
|
.
|
|
.TP
|
|
.B Alt+w
|
|
Copy selection to primary.
|
|
.
|
|
.TP
|
|
.B Alt+Up
|
|
Focus the terminal above
|
|
.
|
|
.TP
|
|
.B Alt+Down
|
|
Focus the terminal down
|
|
.
|
|
.TP
|
|
.B Alt+Left
|
|
Focus the terminal on the left
|
|
.
|
|
.TP
|
|
.B Alt+Right
|
|
Focus the terminal on the right
|
|
.
|
|
.TP
|
|
.B Ctrl+Shift+c
|
|
Copy current selection to clipboard.
|
|
.
|
|
.TP
|
|
.B Ctrl+Shift+v
|
|
Paste current clipboard selection.
|
|
.
|
|
.TP
|
|
.B Ctrl+1 through Ctrl+0
|
|
Switch to terminal tab 1 through 10.
|
|
.
|
|
.TP
|
|
.B Ctrl+Alt+Equal
|
|
Increase font size. Note that it works on scalable fonts only.
|
|
.
|
|
.TP
|
|
.B Ctrl+Alt+Minus
|
|
Decrease font size. Note that it works on scalable fonts only.
|
|
.
|
|
.TP
|
|
.B Ctrl+Alt+0
|
|
Reset font to default setting saved in config.
|
|
.
|
|
.TP
|
|
.B Ctrl+Alt+9
|
|
Display big font size (10x20 bitmap, or size 20 with scalable).
|
|
|
|
.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
|
|
.B gNxM
|
|
Make terminal NxM chars in size (if possible). e.g. \fBg80x48\fP \fBg40x20\fP.
|
|
If just one number is provided, it will use the following shortcuts:
|
|
\fBg0=80x24\fP; \fBg1=80x40\fP; \fBg2=80x60\fP; \fBg3=80x80\fP;
|
|
\fBg4=120x24\fP; \fBg5=120x40\fP; \fBg6=120x60\fP;
|
|
\fBg7=120x80\fP; \fBg8=120x120\fP
|
|
.
|
|
.TP
|
|
.B b
|
|
Reset the background (no media).
|
|
.
|
|
.TP
|
|
.B bPATH
|
|
Set the background media to an absolute file PATH.
|
|
|
|
.SH THEMES:
|
|
Apart from the ones shipped with Terminology, themes can be stored in \fB~/.config/terminology/themes/\fP.
|
|
|
|
.SH COMPANION TOOLS:
|
|
.
|
|
.TP
|
|
.B tyls
|
|
List directory contents with bells and whistles
|
|
.
|
|
.TP
|
|
.B tyalpha
|
|
Set transparency level of the background
|
|
.
|
|
.TP
|
|
.B tybg
|
|
Change the background image
|
|
.
|
|
.TP
|
|
.B tycat
|
|
Display inline a media file or a URI
|
|
.
|
|
.TP
|
|
.B typop
|
|
Display in a popup a media file or a URI
|
|
.
|
|
.TP
|
|
.B tyq
|
|
Queue media files or URI to be popped up
|
|
.
|
|
.TP
|
|
.B tysend
|
|
Send files to the terminal (useful through ssh)
|
|
|
|
.SH EXTENDED ESCAPES FOR TERMINOLOGY:
|
|
.
|
|
.TP
|
|
.B [\\\033][}][COMMAND][\\\000]
|
|
i.e.
|
|
1. ESC char (\fB\\033\fP or \fB0x1b\fP)
|
|
2. \fB}\fP char
|
|
3... sequence of UTF8 chars other than nul (\fB\\000\fP or \fB0x00\fP).
|
|
4 \fB\\000\fP char (nul byte or \fB0x00\fP to indicate end of sequence)
|
|
e.g.
|
|
\fBecho \-n '\\033}Hello world\\000'\fP
|
|
|
|
.B Commands:
|
|
|
|
any values inside square brackets [] are to be replaced by some content (numbers, strings, paths, url's etc.). example:
|
|
|
|
\fBaa[PATH\-OF\-FILE]\fP should be come something like:
|
|
\fBaa/tmp/file.png\fP
|
|
or \fBaa[true/false]\fP should become something like:
|
|
\fBaatrue\fP
|
|
or
|
|
\fBaafalse\fP
|
|
|
|
\-\-\-
|
|
|
|
\fBpn[FULL\-PATH\-OR\-URL]\fP
|
|
popup the given media file/url now.
|
|
|
|
\fBpq[FULL\-PATH\-OR\-URL]\fP
|
|
queue a popup for the given media file/url.
|
|
|
|
\fBbt[FULL\-PATH\-OR\-URL]\fP
|
|
set the terminal background media file/url temporarily.
|
|
|
|
\fBbp[FULL\-PATH\-OR\-URL]\fP
|
|
set the terminal background media file/url permanently.
|
|
|
|
\fBat[on/true/yes/off/false/no]\fP
|
|
set the terminal alpha state to be on, or off temporarily.
|
|
|
|
\fBap[on/true/yes/off/false/no]\fP
|
|
set the terminal alpha state to be on, or off permanently.
|
|
|
|
\fBqs\fP
|
|
query grid and font size. stdin will have written to it:
|
|
\fBW;H;FW;FH\fP
|
|
where \fBW\fP is the width of the terminal grid in characters
|
|
where \fBH\fP is the height of the terminal grid in characters
|
|
where \fBFW\fP is the width of 1 character cell in pixels
|
|
where \fBFH\fP is the height of 1 character cell in pixels
|
|
|
|
\fBis[CW;H;FULL\-PATH\-OR\-URL]\fP
|
|
insert STRETCHED media (where image will stretch to fill the
|
|
cell area) and define expected cell area to be \fBW\fP cells
|
|
wide and \fBH\fP cells high, with the image/media/url.
|
|
where \fBC\fP is the replace character to be identified in later
|
|
text where \fBW\fP is the width in character cells (up to 511).
|
|
where \fBH\fP is the height in character cells (up to 511).
|
|
|
|
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 \fBW\fPx\fBH\fP "replace characters" to follow, with each sequence of such replace characters bebung with a \fBib\fP escape command and ending with an \fBie\fP escape command.
|
|
|
|
the \fBFULL\-PATH\-OR\-URL\fP for all the \fBi\fP commands (\fBis\fP,
|
|
\fBic\fP, \fBif\fP, \fBit\fP) may be of the form:
|
|
|
|
\fB/full/path/to/file.png\fP
|
|
|
|
OR
|
|
|
|
\fB/full/path/to/link\n/full/path/to/file.png\fP
|
|
|
|
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 click on the given
|
|
media image.
|
|
|
|
example:
|
|
|
|
\fBprintf("\\\033}is#5;3;%s\000"\fP
|
|
\fB"\\\033}ib#####\\\033}ie\\\n"\fP
|
|
\fB"\\\033}ib#####\\\033}ie\\\n"\fP
|
|
\fB"\\\033}ib#####\\\033}ie\\\n", "/tmp/icon.png");\fP
|
|
|
|
note that \fB#\fP is the replace character, and later \fB#\fP chars if inside begin/end escapes, will be replaced by the given media indicated in the insert media escape.
|
|
|
|
\fBic[CW;H;FULL\-PATH\-OR\-URL]\fP
|
|
insert CENTERED media (centered in cell area). Otherwise
|
|
parameters are identical to the \fBis\fP command, but
|
|
retains aspect and is padded by blank space.
|
|
|
|
\fBif[CW;H;FULL\-PATH\-OR\-URL]\fP
|
|
insert FILLED media (fill in cell area). Otherwise parameters
|
|
are identical to the \fBis\fP command but ensures the entire
|
|
area is filled like a background even if media goes beyond
|
|
cell bounds and is clipped.
|
|
|
|
\fBit[CW;H;FULL\-PATH\-OR\-URL]\fP
|
|
insert THUMB media (thumbnail cell area). Otherwise parameters
|
|
are identical to the \fBis\fP command, but uses thumbnail
|
|
generation to make a fast to load but low resolution version
|
|
(cached) of the media.
|
|
|
|
\fBit[CW;H;LINK\\nFULL-PATH-OR-URL]\fP
|
|
insert THUMB media with link (thumbnail cell area). Otherwise parameters
|
|
are identical to the \fBis\fP command, but uses thumbnail generation to
|
|
make a fast to load but low resolution version (cached) of the media.
|
|
\fBLINK\fP is a path (or url) to open _when_ the thumb is clicked on by the
|
|
user.
|
|
|
|
\fBij[CW;H;FULL-PATH\\nGROUP][\\n][cmd1][\\r\\n][cmd2]...\fP
|
|
insert EDJE object with file path given, and the group name given.
|
|
The command list (and the \fB\\n\fP whitespace delimiter before the list)
|
|
is optional, but is executed/parsed before display of the actual
|
|
object to do things like initialize its initial state. See `iC`
|
|
command for more details on the command list.
|
|
|
|
Be aware that once you have an object with an assigned channel id,
|
|
it can send back signals and messages via escapes on stdin. These
|
|
escapes will follow terminology extended escape format
|
|
\fB(ESC + } ... \000)\fP, and the content will be one of:
|
|
|
|
;CHID\\ndrag\\nPART NAME\\nVAL1\\nVAL2
|
|
;CHID\\ndrag,start\\nPART NAME\\nVAL1\\nVAL2
|
|
;CHID\\ndrag,stop\\nPART NAME\\nVAL1\\nVAL2
|
|
;CHID\\ndrag,step\\nPART NAME\\nVAL1\\nVAL2
|
|
;CHID\\drag,set\\nPART NAME\\nVAL1\\nVAL2
|
|
signal;CHID\\nSIGNAL STRING\\nSOURCE STRING
|
|
message;CHID\\nOPCODE ID\\nstring\\nSTRING1
|
|
message;CHID\\nOPCODE ID\\nint\\nINT1
|
|
message;CHID\\nOPCODE ID\\nfloat\\nFLOAT1
|
|
message;CHID\\nOPCODE ID\\nstring_set\\nSTRING1\\nSTRING2\\nSTRING3...
|
|
message;CHID\\nOPCODE ID\\nint_set\\nINT1\\nINT2\\nINT3...
|
|
message;CHID\\nOPCODE ID\\nfloat_set\\nFLOAT1\\nFLOAT2\\nFLOAT3...
|
|
message;CHID\\nOPCODE ID\\nstring_int\\nSTRING1\\nINT1
|
|
message;CHID\\nOPCODE ID\\nstring_float\\nSTRING1\\nFLOAT1
|
|
message;CHID\\nOPCODE ID\\nstring_int_set\\nSTRING1\\nINT1\\nINT2\\nINT3...
|
|
message;CHID\\nOPCODE ID\\nstring_float_set\\nSTRING1\\nFLOAT1\\nFLOAT2\\nFLOAT3...
|
|
|
|
\fBiC[CHID]\\n[cmd1][\\r\\n][cmd2][\\r\\n][cmd3]...\fP
|
|
send a COMMAND (\fBcmd1, cmd2, cmd3\fP etc.) to an existing named
|
|
channel id \fBCHID\fP. this can be a list of 1 or more command strings,
|
|
with each string broken by a continuous sequence of 1 or more \fB\\r\fP
|
|
and/or \fB\\n\fP characters. e.g. "\fB\\n\fP", "\fB\\r\fP", "\fB\\r\\n\fP",
|
|
"\fB\\n\\r\fP", "\fB\\n\\r\\n\\n\\n\fP", etc.
|
|
|
|
commands understood are:
|
|
|
|
\fBtext\\nPART NAME\\nTEXT STRING\fP
|
|
set the text of "\fBPART NAME\fP" to string "\fBTEXT STRING\fP"
|
|
|
|
\fBemit\\nSIGNAL STRING\\nSOURCE STRING\fP
|
|
emit signal "\fBSIGNAL STRING\fP" "\fBSOURCE STRING\fP"
|
|
|
|
\fBdrag\\nPART NAME\\n[value|size|step|page]\\nVAL1\\nVAL2\fP
|
|
manipulate dragable of name "\fBPART NAME\fP" and either set
|
|
"\fBvalue\fP", "\fBsize\fP", "\fBstep\fP" or "\fBpage\fP" properties
|
|
to "\fBVAL1\fP" and "\fBVAL2\fP" for \fBx\fP and \fBy\fP, where
|
|
\fBVAL1\fP and \fBVAL2\fP are floating point values
|
|
|
|
\fBchid\\nCHANNEL ID\fP
|
|
set the channel id of a given edje object (only valid in setup
|
|
commands for the inline edje object) to "\fBCHANNEL ID\fP" so it can
|
|
be addressed later.
|
|
|
|
\fBmessage\\nOPCODE ID\\n[string|int|float|string_set|int_set|...\fP
|
|
\fBfloat_set|string|int|string_float|string_int_set|...\fP
|
|
\fBstring_float_set]\\n[message data]\fP
|
|
send a message with opcode (integer) id "\fBOPCODE ID\fP" of one of
|
|
the given types supported ("\fBstring\fP", "\fBint\fP", "\fBfloat\fP",
|
|
etc.) and then with the given "\fBmessage data\fP" at the end.
|
|
\fBmessage data\fP format depends on message type:
|
|
\fBstring\fP: \fBSTRING1\fP
|
|
\fBint\fP: \fBINT1\fP
|
|
\fBfloat\fP: \fBFLOAT1\fP
|
|
\fBstring_set\fP: \fBSTRING1\\nSTRING2\\nSTRING3...\fP
|
|
\fBint_set\fP: \fBINT1\\nINT2\\nINT3...\fP
|
|
\fBfloat_set\fP: \fBFLOAT1\\nFLOAT2\\nFLOAT3...\fP
|
|
\fBstring_int\fP: \fBSTRING1\\nINT1\fP
|
|
\fBstring_float\fP: \fBSTRING1\\nFLOAT1\fP
|
|
\fBstring_int_set\fP: \fBSTRING1\\nINT1\\nINT2\\nINT3...\fP
|
|
\fBstring_float_set\fP: \fBSTRING1\\nFLOAT1\\nFLOAT2\\nFLOAT3...\fP
|
|
|
|
\fBib\fP
|
|
begin media replace sequence run.
|
|
|
|
\fBie\fP
|
|
end media replace sequence run.
|
|
|
|
\fBfr[PATH/FILE]\fP
|
|
begin file send for a file named \fBPATH\fP / \fBFILE\fP
|
|
|
|
\fBfs[SIZE_BYTES]\fP
|
|
set the size in bytes of a file send started with the above fr escape
|
|
|
|
\fBfd[CHECKSUM DATA]\fP
|
|
block of data for the current file transfer with checksum as a
|
|
string decimal which is the sum of every byte when taken as an
|
|
unsigned char per byte. the checksum is a signed 32bit integer.
|
|
the checksum is the sum of the data after escaping. 4 bits at a
|
|
time per data byte, encoded with high bits in one byte then low
|
|
bits, with the bits encoded as 4 bit value being \fB0x40\fP + 4 bit value
|
|
per byte. \fB(@ == 0x0, A == 0x1, B == 0x2, ... N == 0xe, O == 0xf)\fP.
|
|
so to rebuild a byte will be \fB(((bytes[0] - 0x40) & 0xf) << 4) |
|
|
((bytes[1] - 0x40) & 0xf)\fP per byte pair in the data block.
|
|
|
|
\fBfx\fP
|
|
exit file send mode (normally at the end of the file or when it's
|
|
complete)
|
|
|
|
.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. It is maintained by Boris Faure <boris@fau.re> and others. See AUTHORS file for other contributors.
|