Eterm
SYNOPSIS
Eterm [options]
DESCRIPTION
Eterm -- version 0.9.1 -- 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
...
--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 rea-
sonable.
-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
--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 mini-
mum and maximum character widths. This option chooses a charac-
ter 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 charac-
ters 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 cor-
ner/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 follow-
ing keywords: top_left or tl, top_right or tr, bottom_left or
bl, and bottom_right or br. Each corner specifier is then fol-
lowed by a color.
There are also several shortcuts for doing common effects. You
can get a single-color outline by using the keyword outline fol-
lowed by a color. A single-color drop shadow is also available
using the keyword shadow followed by an optional corner speci-
fier (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
ous 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 Window-
Maker 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-trans-
parency, 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 sub-
marine does. The effect is especially keen if you open several
Eterms in this mode with the same image.
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 val-
ues 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 val-
ues 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 back-
ground. 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 syn-
tax as the -P option above, including the optional geometry
string.
-M font, --mfont font
Sets the normal multibyte text font to font.
--mfont1 font
-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.
-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
--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.
--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).
trols 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 seperators 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 com-
mand 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 fore-
ground 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.
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
~/.Eterm/themes/<theme_name>/ or
/usr/X11R6/share/Eterm/themes/<theme_name>.
Eterm now supports the existence of a user configuration file as a sup-
pliment 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 explic-
itly 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 run-
ning 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 set-
tings 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/X11R6/share/Eterm/themes/Eterm/theme.cfg). The next section con-
tains details on the format and usage of the configuration file.
CONFIGURATION
Since Eterm 0.9.1 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 documenta-
tion 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 com-
ments 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
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 con-
fig 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 immedi-
ately 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 speci-
fied by color.
ATTRIBUTES CONTEXT
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-com-
pliant 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 stan-
dard 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 cor-
ner 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
Finally, for no font effects at all, simply specify the key-
word none.
The default value is bottom_right black which yields a black
drop shadow, greatly improving the visibility of lightly-col-
ored 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. file-
name 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 syn-
tax 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 back-
ground pixmap. The interval
defines the delay, in seconds, between updates of the back-
ground. 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 geome-
try 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,
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 speci-
fied. 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 image-
class. The foreground color is used for text, and the back-
ground 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 file-
name. 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 encoun-
tered 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 horizon-
tal/vertical scaling percentages, x and y are the horizon-
tal/vertical alignment percentages, and ops is a colon-delim-
ited list of operations: tiled (to tile the image), prop-
scaled (for proportional scaling). Note that these opera-
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 scroll-
bar 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 sub-
menu-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 sep-
arators).
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 con-
tain spaces, but don't forget to enclose it in single or dou-
ble 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.
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 corre-
spond 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 mod-
ifiers. 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 modi-
fiers (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 but-
ton5. 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
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 win-
dow. Note that only top and bottom are currently enabled.
visible boolean
Toggle whether or not this particular buttonbar will be visi-
ble 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
font bold font
Set the numth multichar font, or the bold 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.
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",
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 priv-
ileged 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
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 from
the current word to the end of the line. If off, a triple
click selects the entire line from beginning to end.
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 transpar-
ent Eterm windows. Note that this does NOT activate trans-
parency; you must still activate "trans" mode for the back-
ground image. This option should be used on transparent win-
dows 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 gravi-
tate toward that corner.
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
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 charac-
ters 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 termi-
nal 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 win-
dow of a paused Eterm when the child process has completed.
term_name name
puts 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 num-
ber. Currently this is the string Eterm-0.9.1.
%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.1.
PREPROCESSING
Eterm supports the %include file directive to allow for separa-
tion 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 spec-
ify anything you like for command so long as it accepts input on
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).
exit(message)
exit(code)
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 exe-
cute). For the time being, signal must be numeric. SIGTERM
is the default if signal is omitted.
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 copied to the cut buffer speci-
fied, or one of the words clipboard, primary, or secondary
(or any initial substring thereof), in which case the con-
tents of the specified clipboard are pasted. You may omit
buffer, in which case the default buffer is primary (XA_PRI-
MARY 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 direc-
tory. The default filename for user is user.cfg, and the
default filename for theme is theme.cfg.
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 (back-
ward). For example, the key sequence Shift-PgUp is equiva-
die or quit are precisely equivalent to exit, and exec may be used
in place of spawn.
AUTHORS
Michael Jennings (mej@eterm.org)
URL(s)
Eterm Home Page -- http://www.eterm.org/
Author's Home Page -- http://www.kainx.org/
X Version 11 29 December 2002 ETERM(1)
Man(1) output converted with
man2html