ETERM
Section: X Tools (1)
Updated: 17 August 2008
Index
Return to Main Contents
NAME
Eterm - the Enlightened terminal emulator for the X Window System
SYNOPSIS
Eterm
[options]
DESCRIPTION
Eterm
--- version
0.9.6
--- is a color vt102 terminal emulator intended as an
xterm(1)
replacement. It is designed with a Freedom of Choice philosophy, leaving as
much power, flexibility, and freedom as possible in the hands of the user.
It is designed to look good and work well, but takes a feature-rich approach
rather than one of minimalism.
Eterm
uses Imlib for advanced graphic abilities. See below for details.
OPTIONS
The
Eterm
options are listed below.
In keeping with the freedom-of-choice philosophy, options may be eliminated
or default values chosen at compile-time, so options and defaults listed
may not accurately reflect the version installed on your system.
Options that do not take a parameter (besides -h and --help) are boolean. If
you use the POSIX (short) option, you are forcing the parameter to "true". If
you use the long option, you can use any of the accepted boolean values, which
are "yes", "on", "1", and "true" to turn the option on, or "no", "off", "0", or
"false" to turn the option off. The same is true for boolean values in the
configuration file.
- -t theme, --theme theme
-
Load specified
theme.
Consult the FAQ for more details on what constitutes an Eterm
theme.
- -X conffile, --config-file conffile
-
Use an alternative user config file name. Otherwise Eterm uses the default,
which is
user.cfg.
The theme config file is always
theme.cfg.
- -d displayname, --display displayname
-
Attempt to open a window on the named X display
displayname.
In the absence of this option, the display specified by the
DISPLAY
environment variable is used.
- --debug level
-
Show debugging output.
level
is an integer between 0 and 5 which determines how verbose the debugging
output is.
- --install
-
Tells Eterm to install its own colormap rather than using the default
one.
- -h, --help
-
Print out a message describing available options.
- --version
-
Print
Eterm
version and compile-time configuration.
- -r, --reverse-video
-
Reverse video, swaps the foreground and background colors.
- -b color, --background-color color
-
Set
color
as the background color.
NOTE:
this will actually be the foreground color if reverse video is also
selected.
- -f color, --foreground-color color
-
Set
color
as the foreground (text) color.
NOTE:
this will actually be the background color if reverse video is also
selected.
- --color0 color
-
- ...
-
- --color15 color
-
Use
color
as color X.
- --colorBD color
-
Use
color
as the bold color.
- --colorUL color
-
Use
color
as the underline color.
- --pointer-color color
-
Use
color
as the pointer color.
- -c color, --cursor-color color
-
Use
color
as the cursor color.
- --cursor-text-color color
-
Use
color
as the cursor text color.
- -g geom, --geometry geom
-
Window geometry as Width x Height+X coord+Y coord, i.e 100x200+0+100
- -i,--iconic
-
Start in iconified state (only if the window manager supports
iconification).
- -n name, --name name
-
Sets name of current instance to
name.
This will affect the icon title and the window title string unless
they are otherwise explicitly set.
- -T title, --title title
-
Sets window's title text to
title.
- --icon-name text
-
Sets the icon title text to
text.
- -B type, --scrollbar-type type
-
Specifies the
type
scrollbar style should be used.
type
can be any of
motif, xterm, or next.
- --scrollbar-width width
-
Set the width of the scrollbar, in pixels, to
width.
Eterm does not impose any restrictions on this value, but it should be reasonable.
- -D desktop, --desktop desktop
-
Starts the Eterm on the specified desktop.
desktop
should be an integer between 0 and your highest-numbered desktop.
NOTE:
You must have a GNOME-compliant window manager for this feature to work. Please see
http://www.gnome.org/devel/gnomewm/ for more information on the
_WIN_WORKSPACE
property and how to support it.
- --line-space num
-
Size of the extra gap, in pixels, to provide between lines in the terminal window.
- --bold-font font
-
Sets the bold text font to
font.
- -F font, --font font
-
Sets the normal text font to
font.
- --default-font-index num
-
Specifies the index of the default (normal) text font.
- --font1 font
-
- ...
-
- --font4 font
-
Sets the font at the specified index (1-4) to
font.
- --proportional
-
Specifies that the font in use is proportional and requests standard
deviation-based character cell spacing. Terminals must use
fixed-width character cells to maintain proper columnal alignment,
even when proportionally-spaced fonts are in use. Some
proportionally-spaced fonts vary greatly between the minimum and
maximum character widths. This option chooses a character cell size
which is up to two standard deviations above the average character
width but will not exceed the maximum width of the largest glyph.
Note that characters larger than the chosen cell width will overwrite
(or be overwritten by) other characters and may tend to leave pixel
droppings. This behavior is an expected side-effect of an imperfect
scenario. If you object to this behavior, do not use this option.
- --font-fx effects
-
Specifies the effects to apply to the terminal window font. The value
of
effects
is a single string containing a series of corner/color pairs. These
pairs define toward which corner a drop shadow of each character
should be made, and what color that shadow will be. The corner is
specified first using the following keywords:
top_left or tl,
top_right or tr,
bottom_left or bl, and
bottom_right or br.
Each corner specifier is then followed by a color.
There are also several shortcuts for doing common effects. You can
get a single-color outline by using the keyword
outline
followed by a color. A single-color drop shadow is also available
using the keyword
shadow
followed by an optional corner specifier
(bottom_right being the default)
and a color. For a 3-D embossed look, use
emboss dark_color
light_color.
The opposite effect, a carved-out look, can be obtained with
carved dark_color
light_color.
(Of course, with those last two, the 3-D look will only work if you
choose the light and dark colors wisely.)
Finally, for no font effects at all, simply specify the keyword
none.
The default value is
bottom_right black
which yields a black drop shadow, greatly improving the visibility of
lightly-colored fonts on top of light spots in a background image.
Note that font effects are not active in solid color mode.
- -P pic, --background-pixmap pic
-
Use
pic
as the background image.
pic
can be in any format that Imlib understands. Currently this means just
about anything, including JPG, PNG, GIF, TIFF, PPM, etc. The image is
tiled by default. To specify alternate geometry, follow the filename
with an
@
sign and the geometry string. Image geometry is specified as
@wxh+x+y:ops
where
w and h
are the horizontal/vertical scaling percentages,
x and y
are the horizontal/vertical alignment percentages, and
ops
is a colon-delimited list of operations:
tiled (to tile the image),
propscaled (for proportional scaling).
Note that these operations can be combined for various effects.
- -I pic, --icon pic
-
Sets the icon pixmap file to
pic.
Works similarly to the
-P
option above.
- --up-arrow-pixmap pic
-
As above, except the scrollbar's up-arrow is set.
- --down-arrow-pixmap pic
-
As above, except the scrollbar's down-arrow is set.
- --trough-pixmap pic
-
As above, except the scrollbar's background (trough) is set.
- --anchor-pixmap pic
-
As above, except the scrollbar's anchor image is set.
- --menu-pixmap pic
-
As above, except the menu background image is set.
- -O, --trans
-
This gives a pseudo-transparent Eterm. The image is taken directly from the
root window, so any requests for changing the pixmap are ignored. If you do
not use Enlightenment (http://www.enlightenment.org/) as your window manager
(or another compliant window manager...I have been told that WindowMaker works
also), you will need to use the
Esetroot
program (found in the
utils/
directory) to set your root background image.
- -0, --itrans
-
Activate the immotile transparency optimization for transparent Eterm
windows. Note that this does NOT activate transparency; you must
still include the
-O or --trans
option. This option should be used on transparent windows which are
shaded or tinted and which do not move around on the desktop much.
See the
Mon Mar 6 21:11:13 PST 2000
ChangeLog entry for a more detailed explanation.
- --viewport-mode
-
This activates a special Eterm mode which is hard to describe in words.
Basically, imagine the effect you get with pseudo-transparency, where
the desktop background moves through the Eterm window as you move the
window, so that it always aligns with the desktop image. Now, imagine
the same effect, but the image used isn't the desktop image but any
pixmap you choose. The image is scaled or tiled up to the size of the
desktop, and dragging the Eterm around the screen reveals different
portions of the image as you move, much like a small viewport window
in a ship or submarine does. The effect is especially keen if you
open several Eterms in this mode with the same image.
- --shade percentage
-
Shade the background image/transparency by a specified percentage.
- --tint mask
-
- --tint color
-
Tints the background pixmap (either an image file or the transparent
portion can be shaded). The
mask
is an integer, usually specified in hexadecimal in the form
0xRRGGBB,
where
RR, GG, and BB
are hexadecimal numbers between
00 and ff (0 and
255 decimal)
which represent the brightness of the image's red, green, and blue
values, respectively. A value of
00
will mask that color out entirely, while a value of
ff
will not change that color at all.
You may also specify an X
color
such as
grey75 or MidnightBlue or #babb7f
instead of a
mask.
- --cmod brightness [ contrast [ gamma ] ]
-
Specifies a color modifier to apply to the image overall. Each of the three
values is a number greater than or equal to 0. The numbers can be specified as
decimal, octal (if preceded by "0"), or hexadecimal (if preceded by "0x").
A value of 256 (0x100) represents 100%, or "leave that value unchanged."
0 represents 0%, 512 (0x200) is 200%, etc. However, be aware that overflow
can occur with excessively high values. Only the
brightness
value is required for this option. Keep in mind, though, that you must
specify
brightness with contrast, and both of these with gamma.
- --cmod-red brightness [ contrast [ gamma ] ]
-
Same as above, except that the modifier applies to the red values of the
image.
- --cmod-green brightness [ contrast [ gamma ] ]
-
Same as above, except that the modifier applies to the green values of the
image.
- --cmod-blue brightness [ contrast [ gamma ] ]
-
Same as above, except that the modifier applies to the blue values of the
image.
- -p newpath, --path newpath
-
Sets the pic search path. When the
--background-pixmap
or other pixmap options are used, this path will be used to find the
image.
- --cache size
-
Specify the
size
in bytes for the Imlib2 cache.
- -N list, --anim list
-
Specifies an animation list to be use in cycling the background pixmap. The
list
consists of two or more words. The first word defines the delay, in seconds,
between updates of the background. This should be set to a reasonable value
to insure that Eterm doesn't spend all its time rendering backgrounds. All
remaining words specify background images and have the same syntax as
the
-P
option above, including the optional geometry string.
- -M font, --mfont font
-
Sets the normal multibyte text font to
font.
- --mfont1 font
-
- ...
-
- --mfont4 font
-
Sets multibyte font X to
font.
- --mencoding encoding
-
Sets multichar encoding mode (eucj or sjis or euckr)
- --input-method method
-
Sets XIM input method
- --preedit-type type
-
Sets XIM preedit type
- -l, --login-shell
-
Makes the new shell a login shell.
- -s, --scrollbar
-
Enables the scrollbar. (Default)
- -u, --utmp-logging
-
Tries to enable proper utmp logging. For this to work, Eterm probably needs
to run setuid or setgid, usually setuid root.
- -v, --visual-bell
-
Enables the "visual bell". Means the window will flash or blink rather
than beep.
- -H, --home-on-output
-
Jump to bottom on output.
- --home-on-input
-
Jump to bottom on input.
- -q, --no-input
-
Keeps Eterm from accepting keyboard input, and keeps the window
manager from focusing it. Useful for log tailers and such.
- --scrollbar-right
-
Display scrollbar on the right hand side.
- --scrollbar-floating
-
Display the scrollbar without a trough.
- --scrollbar-popup
-
Display the scrollbar only when the Eterm window is focused.
- -x, --borderless
-
This option forces Eterm to have no borders.
- -S, --sticky
-
Start Eterm as a sticky window (shows on all desktops)
- -m, --map-alert
-
Un-iconify on beep.
- -8, --meta8
-
Causes the Meta key to set the 8th bit in the char.
- --double-buffer
-
Rather than drawing text directly onto the window, this option causes
Eterm to allocate an additional pixmap the size of the terminal window
into which the background *and* the text are rendered. This pixmap is
then set as the window background. Double-buffering uses additional
memory in the X server, but it allows Eterm to ignore expose events so
redraws are faster.
- --no-cursor
-
Disables the text cursor.
- --pause
-
After the child process terminates, Eterm will wait for a keypress
before exiting.
- --xterm-select
-
Duplicate's xterm's treatment of cutchars. The only real difference is
what happens when you double click on a single cutchar between two
words. If this option is on, only that single character gets selected.
If it is off, that character is selected along with the two words. The
latter behavior is useful for double-clicking on the space between someone's
first and last names, or the @ sign in an e-mail address, etc.
- --select-line
-
If activated, this option causes a triple click to select the entire line
from beginning to end. If off, a triple-click selects just from the current
word to the end of the line.
- --select-trailing-spaces
-
Determines whether or not trailing spaces in a selection are maintained (on)
or discarded (off).
- --report-as-keysyms
-
Reports certain keystrokes as keysyms and modifiers rather than escape sequences.
NOTE:
This option is intended for use only with programs that support this special Eterm
mode. Do not enable it unless you are executing a program which uses this mode.
- --buttonbar
-
Toggle the display of all buttonbars.
- --resize-gravity
-
If true, Eterm will automatically detect the nearest corner, and
font-change resizes will cause the Eterm window to gravitate toward
that corner.
- --overstrike-bold
-
If true (default), Eterm will simulate a bold font by printing each
character twice, offsetting the second pass by one pixel. This makes
the characters seem thicker without the need for a special font. You
may wish to disable this if you use a specific color for bold.
- --bold-brightens-foreground
-
If true (default), Eterm will use the "bold" ANSI color attribute to
brighten the foreground color by using the high-intensity colors (8
through 15) rather than the low-intensity colors (0 through 7). Note
that having a specific color selected for bold will override this.
- --blink-brightens-background
-
If true (default), Eterm will use the "blink" ANSI color attribute to
brighten the background color by using the high-intensity colors (8
through 15) rather than the low-intensity colors (0 through 7).
- --colors-suppress-bold
-
If true (default), any colored text (that is, any text not rendered
using the default foreground color) will not be given any other
special treatment for bolding (e.g., bold font or bold overstrike).
- --big-font-key keysym
-
Specify a keysym to increase the font size. Default is Shift and the +
key on the keypad. Ctrl-> or Meta-> may also work (if you #define one
of the hotkeys in src/feature.h).
- --small-font-key keysym
-
Specify a keysym to decrease the font size. Default is Shift and the -
key on the keypad. Ctrl-< or Meta-< may also work (if you #define one
of the hotkeys in src/feature.h).
- --meta-mod num
-
Specify which X modifier (1-5) to treat as the Meta key. See
xmodmap(1)
and the output of
xmodmap -pm
for more details.
- --alt-mod num
-
Same as
--meta-mod,
but for the Alt key.
- --numlock-mod num
-
Same as
--meta-mod,
but for the NumLock key.
- --greek-keyboard mode
-
Use Greek keyboard mapping (iso or ibm).
- --app-keypad
-
Start Eterm in application keypad mode (as opposed to normal keypad mode).
- --app-cursor
-
Start Eterm in application cursor key mode (as opposed to normal cursor
key mode).
- -L num, --save-lines num
-
Set the number of lines in the scrollback buffer to
num.
- -a size, --min-anchor-size size
-
Specifies the minimum size, in pixels high, of the scrollbar anchor.
NOTE:
This causes abnormal scrolling behavior when combined with large
scrollback buffers!
- -w width, --border-width width
-
Set the window's border width to
width.
The border this controls is the gap between the edge of the X window and
the edge of the terminal window; this has nothing to do with the window
border's your window manager supplies.
- --print-pipe pipe
-
The pipe for the PrintScreen function.
- --cut-chars separators
-
The separators for double-click selection.
- --finished-title title
-
Specifies the string Eterm should add to its title bar if
--pause
is specified and the child process completes.
- --finished-text text
-
Same as above, but displays text in the terminal window.
- --term-name TERM
-
Use
TERM
for the value $TERM.
- --pipe-name pipe
-
Specifies a named pipe from which to display output. This is useful
for systems where syslog output goes to a named pipe, like
/dev/xconsole
on Debian.
- -a line, --attribute line
-
This option is used to pass config file attributes on the command
line.
line
should be a single string, so you will almost certainly have to quote
it. The first word of
line
must be the context (see config file section below) which should parse
the rest of the
line.
So, for example, you could specify the foreground color like so:
-a 'color foreground blue'.
Or you could add a binding:
-a 'actions bind anymod button1 to script exit'.
Note that this option may only be used with config file attributes
that are not context-sensitive; i.e., menus and imageclasses cannot be
specified using this option.
- -C, --console
-
Grab console messages. Depending on your system, Eterm may need to be
setuid root to do this.
- -e command, --exec command
-
Execute
command
rather than a shell. Forces Eterm mode.
- -U URL, --url URL
-
Pick up a "screen" session at
URL
rather than a local (-U "") one. URLs look like so
(screen://user@host.dom:port/screen_options), with all parts optional,
defaulting to "screen://current_user@localhost:22/-RDD". Forces Escreen mode,
overrides --exec. Note that only screen-options (see "man screen") are
allowed; do not pass a command (with or without arguments) here: to pass
a command to the screen-session, use
screen [<options>] <command> [<args>]
instead.
- -Z lclport:fw:fwport,delay, --fw lclport:fw:fwport,delay
-
The URL given to -U is in an intranet behind firewall
fw
so we'll build an SSH-tunnel to that firewall (to port 22/SSH, or
fwport
if given) from our local machine (using any available port-number, or
lclport
if given). Then, after
delay
seconds (or a sensible default if not given), we will try to open a
screen session on the host behind the firewall using
ssh -p localport ... localhost screen
cf.
ssh -L
THEMES
Eterm is built on the philosophy of Freedom of Choice. Each user
should be able to choose the environment in which he or she wishes to
exist, and the tools used should support that. In accordance with
that philosophy, Eterm is extremely configurable. Eterm supports a
concept called "themes," which should be familiar to users of
Enlightenment, icewm, or Microsoft Windows 95/98/NT. The general
concept of a theme is a collection of resources that change as many
aspects of a programs look and feel as possible. For example, an
Enlightenment theme allows you to customize menus, window borders,
desktops, icons, iconbars, and everything else about how E looks and
feels.
An Eterm theme consists of a primary configuration file, always called
"theme.cfg", residing in a directory bearing the same name as the
theme. This directory must be a child of one of the directories
specified by CONFIG_SEARCH_PATH in src/feature.h. The theme may also
contain additional configuration files referenced by the primary
theme.cfg file, as well as pixmaps, menu files, documentation, etc.,
which are allowable as extensions to the minimum requirement of an
Eterm theme.
By convention and default, Eterm themes should be stored under
~/.Eterm/themes/<theme_name>/ or /usr/share/Eterm/themes/<theme_name>.
Eterm now supports the existence of a user configuration file as a
supplement to the theme configuration file. The default name for this
file is user.cfg, and it follows the exact same syntax as any other
configuration file. It is searched for using the same algorithm used
for the theme.cfg file, and any settings in the user.cfg will override
any previous values for those settings defined by the theme. Thus, it
is recommended that any user.cfg files not be complete config files,
but rather only contain those values which the user wishes to
explicitly override.
NOTE: If you have a user.cfg file in the Eterm theme directory or in
~/.Eterm/, it will override
any
previous settings, even if you are running a different theme. For
example, if you run the trans theme, but
~/.Eterm/themes/Eterm/user.cfg has a mode line which sets the image
mode to "image" rather than "trans," you will not get transparency.
This is why user.cfg files should be kept small and only override
settings that you know you want to enforce. If, on the other hand,
you were running the trans theme and had a user.cfg file in the trans
theme (or in ~/.Eterm/themes/trans/), that user.cfg would be found
before the one in the Eterm theme.
Almost all command line options can be enabled/disabled in the theme's
configuration file (the default is /usr/share/Eterm/themes/Eterm/theme.cfg). The
next section contains details on the format and usage of the
configuration file.
CONFIGURATION
Since Eterm 0.9.6 is based on the concept of themes, it is vital
that you have a thorough understanding of the previous section before
taking on this one. The previous section and this one were written by
the same person who wrote the Eterm code which handles options, config
files, and themes, so it's probably the most authoritative
documentation on the subject you're going to find.
From here on out, I will assume you've read the above text and know
how to change the default value for the theme. It is highly
recommended that you have a copy of the Eterm theme config file that
comes with Eterm handy while you read this documentation.
Okay, first the general idea. The theme.cfg file is composed of
comments and non-comments. Comments begin with a pound sign and
continue to the end of the line. Lines of whitespace are also
ignored. The rest of the file is the config stuff, which is divided
into sections (called "contexts") and variables (called "attributes").
There are several contexts which are listed below in sections. Each
attribute must be inside a certain context to be valid. For instance,
while the "foreground" attribute is perfectly acceptable in the color
context, it would be rejected if found in, say, the toggles context.
This allows for better organization of the config file as well as for
multiple contexts to have attributes of the same name (like the
scrollbar
attributes in the color and toggles section).
Each context must be enclosed in a begin...end pair that specifies the
type of section. The statement "begin toggles" starts the toggles
context, and the next "end" statement would terminate it. (You'll
notice that some "end" statements have the context name after them.
This is for readability only; any text after the word "end" is
ignored.)
The rest of this section will contain a step-by-step analysis of the
config file, including what can go in each section. Note that some
attributes (and even entire contexts) may not be available depending
on what support was compiled into Eterm by the person who built it.
- MAGIC NUMBER
-
The first line of the config file must contain a "magic number" type
line that lets Eterm verify that it's reading an Eterm config file and
not something else (like an Enlightenment 0.13 and earlier config
file). The line should look like this:
<Eterm-VERSION>
where VERSION is the Eterm version for which the config file is
intended. For example, config files written for Eterm 0.9 should have
"<Eterm-0.9>" as their first line, followed immediately by a newline.
- COLOR CONTEXT
-
This context contains color specifications. With the exception of
the terminal colors 0-15, all
colors
should be either a valid color name or an RGB string as outlined in the
X11(7)
man page.
-
foreground color
-
Use
color
for the foreground (text) color.
background color
-
Use
color
for the background color.
cursor color
-
Use
color
for the cursor color.
cursor_text color
-
Use
color
for the cursor text color.
pointer color
-
Use
color
for the mouse pointer color.
video { normal | reverse }
-
normal
will not reverse the foreground and background colors.
reverse
(meaning reverse video) will.
color num color
-
Set terminal color
num
(0-15) to the color name, string, or set of 3 decimal/hex/octal RGB values
specified by
color.
color { bd | ul }
color
-
Set terminal bold
(bd) or underline (ul) color
to the color name, string, or set of 3 decimal/hex/octal RGB values
specified by
color.
- ATTRIBUTES CONTEXT
-
This context contains X11 attributes. Most of these are dependent
upon the cooperation of the window manager.
-
geometry geom
-
Use the geometry string
geom
to specify the startup geometry.
geom
should be in the format
WxH+X+Y
where
W
is the width,
H
is the height, and
+X
and
+Y
are the X and Y offsets. If the signs on
X
and
Y
are positive, the coordinates are offsets (in pixels) from the left and top,
respectively, of the screen. If the signs are negative, the offsets are
relative to the right and bottom of the screen, respectively.
title title
-
Use
title
as the text in the title bar of the Eterm window.
name name
-
Use
name
as the resource name of the Eterm window.
iconname name
-
Use
name
as the icon name of the Eterm window icon.
desktop num
-
Start Eterm on desktop
num.
NOTE:
This requires a GNOME-compliant Window Manager. Please see
http://www.gnome.org/devel/gnomewm/ for more information on the
_WIN_WORKSPACE
property and how to support it.
scrollbar_type type
-
Use a scrollbar with the
type style. type can
be any of
motif, xterm, or next.
scrollbar_width num
-
Use a scrollbar that is
num
pixels wide.
font num font
font bold font
-
Set the
numth
font, or the
bold
font, to
font.
font default num
-
Specifies that the
numth
font should be considered the "default" font.
font proportional boolean
-
Specifies that the font in use is proportional and requests standard
deviation-based character cell spacing. Terminals must use
fixed-width character cells to maintain proper columnal alignment,
even when proportionally-spaced fonts are in use. Some
proportionally-spaced fonts vary greatly between the minimum and
maximum character widths. This option chooses a character cell size
which is up to two standard deviations above the average character
width but will not exceed the maximum width of the largest glyph.
Note that characters larger than the chosen cell width will overwrite
(or be overwritten by) other characters and may tend to leave pixel
droppings. This behavior is an expected side-effect of an imperfect
scenario. If you object to this behavior, do not use this option.
font fx effects
-
Specifies the effects to apply to the terminal window font. The value
of
effects
is a single string containing a series of corner/color pairs. These
pairs define toward which corner a drop shadow of each character
should be made, and what color that shadow will be. The corner is
specified first using the following keywords:
top_left or tl,
top_right or tr,
bottom_left or bl, and
bottom_right or br.
Each corner specifier is then followed by a color.
There are also several shortcuts for doing common effects. You can
get a single-color outline by using the keyword
outline
followed by a color. A single-color drop shadow is also available
using the keyword
shadow
followed by an optional corner specifier
(bottom_right being the default)
and a color. For a 3-D embossed look, use
emboss dark_color
light_color.
The opposite effect, a carved-out look, can be obtained with
carved dark_color
light_color.
(Of course, with those last two, the 3-D look will only work if you
choose the light and dark colors wisely.)
Finally, for no font effects at all, simply specify the keyword
none.
The default value is
bottom_right black
which yields a black drop shadow, greatly improving the visibility of
lightly-colored fonts on top of light spots in a background image.
Note that font effects are not active in solid color mode.
- IMAGECLASSES CONTEXT
-
This context contains global image attributes. It also provides the
parent context for defining images via the "image" context.
-
icon filename
-
Use
filename
as the icon image for the Eterm window.
filename
can be an absolute path, relative to the current theme, or relative to
one of the directories in the
path
attribute listed below.
cache num
-
Sets the Imlib2 cache size to
num
bytes. The default is 0.
path directory_list
-
Specifies a colon-delimited list of directories relative to which
Eterm should search for image and menu files. The syntax for
directory_list
is precisely the same as that of the
$PATH
environment variable in UNIX shells.
anim interval images ...
-
Specifies an animation list to be use in cycling the background pixmap. The
interval
defines the delay, in seconds, between updates of the background.
This should be set to a reasonable value to insure that Eterm doesn't
spend all its time rendering backgrounds. All the
images
specify background images and have the same syntax as the
-P
option above, including the optional geometry string.
- IMAGE CONTEXT
-
This context defines all the attributes of a particular image. There
can be (and usually are) several image contexts per theme, one for
each class of image.
-
type class
-
Specifies the type, or
class,
of the image that is going to be defined in that context. This MUST be the
first attribute defined in the image context. Valid classes are:
background, trough, anchor,
up_arrow, down_arrow, left_arrow,
right_arrow, menu, menuitem,
submenu, button, and buttonbar.
Note that the left and right arrows, while valid, don't do anything just
yet. All the subsequent attributes up to the next
type
definition will be applied to that image class.
-
mode initial_mode [ allow allowed_modes ]
-
Specifies the initial mode for this image class as well as the modes which
the image class is allowed to use.
initial_mode
is the mode that the image will have on startup (unless overridden by
command-line options.
allowed_modes
is a list of one or more modes. The image will be prevented from switching
to any mode not listed in the
allow
section. If the
allow
section is omitted entirely, the image will never be permitted to change
from the
initial_mode.
If no
mode
line is specified for an image class, the default is equivalent to
mode solid allow solid.
Valid mode names are
image (to use an image), trans (for transparency), viewport (for viewport mode),
auto (for auto mode, which requires Enlightenment 0.16 or better), and solid (which is a solid color only).
-
state { normal | selected |
clicked | disabled }
-
This sets the state of the image you are about to define. Up until the next
state
attribute that is encountered (or until you change types), all attributes will
apply to that particular state of the image. You should at minimum define the
normal
state of the image. It will be used as the default if the attributes
for the other states are not specified. However, each image state has
self-contained options. Therefore, if you define multiple states for
an image class, you must define ALL attributes needed by that state.
The sample themes supplied with Eterm demonstrate how to define 1-,
2-, 3-, and 4-state images.
The above attributes affect the image class as a whole. All remaining
attributes in this context affect only the current state of the image class.
-
color fg bg
-
Sets the foreground and background colors for this imageclass. The
foreground color is used for text, and the background color is used
for the object itself. If an invalid color is specified, the default
value for
fg
is white, and the default for
bg
is black.
-
file filename
-
Sets the filename from which to load the image file. This is used for the
image
mode. If you allow the image mode for your image, don't forget to supply an
image file! Note that you can also supply an image geometry string here by
adding an
@
symbol and the geometry string to the end of the filename. See below for the
syntax of the geometry string.
filename
must be an absolute path or a path relative to one of the directories in the
path
attribute. Note that the image is verified and loaded when this attribute is
encountered during parsing.
-
geom image_geometry
-
Specifies the geometry and geometry-related operations which are to be applied
to the image. This attribute only applies to image classes using the
image
mode. Image geometry is specified as
wxh+x+y:ops
where
w and h
are the horizontal/vertical scaling percentages,
x and y
are the horizontal/vertical alignment percentages, and
ops
is a colon-delimited list of operations:
tiled (to tile the image),
propscaled (for proportional scaling).
Note that these operations can be combined for various effects.
-
cmod { image | red | green | blue } brightness [ contrast [ gamma ] ]
colormod { image | red | green | blue } brightness [ contrast [ gamma ] ]
-
Specifies a color modifier to apply to the image. The second keyword determines
whether the modifier will be applied to the image overall, the red values, the
green values, or the blue values. Each of the three parameters is a number
greater than or equal to 0. The numbers can be specified as decimal, octal (if
preceded by "0"), or hexadecimal (if preceded by "0x"). A value of 256 (0x100)
represents 100%, or "leave that value unchanged." 0 represents 0%, 512 (0x200)
is 200%, etc. However, be aware that overflow can occur with excessively high
values. Only the
brightness
value is required for this option. Keep in mind, though, that you must
specify
brightness with contrast, and both of these with gamma.
-
border left right top bottom
-
Specifies that the image has borders which should not be scaled with the rest of
the image. This is primarily used for images that have a beveled look, so that
the bevel will not end up getting scaled and lose the bevel effect. All four
parameter values are in pixels, just like the equivalent options for E themes
and Gtk+ pixmap themes.
-
bevel { up | down }
left right top bottom
-
Adds a bevel to an image class. This can be done to any image class using the
image or trans
modes. The parameters are pixel values which represent the width of each edge
of the bevel. This is especially useful if you want to use tiled images or
transparency for the arrow or anchor scrollbar widgets, or for menus.
-
padding left right top bottom
-
This is used only for the
submenu
image class. It defines the amount of pixels on each side to reserve so that
the text will not overwrite part of the image. Works just like the same option
in Enlightenment themes.
- MENU CONTEXT
-
This context is used to create a menu. There is one instance of this context
per menu, and the menus should be defined in submenu-menu order; i.e., any menu
that refers to another menu (as its submenu) should be defined after the submenu
is defined. Within the menu context, there should be a menuitem subcontext for
each menu item (with the exception of the shorthand for separators).
-
title menu_title
-
This specifies the title for the menu to be defined. This MUST be the first
attribute given after the "begin menu". The title must be unique amongst all
the menus. It may contain spaces, but don't forget to enclose it in single or
double quotes if it does. Any future references to the menu will use the
title.
-
font font_name
-
Tells Eterm to use
font_name
as the font for this menu. If not given, the default terminal font is used.
-
sep or -
-
These symbols can be used as shorthand to insert a separator into the menu.
- MENUITEM CONTEXT
-
This is a subcontext of the menu context which creates a single item for a menu.
There can be (and usually are) several menuitem contexts per menu.
-
text label
-
This is the text that is displayed for this menuitem. It is left-justified in
the menu window. It can have spaces, but enclose
label
in quotes if it does.
-
rtext label
-
This is text which is right-justified next to the menuitem text. This is
generally used to show what keystrokes correspond to a particular menu item,
like "C-x C-c" for the "Exit" menuitem in an Emacs menu.
-
action { string | echo | submenu | script } param
action separator
-
Specifies the action to occur when the menuitem is chosen. If you specify
separator,
nothing else is needed. The other action types require a parameter,
param.
string
specifies a string to be sent to Eterm for handling (escape codes, for example).
echo
specifies a string to be sent to the client program (for sending commands to a
shell, or keystrokes to an application like emacs or mutt). If you use either
of these action types,
param
will be parsed for escape codes (\a, C-, and the like) before being sent.
submenu
specifies a submenu which should be displayed when this item is
selected, and
param
is the title of the submenu to show. The submenu must have already been
defined. The
script
action type executes the Eterm-builtin script contained in
param.
See the section below for more details on the builtin Eterm functions
allowed for this action type.
- ACTION CONTEXT
-
Actions are key or mouse button bindings which activate certain
behaviors. Any action that can be triggered through an escape code
can be bound to a key or mouse button, with or without modifiers. You
can also bind menus to keystrokes or mouse buttons.
-
bind [ modifiers ] { keysym | button } to { string | echo | menu | script } param
-
Binds a
keysym or a mouse button
to an action. The action syntax follows the keyword
to
and is identical to the syntax used for menus (see above). There can be any
number of
modifiers
(so long as the combination is reasonable) but only one
keysym or button.
Valid
modifiers
are
ctrl, shift, lock,
mod1 through mod5,
alt, meta, and anymod (which allows any modifier).
If none are given, the keypress must not have modifier keys in use or the action
will not be triggered. Use
anymod
to allow any arbitrary modifier key to be used. The
keysym
can be given in text (case-sensitive) or as a hex number.
buttons
should be specified as
button1 through button5.
Also note that
alt and meta
will be equivalent to one or more of
mod1 through mod5,
as well as perhaps each other, based on your modifier settings. You
can view these settings using
xmodmap -pm.
See also the
alt_mod and meta_mod
options below.
- BUTTON_BAR CONTEXT
-
The buttonbar is an addition to Eterm 0.9.1 which allows users to have
a fully-customizeable buttonbar at the top or bottom of each terminal
window. Buttons on the buttonbar can be used just like menuitems;
they can popup menus (like a menubar), or they can activate any other
action a menuitem can.
-
font font
-
Specifies the font in which button labels will be displayed.
dock { top | bottom |
no }
-
Specify whether or not to dock the buttonbar, and if so, whether to
dock it at the top or the bottom of the Eterm window. Note that only
top and bottom
are currently enabled.
visible boolean
-
Toggle whether or not this particular buttonbar will be visible on
startup.
button [ text ] [ icon filename ] action { string | echo | menu | script } param
-
Binds an action to a button. The usage of
param
and the action types work the same here as they do for menuitems.
Also note that you may specify some
text
or an
icon
or both, but you cannot omit both.
- MULTICHAR CONTEXT
-
Behavior for multi-byte fonts and encodings are defined here. This
context does not exist by default.
-
encoding { eucj | sjis | euckr | big5 | gb | iso-10646 }
-
Specifies the encoding method. Patches to support other encoding methods are
encouraged.
-
font num font
-
Set the
numth
multichar font to
font.
- XIM CONTEXT
-
This context controls locale-based behavior.
-
input_method input_method
-
Specify your input method program of choice.
-
preedit_type { OverTheSpot | OffTheSpot |
Root }
-
Specify your preedit type of choice.
- ESCREEN CONTEXT
-
This context allows for customizations specific to Escreen mode. See
the Escreen section below for more details.
-
url protocol://user@host:port/params
-
Connect to (or create) a particular screen session via a URL-type
construct. Standard URL rules apply. The
protocol
should be either
screen
(the default) or
twin.
If
user, host, and/or port
are specified, an ssh connection is made to the remote server using
the given login information. The default is to create/attach to a
local session.
Any
params
that are given are passed directly to the underlying protocol and are
separated from each other by a plus sign
(+).
-
firewall localport:firewall:remoteport
-
Bounce the connection through a firewall via ssh.
-
delay secs
-
Specify the amount of time to wait before sending the screen/twin
initialization sequence. This is required to insure that the remote
session has been established prior to sending the init sequence.
-
bbar_font font
-
Font to use for the Escreen buttonbar. The default is
-*-helvetica-medium-r-normal--10-*-*-*-p-*-iso8859-1.
-
bbar_dock { top | bottom | no }
-
Dock the Escreen buttonbar as specified. Note that only
top and bottom
are currently enabled.
- TOGGLES CONTEXT
-
This context contains boolean variables which can be toggled on or off. Valid
values for the attributes in this section are "yes", "on", "1", and "true" to
turn the option on, or "no", "off", "0", or "false" to turn the option off.
These values are denoted by
boolean.
They all default to false unless otherwise noted.
-
map_alert boolean
-
If true, Eterm will un-iconify itself when it receives a beep (ASCII 0x07).
visual_bell boolean
-
If true, Eterm will flash rather than sending a beep.
login_shell boolean
-
If true, Eterm will prepend '-' to the shell name when calling it. Depending
on your shell, this may modify its startup behavior.
scrollbar boolean
-
This turns on and off the display of the scrollbar. Default is on.
utmp_logging boolean
-
If true, Eterm will attempt to make an entry in the utmp file to record the
login information. Eterm may need to run privileged to do this.
meta8 boolean
-
Toggles the interpretation of the Meta key setting the 8th bit in a
character.
iconic boolean
-
If true, Eterm will launch as an icon.
home_on_output boolean
-
Zoom to the bottom of the scrollback buffer on output.
home_on_input boolean
-
Zoom to the bottom of the scrollback buffer on input.
no_input boolean
-
If true, Eterm will not accept any keyboard input and will ask the
window manager to not allow it to be focused.
scrollbar_floating boolean
-
If true, the scrollbar will have no trough.
scrollbar_right boolean
-
If true, Eterm will put the scrollbar on the right of the window (default is left).
scrollbar_popup boolean
-
If true, Eterm will hide the scrollbar when the Eterm window loses focus and restore
it when focus is regained. Default is to not change the scrollbar state based on
focus.
borderless boolean
-
If true, Eterm will run with no window borders. This also means that the
window can not be moved or resized. You will want to specify a
geometry
with this attribute.
double_buffer boolean
-
Rather than drawing text directly onto the window, this causes Eterm
to allocate an additional pixmap the size of the terminal window into
which the background *and* the text are rendered. This pixmap is then
set as the window background. Double-buffering uses additional memory
in the X server, but it allows Eterm to ignore expose events so
redraws are faster.
no_cursor boolean
-
If true, Eterm will not display a text cursor.
pause boolean
-
After the child process terminates, Eterm will wait for a keypress
before exiting.
xterm_select boolean
-
Duplicate's xterm's treatment of cutchars. The only real difference is
what happens when you double click on a single cutchar between two
words. If this option is on, only that single character gets selected.
If it is off, that character is selected along with the two words. The
latter behavior is useful for double-clicking on the space between someone's
first and last names, or the @ sign in an e-mail address, etc.
select_line boolean
-
If true, this attribute causes a triple click to select the entire
line from beginning to end. If false (default), a triple-click
selects from the current word to the end of the line.
select_trailing_spaces boolean
-
If true, this attribute causes spaces at the end of a line to be included
as part of the selection text when selecting. The default is to strip
these trailing spaces.
report_as_keysyms boolean
-
Reports certain keystrokes as keysyms and modifiers rather than escape sequences.
NOTE:
This option is intended for use only with programs that support this special Eterm
mode. Do not enable it unless you are executing a program which uses this mode.
itrans boolean
immotile_trans boolean
-
Toggles the immotile transparency optimization for transparent Eterm
windows. Note that this does NOT activate transparency; you must
still activate "trans" mode for the background image. This option
should be used on transparent windows which are shaded or tinted and
which do not move around on the desktop much. See the
Mon Mar 6 21:11:13 PST 2000
ChangeLog entry for a more detailed explanation.
buttonbar boolean
-
Toggle the display of all buttonbars.
resize_gravity boolean
-
If true, Eterm will automatically detect the nearest corner, and
font-change resizes will cause the Eterm window to gravitate toward
that corner.
overstrike_bold boolean
-
If true (default), Eterm will simulate a bold font by printing each
character twice, offsetting the second pass by one pixel. This makes
the characters seem thicker without the need for a special font. You
may wish to disable this if you use a specific color for bold.
bold_brightens_foreground boolean
-
If true (default), Eterm will use the "bold" ANSI color attribute to
brighten the foreground color by using the high-intensity colors (8
through 15) rather than the low-intensity colors (0 through 7). Note
that having a specific color selected for bold will override this.
blink_brightens_background boolean
-
If true (default), Eterm will use the "blink" ANSI color attribute to
brighten the background color by using the high-intensity colors (8
through 15) rather than the low-intensity colors (0 through 7).
colors_suppress_bold boolean
-
If true (default), any colored text (that is, any text not rendered
using the default foreground color) will not be given any other
special treatment for bolding (e.g., bold font or bold overstrike).
sticky boolean
-
If true, Eterm will make its window sticky (shows on all desktops).
- KEYBOARD CONTEXT
-
This context contains keyboard-related configuration options.
-
smallfont_key keysym
-
Specify a keysym to decrease the font size. Default is Shift and the - key on
the keypad. Ctrl-< or Meta-< may also work (if you #define one of the hotkeys
in src/feature.h).
bigfont_key keysym
-
Specify a keysym to increase the font size. Default is Shift and the + key on
the keypad. Ctrl-> or Meta-> may also work (if you #define one of the hotkeys
in src/feature.h).
keysym keysym string
-
Define keysym
keysym
to send
string
instead of its default.
keysym
must be between 0xff00 and 0xffff or Eterm will complain.
meta_mod num
-
Specify which X modifier (1-5) to treat as the Meta key. See
xmodmap(1)
and the output of
xmodmap -pm
for more details.
alt_mod num
-
Same as
meta_mod,
but for the Alt key.
numlock_mod num
-
Same as
meta_mod,
but for the NumLock key.
greek boolean
{ iso | ibm }
-
Turn on/off greek keyboard support, and set which greek mode to use.
app_keypad boolean
-
Turn on/off application keypad mode on startup.
app_cursor boolean
-
Turn on/off application cursor key mode on startup.
- MISC CONTEXT
-
This context contains miscellaneous attributes that really didn't belong
anywhere else.
-
print_pipe command
-
Set the command to which to pipe print requests (printscreen) to
command.
save_lines num
-
Set the number of lines in the scrollback buffer to
num.
cut_chars string
-
Define the characters used as word delimiters to the characters contained in
string.
min_anchor_size num
-
Sets the minimum size, in pixels, of the scrollbar anchor (the part your mouse
grabs onto and moves around) to
num.
border_width num
-
Sets the width of the border between the text window and the X window to
num.
line_space num
-
Put
num
pixels' worth of space between each row of the terminal window.
finished_title title
-
Specifies that
title
should be displayed in the title bar of a paused Eterm when the child
process has completed.
finished_text text
-
Specifies that
text
should be displayed in the terminal window of a paused Eterm when the
child process has completed.
term_name name
-
Use
name
as the
$TERM
environment variable, which controls which termcap/terminfo entry gets used.
The default is
Eterm.
exec command
-
Rather than executing a shell, this will cause Eterm to spawn
command
as its child process. You can only have one of these!
- BUILT-IN FUNCTIONS
-
Eterm has a set of built-in functions which are available in config
files. Each one accepts zero or more parameters and outputs a series
of zero or more words. "Words" are defined in shell terms; i.e.,
words are separated by whitespace, and single or double quotes can be
used to encapsulate words which contain whitespace themselves. You
also employ backquotes to execute a command whose output can become
part of the config file itself or can be passed to a built-in function
as its parameter list. Built-in functions and backquotes may be used
anywhere their output would be valid. Built-in functions are prefixed
with the
%
character.
-
%appname()
-
Returns the application name, a hyphen, and the version number. Currently this
is the string
Eterm-0.9.6.
%exec(command)
-
Executes
command
and returns the result. Basically it's exactly like using backquotes.
%get(variable)
-
Retrieve the value of a config file variable. Refer to the
%put()
function below.
%put(variable value)
-
Create a config variable named
variable
and assign it the value of
value.
The value can then subsequently be retrieved using
%get(variable)
%random(params)
-
This function randomly chooses one of the words which compose
params
and returns that. The default themes that come with Eterm use this
function to choose random backgrounds, but backgrounds aren't the only
things that can be randomized with this function. You can randomize
anything...colors, toggles, fonts, tinting, etc.
%version()
-
Returns the version number. Currently this
is the string
0.9.6.
- PREPROCESSING
-
Eterm supports the
%include file
directive to allow for separation of the configuration information into
multiple files. Eterm will load and parse
file
just like any other config file, but will treat its contents as if
they replaced the directive itself.
You may also request that the config file be run through an external
preprocessor (such as m4 or cpp) before Eterm reads it. This is done
via the
%preproc command
directive. You may specify anything you like for
command
so long as it accepts input on STDIN and sends output to STDOUT. See
the
menus.cfg
file in the default
chooser
theme for an example.
- SCRIPT FUNCTIONS
-
One of the action types which can be bound to keypresses, mouse
buttons, menuitems, or buttonbar buttons is a
script.
The script must be a single word (i.e., containing no spaces or
enclosed in quotes) and consists of one or more calls to the script
functions below. Each call is separated from the next by a semicolon
(;).
Function parameters are enclosed in parentheses; the parentheses are
optional if no parameters are to be passed. Commas and/or whitespace
separate parameters from each other.
-
copy(buffer)
-
Copies the current selection to the specified clipboard or cut buffer.
buffer
is either a number
0-7,
in which case the selection is copied to the cut buffer specified, or
one of the words
clipboard, primary, or secondary
(or any initial substring thereof), in which case the selection is
copied to the specified clipboard. You may omit
buffer,
in which case the default buffer is
primary
(XA_PRIMARY in Xlib-speak).
echo(string)
-
Send the specified
string
to the subcommand. Exactly equivalent to the
echo
action.
es_display(cmd, params)
Aliases: es_disp
-
This is a master function which permits manipulation of Escreen
displays through the use of a series of subcommands. The specified
cmd
determines what, if any,
params
are permitted. Available subcommands are:
-
goto
- Switch to the specified display (0-9)
prev
- Switch to the previous display
next
- Switch to the next display
toggle
- Toggle display
new
- Create a new display. A name for the new display may be passed as a
parameter, or
ask
to prompt the user for the name.
rename
- Change the name of the current display. A name for the new display
may be passed as a parameter, or
ask
to prompt the user for the name.
kill
- Terminate the current (or specified) display.
watch
- Toggle monitoring of the current/specified display for activity.
scrollback
- View the scrollback for the current/specified display.
es_region(cmd, params)
Aliases: es_reg es_win es_window
-
This is a master function which permits manipulation of Escreen
display regions through the use of a series of subcommands. The
specified
cmd
determines what, if any,
params
are permitted. Available subcommands are:
-
goto
- Switch to the specified region (0-9)
prev
- Switch to the previous region
next
- Switch to the next region
toggle
- Toggle region
new
- Create a new region. A name for the new region may be passed as a
parameter, or
ask
to prompt the user for the name.
rename
- Change the name of the current region. A name for the new region
may be passed as a parameter, or
ask
to prompt the user for the name.
kill
- Terminate the current (or specified) region.
only
- Maximize the current/specified region to the full display.
watch
- Toggle monitoring of the current/specified region for activity.
scrollback
- View the scrollback for the current/specified region.
es_statement(statement)
-
Execute an Escreen (screen/twin) command directly.
es_reset()
Aliases: es_rst
-
Reset the Escreen session
exec_dialog(command)
-
The same as
exec/spawn,
but this function presents the user with a dialog box in which she can
edit/confirm the command to be run and specify additional parameters
if needed.
exit(message)
exit(code)
Aliases: die quit
-
Exit Eterm with an optional
message
or an integer return
code.
Either parameter may be specified, but not both. If neither is
specified, a
code
of
0
(zero) is the default.
kill(signal)
-
Sends the specified signal to Eterm's primary child process (either
your shell, or whatever you specify for Eterm to execute). For the
time being,
signal
must be numeric.
SIGTERM
is the default if
signal
is omitted.
msgbox(message)
-
Displays a small dialog box containing
message
and waits for a keypress before continuing.
nop()
-
Does absolutely nothing except waste time. :-)
paste(buffer)
-
Pastes the contents of the specified clipboard or cut buffer into the
terminal window.
buffer
is either a number
0-7,
in which case the selection is pasted from the cut buffer specified, or
one of the words
clipboard, primary, or secondary
(or any initial substring thereof), in which case the contents of the
specified clipboard are pasted. You may omit
buffer,
in which case the default buffer is
primary
(XA_PRIMARY in Xlib-speak).
save(type, filename)
-
Save the current theme/user configuration.
type
can be either
user or theme;
the default is
user.
filename
is the file to which the settings should be saved. It may contain a
path which is either absolute or relative to the theme directory. The
default filename for
user
is
user.cfg,
and the default filename for
theme
is
theme.cfg.
save_buff(filename)
-
Dumps the contents of the scrollback buffer to the specified file.
scroll(n)
-
Scrolls backward or forward in the scrollback buffer.
n
is a floating point number followed by an optional unit specifier.
The unit specifier is one of:
lines or l; pages or
p; or buffers or b.
The floating point number may be separated from the unit specifier by
whitespace or a comma, but it is not required. The floating point
number should be positive to scroll down (forward) and negative to
scroll up (backward). For example, the key sequence Shift-PgUp is
equivalent to
scroll(-1p).
You may also specify fractional quantities, such as
scroll(0.5p)
to scroll down half a page. The default unit if not specified is
lines.
search(str)
-
Presents a dialog box into which the user may enter a search term.
The default value is set to
str.
All occurrences of the specified search string are highlighted in the
scrollback buffer, and Eterm jumps back to the most recent one.
Searching again with the same keyword will clear the previous
highlighting.
spawn(command)
Aliases: exec
-
Spawns a secondary child process to execute
command,
or
Eterm
if no value is passed.
string(string)
-
The specified
string
is parsed via Eterm. This is exactly identical to the
string
action.
ESCREEN
Escreen is a screen/twin interface layer which allows Eterm to
interoperate with GNU
screen
and with Massimiliano Ghilardi's
twin
software. This allows Eterm to support multiple subshell sessions
within a single window. On the surface, this feature works similarly
to the "tabbed" sessions offered by programs like
konsole and multi-gnome-terminal.
However, Escreen has the advantage of being an interface to existing
software, thus providing additional capabilities like multiple regions
per display, detach/reattach capability, seamless remote session
support, firewall support, and more.
Escreen support is still somewhat experimental and is thus not
compiled into Eterm by default. To enable it, you must compile with
--enable-escreen and/or --enable-etwin
(depending on whether you have screen, twin, or both). If you
installed from a package, you can use
Eterm --version
and check for either
+ESCREEN (enabled) or -ESCREEN (disabled).
For best results, if you wish to use Escreen mode, do so by invoking
Eterm with the Escreen theme
(Eterm -t Escreen).
This theme supplies default key bindings, the basic Escreen menu,
color definitions, etc. for use by the Escreen engine. Most
importantly, it supplies the required
url
parameter in order to invoke Escreen mode.
Consult the README.Escreen file for more in-depth discussion of
Escreen mode.
AUTHORS
Michael Jennings (mej@eterm.org)
URL(s)
Eterm Home Page -- http://www.eterm.org/
Author's Home Page -- http://www.kainx.org/
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- THEMES
-
- CONFIGURATION
-
- ESCREEN
-
- AUTHORS
-
- URL(s)
-
This document was created by
man2html,
using the manual pages.
Time: 23:31:31 GMT, April 27, 2024