ETERM(1) August (17) ETERM(1)
NAME
Eterm - an Enlightened terminal emulator for the X Window
System
SYNOPSIS
Eterm [options]
DESCRIPTION
Eterm - version 0.8.10 - is a color vt102 terminal emulator
intended as an xterm(1) replacement for users who want a
term program integrated with Enlightenment, or simply want a
little more "eye candy". 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 config file name. Otherwise Eterm
uses the default, which is MAIN.
-h, --help
Print out a message describing available options.
--version
Print Eterm version and compile-time configuration.
--debug level
Show debugging output. level is an integer between 0
and 5 which determines how verbose the debugging output
is.
-r, --reverse-video
Reverse video, swaps the foreground and background
Page 1 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
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.
--menu-text-color color
Use color as the menu text color (only makes sense if
menu is enabled).
-S color, --scrollbar-color color
Use color as the scrollbar color (only makes sense if
scrollbar is enabled).
--unfocused-scrollbar-color color
Use color as the scrollbar color when window does not
have focus (only makes sense if scrollbar is enabled).
--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.
-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.
-g geom, --geometry geom
Page 2 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
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.
--bold-font font
Sets the bold text font to font.
-F font, --font font
Sets the normal text font to font.
--font1 font
...
--font4 font
Sets font X to font.
-P pic, --background-pixmap pic
Use pic as the background image. pic can be in any
format that Imlib understands. Currently this means
Page 3 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
just about anything, including JPG, PNG, GIF, TIFF,
PPM, etc. The image is tiled by default. To scale the
image, use the --scale option below.
-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. NOTE:
This is not currently implemented.
--down-arrow-pixmap pic
As above, except the scrollbar's down-arrow is set.
NOTE: This is not currently implemented.
--trough-pixmap pic
As above, except the scrollbar's background (trough) is
set. NOTE: This is not currently implemented.
--anchor-pixmap pic
As above, except the scrollbar's anchor image is set.
NOTE: This is not currently implemented.
-@, --scale
Scale the image rather than tile. Only makes sense if
the background pixmap option is used (see above).
-W, --watch-desktop
In a pseudo-transparent Eterm, this will watch the
desktop for changes to the image, Eterm moving to a
different desktop, etc. Use with the transparency
options below.
-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, you will need to use the Esetroot
program in the doc/ directory to set your root
background image.
--shade percentage
Darkens the background pixmap (either an image file or
the transparent portion can be shaded). The amount of
shading is controlled by the specified percentage,
which may or may not be followed by a percent sign.
--tint mask
Tints the background pixmap (either an image file or
the transparent portion can be shaded). The mask is an
Page 4 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
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. Some common tints are:
none 0xffffff
red 0xff8080
green 0x80ff80
blue 0x8080ff
cyan 0x80ffff
magenta 0xff80ff
yellow 0xffff80
-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.
-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 have the same syntax as the background
attribute in a configuration file (two integers
followed by the image filename), except that the two
integers are optional. If they are specified, remember
to group them with the filename using quotes. The
following are both valid:
Eterm-N '10 image1.jpg image2.jpg'
Eterm-N '10 "0 0 image1.jpg" "-1 -1 image2.jpg"'
-l, --login-shell
Makes the new shell a login shell.
-s, --scrollbar
Enables the scrollbar. (Default)
--menubar
Enables the menubar. (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
Page 5 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
or blink rather than beep.
-H, --home-on-echo
Jump to bottom on output.
--home-on-input
Jump to bottom on input.
-E, --home-on-refresh
Jump to bottom on refresh (^L)
--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. This also
means that the window can not be moved (unless the -V
or --menubar-move option is specified) or resized.
Recommend using --geometry as well with this option.
-m, --map-alert
Un-iconify on beep.
-8, --meta8
Causes the Meta key to set the 8th bit in the char.
--save-under
If supported by the X server, tries to use backing
store for faster refreshes.
--no-cursor
Disables the text cursor.
-V, --menubar-move
This options causes Eterm to enable the moving of the
Eterm window by dragging the right-hand side of the
menubar. This is useful for borderless Eterms (and is,
in fact, on by default if the -x or --borderless option
is specified).
--pause
After the child process terminates, Eterm will wait for
a keypress before exiting.
--xterm-select
Page 6 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
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.
--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.
--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).
--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
Page 7 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
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 seperators for double-click selection.
-M file, --menu file
Replace default menubar file with file. To disable the
menubar altogether, do not specify a bogus value for
file. Instead, use the boolean option --menubar off
--term-name TERM
Use TERM for the value $TERM.
-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.
SPECIAL LANGUAGE FEATURES
The following are *NOT* compiled in by default.
Kanji (Japanese character) options
-K font, --kanji-font font
Use font as the default kanji font.
--kanji-font1 font
...
--kanji-font4 font
Use font as kanji font X.
--kanji-encoding
Page 8 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
Use Kanji encoding mode (eucj or sjis).
Greek options
--greek-keyboard
Use Greek keyboard mapping (iso or ibm).
THEMES
Eterm is built on the philosophy of Freedom of Choice. Each
user should be able to choose the environment in which he
wishes to exist, and the tools he uses 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 "MAIN", 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, in the environment variable defined by
PATHENV in src/feature.h, or in the default PATH. The theme
may also contain additional configuration files referenced
by the primary MAIN file, 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/freeware/share/Eterm/themes/<theme_name>.
All command line options can be enabled/disabled in the
theme's configuration file (the default is
/usr/freeware/share/Eterm/themes/Eterm/MAIN). The next
section contains details on the format and usage of the
configuration file.
CONFIGURATION
Since Eterm 0.8.10 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.
Page 9 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
From here on out, I will assume you've read the above text
and know how to change the default value for the theme and
the config file name. Just realize that when I subsequently
refer to MAIN, if you are using a different name, substitute
the name you supplied in place of MAIN. I may also refer to
the Eterm theme. If you are using a different theme,
substitute your theme's name in place of Eterm. It is
highly recommended that you have a copy of the Eterm theme
MAIN file that comes with Eterm handy while you read this
documentation.
Okay, first the general idea. The MAIN 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 eight valid
contexts: color, attributes, pixmaps, toggles, keyboard,
misc, kanji, and main. 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.
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.
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.8 should have "<Eterm-0.8>" as their first
line, followed immediately by a newline.
MAIN CONTEXT
Page 10 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
There are very few things that are valid within the
"main" context. In fact, the only non-comment lines
allowed in the main context are begin's and end's for
other contexts. According to the internal mechanism of
Eterm, each context can have any number of subcontexts,
but as it is currently implemented, only main has any.
Valid subcontexts for main are color, attributes,
pixmaps, toggles, keyboard, misc, and kanji. They can
appear in any order. The order I list them here is
simply the order in which they appear in the default
themes, which was arbitrarily chosen for continuity.
COLOR CONTEXT
This context contains color specifications. With the
exception of tint and 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.
tint mask
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. Some common tints are:
none 0xffffff
red 0xff8080
green 0x80ff80
blue 0x8080ff
cyan 0x80ffff
magenta 0xff80ff
yellow 0xffff80
shade percentage
Darkens the background pixmap (either an image
file or the transparent portion can be shaded).
The amount of shading is controlled by the
specified percentage, which may or may not be
followed by a percent sign.
cursor color
Page 11 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
Use color for the cursor color.
cursor_text color
Use color for the cursor text color.
menu_text color
Use color for the menu text color.
scrollbar color
Use color for the scrollbar color.
unfocusedscrollbar color
Use color for the scrollbar color if Eterm is
unfocused.
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
Page 12 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
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 (0-4), or the bold font, to
font.
PIXMAPS CONTEXT
This context contains attributes related to pixmaps.
background x_scale y_scale filename
Use filename as the background 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. The x_scale and y_scale values should be
either both 0 (tile) or both -1 (scale).
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.
icon filename
Use filename as the icon image for the Eterm
window. filename can be an absolute path,
Page 13 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
relative to the current theme, or relative to one
of the directories in the path attribute listed
above.
anim interval
Specifies an animation list to be use in cycling
the background pixmap. 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 remaining words
have the same syntax as the background attribute
in a configuration file (two integers followed by
the image filename), except that the two integers
are optional. If they are specified, remember to
group them with the filename using quotes. The
following are both valid:
anim 10 image1.jpg image2.jpg
anim 10 "0 0 image1.jpg" "-1 -1 image2.jpg"
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.
menubar boolean
This turns on and off the display of the menubar.
Default is on.
utmp_logging boolean
Page 14 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
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_echo 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.
home_on_refresh boolean
Zoom to the bottom of the scrollback buffer on
refresh (Ctrl-L).
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.
save_under boolean
If true, Eterm will use a backing store.
trans boolean
Toggles Eterm's pseudo-transparency feature. Yes,
it's fake. Yes, it will always be fake. Don't
ask.
watch_desktop boolean
This option is required if you want Eterm to watch
Page 15 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
for updates to the desktop background image,
including moving across desktops. There is a
speed sacrifice that must be made for this
feature, although I've tried to make it as small
as possible.
no_cursor boolean
If true, Eterm will not display a text cursor.
menubar_move boolean
This options causes Eterm to enable the moving of
the Eterm window by dragging the right-hand side
of the menubar. This is useful for borderless
Eterms (and is, in fact, on by default if the
borderless attribute is true).
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 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.
viewport_mode boolean
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
Page 16 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
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.
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.
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
Page 17 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
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.
menu file
Loads menubar code from file. The way to turn the
menubar off is to not have this line in the config
file, but passing some bogus filename (or
/dev/null) as file will work too, though it may
produce an error message.
term_name name
Use name as the $TERM environment variable, which
controls which termcap/terminfo entry gets used.
The default is xterm.
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!
KANJI CONTEXT
This context contains attributes which are only used
when Eterm is compiled with Kanji support. This
context is not valid in a normal Eterm.
font num font
Set the numth kanji font (0-4) to font.
encoding { eucj | sjis }
Set the kanji encoding method.
BUILT-IN FUNCTIONS
Eterm has a set of built-in functions which are
available in config files. They can be used anywhere
their output would be valid. Built-in functions are
Page 18 (printed 3/1/100)
ETERM(1) August (17) ETERM(1)
prefixed with the % character.
%random(params)
This function randomly chooses one of the words
which compose params and returns that. "Words"
are defined in shell terms, meaning that single or
double quotes can be used to separate individual
words of params which contain spaces. And you can
even get creative and use a backquote-executed
command to generate the list of words to pass to
%random(). The default themes that come with
Eterm demonstrate this technique, in fact. But
keep in mind that random pixmaps aren't the only
thing you can do with this function. You can
randomize anything...colors, toggles, fonts,
tinting...you name it!
%exec(command)
Executes command and returns the result.
Basically it's exactly like using backquotes,
except that it hasn't been implemented yet, so use
backquotes instead. :-}
%appname()
Returns the application name, a hyphen, and the
version number. Currently this is the string
Eterm-0.8.10.
%version()
Returns the version number. Currently this is the
string 0.8.10.
INCLUDES
Eterm supports the %include file directive to allow for
separation of the configuration information into
separate files.
AUTHORS
Michael Jennings (mej@eterm.org) and Tuomo Vendldinen
(vendu@cc.hut.fi). Man page re-written for version 0.8 by
Shaleh (shaleh@debian.org).
URL(s)Eterm Home Page -- http://www.eterm.org/
Eterm FAQ -- http://www.eterm.org/FAQ.html
Page 19 (printed 3/1/100)