Eterm man page on IRIX

Man page or keyword search:  
man Server   31559 pages
apropos Keyword Search (all sections)
Output format
IRIX logo
[printable version]



     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)

[top]

List of man pages available for IRIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net