Eterm

ETERM(1)                             1998                             ETERM(1)



NAME
       Eterm — an Enlightened terminal emulator for the X Window System

SYNOPSIS
       Eterm [options]


DESCRIPTION
       Eterm — version 0.8.7 — 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.

       -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.

       -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.

       --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
              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.

       --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 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.

       -U pic, --up-arrow-pixmap pic
              As above, except the scrollbar's up-arrow is set.  NOTE: This is
              not currently implemented.

       -D pic, --down-arrow-pixmap pic
              As above, except the scrollbar's down-arrow is set.  NOTE: This
              is not currently implemented.

       -B pic, --trough-pixmap pic
              As above, except the scrollbar's background (trough) is set.
              NOTE: This is not currently implemented.

       -A pic, --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).

       --watch-pixmap
              Do not use this option.  You have been warned.  Don't ask what
              it does, just don't use it.

       -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
              When used with the -O or --trans options, --shade will darken
              the portion of the root window image contained within the Eterm
              window, giving a sort of "smoked glass" effect.

       -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.

       -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-echo
              Jump to bottom on output.

       -H, --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.

       -x, --borderless
              This option forces Eterm to have no borders.  This also means
              that the window can not be moved or resized.  Recommend using
              --geometry as well with this option.  Also, if your window
              manager supports borderless windows itself, use that
              functionality rather than Eterm's.

       -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.

       --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).

       -L num, --save-lines num
              Set the number of lines in the scrollback buffer to num.

       -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.

       --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
              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/X11R6/lib/Eterm/themes/<theme_name>.

       All command line options can be enabled/disabled in the theme file (the
       default is /usr/X11R6/lib/Eterm/themes/Eterm/MAIN).  This file is split
       into sections: color, attributes, pixmaps, toggles, keyboard, and misc.


AUTHORS
       Tuomo Venalainen (vendu@cc.hut.fi) and Michael Jennings
       (mej@tcserv.com).  Man page re-written for version 0.8 by Shaleh
       (shaleh@debian.org).


URL(s)
       Main Web Site -- <http://www.tcserv.com/Eterm/> The Eterm FAQ --
       <http://www.tcserv.com/Eterm/FAQ.html> Project Resurrection --
       <http://ganja.tky.hut.fi/Resurrection/>






October                               22                              ETERM(1)