scoterm (X) X Version 11 (Release 4) scoterm (X)
NAME
scoterm - terminal emulator for X
SYNTAX
scoterm [-toolkitoption ...] [-option ...]
DESCRIPTION
scoterm is an X client program that emulates the SCO
ANSI console. It runs under the SCO Xsight window-
ing system and under SCO's Open Desktop graphical
operating environment. scoterm produces a window 80
columns wide by 25 lines in length.
Any application that runs on the SCO ANSI console
can run under scoterm with no difference in perfor-
mance or capabilities, except one: scoterm is
strictly a character-based terminal emulator and
does not support graphics mode.
scoterm's default settings are stored in the file
/usr/lib/X11/app-defaults/Scoterm. Individual users
can change the defaults by inserting the appropriate
scoterm parameters in their personal resource confi-
guration file. In most cases, this would be the
.Xdefaults file in the users' home directories.
When you start scoterm, it automatically sets the
TERM type inside its window to ansi. If you use
scoterm's -ls option to run a login shell in the
scoterm window, you should enter ansi at the TERM
type prompt.
scoterm offers many enhancements that are not avail-
able in the standard X windows terminal emulator,
xterm. The following subsections summarize these
improvements.
SCO ANSI DISPLAY CONTROL STRING COMPATIBILITY
scoterm supports all ANSI display control sequences.
Any application that you subsequently run will have
the full range of ANSI console features at its
disposal: support for 16 colors, inverse video,
line drawing, boldface, and underlining. scoterm
does not support blinking characters, however.
FONT SUPPORT
scoterm comes with four IBM(r) code page 437 fonts
for the SCO X server. They range in size from 6x13
to 10x20 pixels per character. All these fonts pro-
vide the same character set that is supported by the
SCO ANSI console, including 8-bit character support
for line-drawing characters, for international char-
acters, and for Greek characters. You may change
the scoterm screen font in the middle of a session
by choosing another font from a pop-up menu.
You can also use non-SCO fonts under scoterm, such
as the ISO 8859 fonts that come with the Xsight Run-
time System. The character sets in these fonts,
however, do not match the SCO ANSI console, and
results can be unpredictable.
MOUSE SUPPORT
scoterm supports the SCO Event Manager API, which
supports both mouse and keyboard events. Like
xterm, scoterm uses mouse commands to call its pop-
up menus and to cut and paste text in the scoterm
window. Unlike xterm, scoterm also allows you to
use the mouse with character-based applications that
support the mouse.
By default, scoterm is configured to work with new
applications that rely on X to track the mouse.
This mode also allows the application to change the
pointer to any of the cursor shapes included with X.
scoterm also handles mouse movements and button
events for older applications that do their own
mouse tracking and were not designed with X in mind.
CONSOLE KEYBOARD COMPATIBILITY
scoterm supports all the keyboard configuration
utilities provided by the SCO ANSI console, including
setkey(C), mapchan(M), mapkey(M) and mapstr(M).
RESIZE SUPPORT
scoterm windows, like xterm windows, can be resized
and iconified in the icon box. Applications running
inside scoterm can automatically resize themselves
to match the new window size, if they were designed
to do so. Most current character-based applications
were not designed that way. Refer to the resize(X)
manual page for more information on resizing scoterm
windows.
EIGHT BIT CHARACTER SUPPORT
scoterm supports 8-bit characters. The IBM fonts
provided with scoterm include 8-bit characters.
Eight-bit characters are also included in the Char-
Class for scoterm's cut-and-paste options, and may
be remapped using the CharClass resource.
The resource eightBitInput allows you to set the
eighth bit of any character you type. When eightBit-
Input is set to ``true,'' you simply hold down the
<Alt> key while typing the character in question.
If you do this when eightBitInput is ``false'' (its
default value), scoterm instead reads the mapkey
tables to find out which character to send.
OPTIONS
The scoterm terminal emulator accepts all of the
standard X Toolkit command line options as well as
the following (if the option begins with a plus (+)
instead of a minus (-), the option is restored to
its default value):
-help This option causes scoterm to print out a
verbose message describing its options.
-ah This option indicates that scoterm should
always highlight the text cursor and bord-
ers. By default, scoterm displays a hollow
text cursor whenever the focus is lost or
the pointer leaves the window.
+ah This option indicates that scoterm should do
text cursor highlighting.
-b number
This option specifies the size of the inner
border (the distance between the outer edge
of the characters and the window border) in
pixels. The default is 2.
-blink This option causes the scoterm cursor to
blink.
+blink This option tells scoterm to display a
steady, non-blinking cursor. By default,
scoterm displays a non-blinking cursor.
-cb This option changes the effect of triple-
clicking the mouse on a line of text. Nor-
mally, triple-clicking highlights the entire
line. When this option is used, however,
triple-clicking highlights only the word
that the pointer is on and the portion of
the line to the right of that word.
+cb This option specifies that triple-clicking
the mouse on a line should highlight the
entire line. This mode is the default.
-cc characterclassrange:value[,...]
This option reassigns specific characters to
different character classes. This option is
important when you select text with the
mouse in one-word increments. For details,
see ``CHARACTER CLASSES'' later in these
pages.
-cmap This option tells scoterm to use its own
ANSI color map, if necessary.
+cmap This option tells scoterm to use the X
server's default color map. scoterm uses
the server's color map by default.
-cn This option indicates that newlines should
not be cut in line-mode selections.
+cn This option indicates that newlines should
be cut in line-mode selections.
-e program [arguments ...]
This option specifies the program (and its
command line arguments) to be run in the
scoterm window. It also sets the window
title and icon name to be the base name of
the program being executed if neither -T (or
-title) nor -n are given on the command
line. This must be the last option on the
command line.
-fb font
This option specifies a font to be used when
displaying bold text. This font must be the
same height and width as the normal font.
If only one of the normal or bold fonts is
specified, it is used as the normal font and
the bold font is produced by overstriking
this font. The default is to do overstrik-
ing of the normal font.
-j This option indicates that scoterm should do
jump scrolling. Normally, text is scrolled
one line at a time; this option allows
scoterm to move multiple lines at a time so
that it does not fall as far behind. Its
use is strongly recommended because it make
scoterm much faster when scanning through
large amounts of text. You can turn this
feature on or off through scoterm's
ansiMenu.
+j This option indicates that scoterm should
not do jump scrolling.
-l This option indicates that scoterm should
send all terminal output to a log file as
well as to the screen. This option can be
enabled or disabled from scoterm's mainMenu.
+l This option indicates that scoterm should
not do logging.
-lf filename
This option specifies the name of the file
to which the output log described above is
written. (This option only works if the
option -l was also specified, or if the Log
to File option was enabled on scoterm's
mainMenu.) If filename begins with a pipe
symbol (|), the rest of the string is
assumed to be a command to be used as the
endpoint of a pipe. The default filename is
ScotrmLogXXXXX'' (where XXXXX is the process
id of scoterm) and is created in the direc-
tory from which scoterm was started (or the
user's home directory in the case of a login
window).
-ls This option indicates that the shell that is
started in the scoterm window be a login
shell (that is, the first character of
argv[0] is a dash, indicating to the shell
that it should read the user's .login or
.profile files).
+ls This option indicates that the shell that is
started should not be a login shell (that
is, it is a normal subshell).
-mb This option indicates that scoterm should
ring a margin bell when the user types near
the right end of a line. This option can be
turned on and off from the ansiMenu.
+mb This option indicates that margin bell
should not be rung.
-mc milliseconds
This option specifies the maximum time
between multi-click selections. The default
is 250 milliseconds.
-mono This option tells scoterm not to use color
in its displays.
+mono This option tells scoterm to use color in
its windows. Scoterm uses color by default.
-nb number
This option specifies the number of charac-
ters from the right end of a line at which
the margin bell, if enabled, rings. The
default is 10.
-rw This option indicates that reverse-
wraparound should be allowed. This allows
the cursor to back up from the leftmost
column of one line to the rightmost column
of the previous line. This is very useful
for editing long shell command lines and is
encouraged. This option can be turned on
and off from the ansiMenu.
+rw This option indicates that reverse-
wraparound should not be allowed.
-s This option indicates that scoterm may
scroll asynchronously, meaning that the
screen does not have to be kept completely
up to date while scrolling. This allows
scoterm to run faster when network latencies
are very high and is typically useful when
running across a very large internet or many
gateways.
+s This option indicates that scoterm should
scroll synchronously.
-sb This option indicates that some number of
lines that are scrolled off the top of the
window should be saved and that a scrollbar
should be displayed so that those lines can
be viewed. This option may be turned on and
off from the ansiMenu.
+sb This option indicates that a scrollbar
should not be displayed.
-si This option indicates that output to a win-
dow should not automatically reposition the
screen to the bottom of the scrolling
region. This option can be turned on and off
from the ansiMenu.
+si This option indicates that output to a win-
dow should cause it to scroll to the bottom.
-sk This option indicates that pressing a key
while using the scrollbar to review previous
lines of text should cause the window to be
repositioned automatically in the normal
position at the bottom of the scroll region.
+sk This option indicates that pressing a key
while using the scrollbar should not cause
the window to be repositioned.
-sl number
This option specifies the number of lines to
save that have been scrolled off the top of
the screen. The default is 64.
-tm string
This option specifies a series of terminal
setting keywords followed by the characters
that should be bound to those functions,
similar to the stty program. Allowable key-
words include: intr, quit, erase, kill, eof,
eol, swtch, start, stop, brk, susp, dsusp,
rprnt, flush, weras, and lnext. Control
characters may be specified as ^char (for
example, ^c or ^u) and ^? may be used to
indicate delete.
-tn name
This option specifies the name of the termi-
nal type to be set in the TERM environment
variable. This terminal type must exist in
the termcap(F) database and should have li#
and co# entries. The default is ``ansi.''
-ut This option indicates that scoterm should
not write a record into the the system log
file /etc/utmp.
+ut This option indicates that scoterm should
write a record into the system log file
/etc/utmp.
-vb This option indicates that a visual bell is
preferred over an audible one. Instead of
ringing the terminal bell whenever a <Ctrl>G
is received, the window flashes.
+vb This option indicates that a visual bell
should not be used.
-wf This option indicates that scoterm should
wait for the window to be mapped the first
time before starting the subprocess so that
the initial terminal size settings and
environment variables are correct. It is
the application's responsibility to catch
subsequent terminal size changes.
+wf This option indicates that scoterm should
not wait before starting the subprocess.
-C This option indicates that this window
should receive console output.
-Sccn This option specifies the last two letters
of the name of a pseudoterminal to use in
slave mode, plus the number of the inherited
file descriptor. The option is parsed
%c%c%d. This allows scoterm to be used as
an input and output channel for an existing
program and is sometimes used in specialized
applications.
The following command line arguments are provided
for compatibility with older versions. They may not
be supported in the next release as the X Toolkit
provides standard options that accomplish the same
task.
-T string
This option specifies the title for
scoterm's windows. It is equivalent to
-title.
-n string
This option specifies the icon name for
scoterm's windows. It is shorthand for
specifying the "*iconName" resource. Note
that this is not the same as the toolkit
option -name (see below). The default icon
name is the application name.
-r This option indicates that the foreground
and background colors in the window should
be reversed. It is equivalent to -rever-
sevideo or -rv.
-w number
This option specifies the width in pixels of
the border surrounding the window. It is
equivalent to -borderwidth or -bw.
The following standard X Toolkit command line argu-
ments are commonly used with scoterm:
-bg color
This option specifies the color to use for
the background of the window. The default is
``black.''
-bd color
This option specifies the color to use for
the border of the window. The default is
``black.'' This border may not be visible
under some window management programs, not-
ably Motif. Those window managers generate
a window frame that overlays the border.
-bw number
This option specifies the width in pixels of
the border surrounding the window.
-fg color
This option specifies the color to use for
displaying text. The default is ``white.''
-fn font
This option specifies the font to be used
for displaying normal text. The default is
``ibm6x13.''
-name name
This option specifies the application name
under which resources are to be obtained,
rather than the default executable filename.
Name should not contain ``.'' or ``*'' char-
acters.
-title string
This option specifies the window title
string, which may be displayed by window
managers if the user so chooses. The
default title is the command line specified
after the -e option, if any, otherwise the
application name.
-rv This option swaps the window's foreground
and background colors to create reverse
video.
+rv This option restores the default foreground
and background colors.
-geometry geometry
This option specifies the preferred size and
position of the window; see X(X) for syntax.
The default size is 80 columns by 25 rows.
-display display
This option specifies the X server to con-
tact; see X(X).
-xrm resourcestring
This option specifies a resource string to
be used. This is especially useful for set-
ting resources that do not have separate
command line options. For example, the com-
mand line option -xrm
"Scoterm.Ansi.geometry:70x20" creates a win-
dow of 70 columns and 20 rows.
-iconic
This option indicates that scoterm should
ask the window manager to start it as an
icon rather than as the normal window.
#geom
This option specifies the position of the
icon window. It is equivalent to the
*iconGeometry resource. For example, #+0+0
puts the icon in the upper left-hand corner
of the screen.
RESOURCES
scoterm understands all of the core X Toolkit
resource names and classes as well as:
iconGeometry (class IconGeometry)
Specifies the preferred size and position of
the application when iconified. The default
behavior is specified by the window manager.
This resource is not necessarily obeyed by
all window managers.
monochrome (class Monochrome)
This resource can be set to ``true'' or
``false.'' If true, the scoterm window emu-
lates a monochrome monitor. If false, the
window allows color. The default is
``false.'' See the description of the
resource useDefaultColormapOnly.
termName (class TermName)
Specifies the terminal type name to be set
in the TERM environment variable. The
default is ``ansi.''
title (class Title)
Specifies a string that may be used by the
window manager when displaying this applica-
tion. The default is the name of the
scoterm executable file, which should be
``scoterm.''
ttyModes (class TtyModes)
Specifies a string containing terminal set-
ting keywords and the characters to which
they may be bound. Allowable keywords
include: intr, quit, erase, kill, eof, eol,
swtch, start, stop, brk, susp, dsusp, rprnt,
flush, weras, and lnext. Control characters
may be specified as ^char (for example, ^c
or ^u) and ^? may be used to indicate
delete. This is very useful for overriding
the default terminal settings without having
to do an stty every time a scoterm is
started. Here is an sample:
Scoterm*ttymodes: erase ^H.
useDefaultColormapOnly (class UseDefaultColormapOnly)
When this resource has a value of ``true'',
scoterm draws on the X default color map for
colors that are the closest to the standard
DOS colors. (If it cannot find a
corresponding color in the default map,
scoterm uses white.) If this resource is
``false,'' scoterm uses the DOS colors. The
useDefaultColormapOnly resource is active
only when the monochrome resource is set to
``false.''
utmpInhibit (class UtmpInhibit)
Specifies whether or not scoterm should try
to record the user's terminal in /etc/utmp.
The default is ``false,'' and is set in
/usr/lib/X11/app-defaults/Scoterm.
The following resources are specified as part of the
ansi widget (class Ansi):
allowSendEvents (class AllowSendEvents)
Specifies whether or not synthetic key and
button events (generated using the X proto-
col SendEvent request) should be interpreted
or discarded. The default is ``false''
meaning that they are discarded. Note that
allowing such events creates a very large
security hole.
alwaysHighlight (class AlwaysHighlight)
Specifies whether or not scoterm should
always display a highlighted text cursor.
The default is ``false,'' which means that a
hollow text cursor is displayed when the
pointer moves out of the window or the win-
dow loses the input focus.
altPrefix (class AltPrefix)
Specifies that, when the user presses <Alt>
while typing a character, a specified char-
acter should be sent as a prefix to the
typed character. The value of altPrefix
should be the ASCII decimal value of the
character that you want to use as a prefix.
This resource is active only when the eight-
BitInput resource is set to ``false.'' The
default value of this resource is null.
blink (class Blink)
Specifies whether or not the cursor should
blink in the scoterm window. If this
resource's value is ``true,'' the cursor
blinks. If the value is ``false,'' the cur-
sor does not blink. The default value is
``false.''
blue (class AnsiColors)
This resource specifies a different color
name or value that scoterm should use
instead of the standard ANSI ``blue.'' The
color can be any color that your server sup-
ports.
boldFont (class Font)
Specifies the name of the default bold font
to use instead of overstriking.
boldFont1 (class Font1)
Specifies the name of the bold font to be
used for the first alternate font instead of
overstriking.
boldFont2 (class Font2)
Specifies the name of the bold font to be
used for the second alternate font instead
of overstriking.
boldFont3 (class Font3)
Specifies the name of the bold font to be
used for the third alternate font instead of
overstriking.
boldFont4 (class Font4)
Specifies the name of the bold font to be
used for the fourth alternate font instead
of overstriking.
brown (class AnsiColors)
This resource specifies a different color
name or value to be used instead of the
standard ANSI ``brown.'' The color can be
any color that your server supports.
charClass (class CharClass)
Specifies comma-separated lists of character
class bindings of the form [low-]high:value.
These are used in determining which sets of
characters should be treated the same when
doing cut and paste. See the section on
specifying character classes.
cyan (class AnsiColors)
This resource specifies a different color
name or value to be used instead of the
standard ANSI ``cyan.'' The color can be
any color that your server supports.
background (class Background)
Specifies the color to use for the back-
ground of the window. This resource also
specifies the color name or value to use in
place of the standard ANSI black. The
default is ``black.''
foreground (class Foreground)
Specifies the color to use for displaying
text in the window. Setting the class name
instead of the instance name is an easy way
to have everything that would normally
appear in the "text" color change color.
This resource also specifies the color name
or value to use in place of the standard
ANSI white. The default is ``white.''
eightBitInput (class EightBitInput)
Specifies whether or not 8-bit characters
should be accepted. The default is
``false.''
font (class Font)
Specifies the name of the normal font. The
default is ``ibm6x13.''
font1 (class Font1)
Specifies the name of the first alternate
font.
font2 (class Font2)
Specifies the name of the second alternate
font.
font3 (class Font3)
Specifies the name of the third alternate
font.
font4 (class Font4)
Specifies the name of the fourth alternate
font.
geometry (class Geometry)
Specifies the preferred size and position of
the window.
gray (class AnsiColors)
This resource specifies a different color
name or value to be used instead of the
standard ANSI ``gray.'' The color may be
any color that your server supports.
green (class AnsiColors)
This resource specifies a different color
name or value to be used instead of the
standard ANSI ``green.'' The color may be
any color that your server supports.
hiwhite (class AnsiColors)
This resource specifies a different color
name or value to be used instead of the
standard ANSI ``hi_white.'' The color may
be any color that your server supports.
internalBorder (class BorderWidth)
Specifies the number of pixels between the
characters and the window border. The
default is 2.
jumpScroll (class JumpScroll)
Specifies whether or not jump scroll should
be used. The default is ``true.''
logFile (class Logfile)
Specifies the name of the file to which a
terminal session is logged. The default is
ScotrmLogXXXX (where XXXXX is the process id
of scoterm).
logging (class Logging)
Specifies whether or not a terminal session
should be logged. The default is ``false.''
logInhibit (class LogInhibit)
Specifies whether or not terminal session
logging should be inhibited from the
ansiMenu. The default is ``false.''
loginShell (class LoginShell)
Specifies whether or not the shell to be run
in the window should be started as a login
shell. The default is ``false.''
ltblue (class AnsiColors)
This resource specifies a different color
name or value that scoterm should use
instead of the standard ANSI ``lt_blue.''
The color can be any color that your server
supports.
ltcyan (class AnsiColors)
This resource specifies a different color
name or value to be used instead of the
standard ANSI ``lt_cyan.'' The color may be
any color that your server supports.
ltgreen (class AnsiColors)
This resource specifies a different color
name or value to be used instead of the
standard ANSI ``lt_green.'' The color may
be any color that your server supports.
ltmagenta (class AnsiColors)
This resource specifies a different color
name or value to be used instead of the
standard ANSI ``lt_magenta.'' The color may
be any color that your server supports.
ltred (class AnsiColors)
This resource specifies a different color
name or value to be used instead of the
standard ANSI ``lt_red.'' The color may be
any color that your server supports.
magenta (class AnsiColors)
This resource specifies a different color
name or value to be used instead of the
standard ANSI ``magenta.'' The color may be
any color that your server supports.
marginBell (class MarginBell)
Specifies whether or not the bell should be
rung when the user types near the right mar-
gin. The default is ``false.''
multiClickTime (class MultiClickTime)
Specifies the maximum time in milliseconds
between multi-click select events. The
default is 250 milliseconds.
multiScroll (class MultiScroll)
Specifies whether or not scrolling should be
done asynchronously. The default is
``false.''
nMarginBell (class Column)
Specifies the number of characters from the
right margin at which the margin bell should
be rung, when enabled. The default is
``10.''
pointerShape (class Cursor)
Specifies the name of the shape of the
pointer. The default is ``xterm.'' Here is
a list of the other pointer shapes: arrow,
basedarrowdown, basedarrowup, boat,
bogosity, bottomleftcorner,
bottomrightcorner, bottomside,
bottomtee, boxspiral, centerptr, circle,
clock, coffeemug, cross, crossreverse,
crosshair, diamondcross, dot, dotboxmask,
doublearrow, draftlarge, draftsmall,
drapedbox, exchange, fleur, gobbler, gumby,
hand, handlmask, heart, icon, ironcross,
leftptr, leftside, lefttee, leftbutton,
llangle, lrangle, man, middlebutton,
mouse, pencil, pirate, plus, questionarrow,
rightptr, rightside, righttee, rightbut-
ton, trllogo, sailboat, sbdownarrow,
sbhdoublearrow, sbleftarrow,
sbrightarrow, sbuparrow,
sbvdoublearrow, shuttle, sizing, spider,
spraycan, star, target, tcross,
topleftarrow, topleftcorner,
toprightcorner, topside, toptee, trek,
ulangle, umbrella, urangle, watch,
xcursor.
reverseVideo (class ReverseVideo)
Specifies whether or not reverse video
should be simulated. The default is
``false.''
red (class AnsiColors)
This resource specifies a different color
name or value to be used instead of the
standard ANSI ``red.'' The color may be any
color that your server supports.
reverseWrap (class ReverseWrap)
Specifies whether or not users can backspace
from the left margin of a line directly to
the rightmost character on the previous
line. The default is ``false.''
saveLines (class SaveLines)
Specifies the number of lines to save beyond
the top of the screen when a scrollbar is
turned on. The default is 64.
scrollBar (class ScrollBar)
Specifies whether or not the scrollbar
should be displayed. The default is
``false.''
scrollInput (class ScrollCond)
Specifies whether or not output to the ter-
minal should automatically cause the
scrollbar to go to the bottom of the scrol-
ling region. The default is ``true.''
scrollKey (class ScrollCond)
Specifies whether or not pressing a key
should automatically cause the scrollbar to
go to the bottom of the scrolling region.
The default is ``true.''
scrollLines (class ScrollLines)
Specifies the number of lines that the
scroll-back and scroll-forw actions should
use as a default. If scrollLines is
assigned a value, scroll-back and scroll-
forw are set to the same value if they have
no arguments of their own. The default
value of scrollLines is one line.
signalInhibit (class SignalInhibit)
Specifies whether or not to disallow the
entries in the mainMenu for sending signals
to scoterm. The default is ``false.''
titeInhibit (class TiteInhibit)
Specifies whether or not scoterm should
remove the ti and te termcap entries (used
to switch between alternate screens on
startup of many screen-oriented programs)
from the TERMCAP string. The default is
``false,'' meaning that the entries should
not be removed.
translations (class Translations)
Specifies the key and button bindings for
menus, selections, ``programmed strings'',
and so on. See ACTIONS later in these
pages.
visualBell (class VisualBell)
Specifies whether or not a visible bell
(that is, flashing) should be used instead
of an audible bell when <Ctrl>G is received.
The default is ``false.''
waitForMap (class WaitForMap)
Specifies whether or not scoterm should wait
for the initial window map before starting
the subprocess. The default is ``false.''
yellow (class AnsiColors)
This resource specifies a different color
name or value to be used instead of the
standard ANSI yellow. The color may be any
color that your server supports.
The resources that may be specified for the various
menus are described in the documentation for the
Athena SimpleMenu widget. The name and classes of
the entries in each of the menus are listed below.
The actions invoked by each menu entry are described
in the section ``ACTIONS,'' later in these pages.
These resources are called from the file
usr/lib/X11/app-defaults, or from the .Xdefaults
file in a user's home directory.
The mainMenu has the following entries:
securekbd (class SmeBSB)
This entry invokes the secure() action.
allowsends (class SmeBSB)
This entry invokes the allow-send-
events(toggle) action.
logging (class SmeBSB)
This entry invokes the set-logging(toggle)
action.
redraw (class SmeBSB)
This entry invokes the redraw() action.
line1 (class SmeLine)
This is a separator.
suspend (class SmeBSB)
This entry invokes the send-signal(suspend)
action on systems that support job control.
continue (class SmeBSB)
This entry invokes the send-signal(cont)
action on systems that support job control.
interrupt (class SmeBSB)
This entry invokes the send-signal(int)
action.
hangup (class SmeBSB)
This entry invokes the send-signal(hup)
action.
terminate (class SmeBSB)
This entry invokes the send-signal(term)
action.
kill (class SmeBSB)
This entry invokes the send-signal(kill)
action.
line2 (class SmeLine)
This is a separator.
quit (class SmeBSB)
This entry invokes the quit() action.
The ansiMenu menu has the following entries:
scrollbar (class SmeBSB)
This entry invokes the set-scrollbar(toggle)
action.
jumpscroll (class SmeBSB)
This entry invokes the set-
jumpscroll(toggle) action.
autowrap (class SmeBSB)
This entry invokes the set-autowrap(toggle)
action.
reversewrap (class SmeBSB)
This entry invokes the set-
reversewrap(toggle) action.
autolinefeed (class SmeBSB)
This entry invokes the set-
autolinefeed(toggle) action.
scrollkey (class SmeBSB)
This entry invokes the set-scroll-on-
key(toggle) action.
scrollttyoutput (class SmeBSB)
This entry invokes the set-scroll-on-tty-
output(toggle) action.
visualbell (class SmeBSB)
This entry invokes the set-
visualbell(toggle) action.
marginbell (class SmeBSB)
This entry invokes the set-
marginbell(toggle) action.
altscreen (class SmeBSB)
This entry informs users if the alternate
screen is being displayed.
line1 (class SmeLine)
This is a separator.
softreset (class SmeBSB)
This entry invokes the soft-reset() action.
hardreset (class SmeBSB)
This entry invokes the hard-reset() action.
The fontMenu has the following entries:
fontdefault (class SmeBSB)
This entry invokes the set-ansi-font(d)
action.
font1 (class SmeBSB)
This entry invokes the set-ansi-font(1)
action.
font2 (class SmeBSB)
This entry invokes the set-ansi-font(2)
action.
font3 (class SmeBSB)
This entry invokes the set-ansi-font(3)
action.
font4 (class SmeBSB)
This entry invokes the set-ansi-font(4)
action.
The following resources are useful when specified
for the Athena Scrollbar widget:
thickness (class Thickness)
Specifies the width in pixels of the
scrollbar.
background (class Background)
Specifies the color to use for the back-
ground of the scrollbar.
foreground (class Foreground)
Specifies the color to use for the fore-
ground of the scrollbar. The ``thumb'' of
the scrollbar is a simple checkerboard pat-
tern alternating pixels for foreground and
background color.
ACTIONS
It is possible to rebind keys (or sequences of keys)
to arbitrary strings for input, by changing the
translations for the ansi widget. Changing the
translations for events other than key and button
events is not expected, and causes unpredictable
behavior. The following actions can be used within
the ansi translations resources:
bell([percent])
This action rings the keyboard bell at the
specified percentage above or below the base
volume.
focus-mouse()
This action focuses the mouse into the ANSI
window.
ignore()
This action ignores the event but checks for
special pointer position escape sequences.
insert()
This action is a synonym for insert-seven-
bit()
insert-seven-bit()
This action inserts the 7-bit USASCII char-
acter or string associated with the keysym
that was pressed.
insert-eight-bit()
This action inserts the 8-bit IBM character
or string associated with the keysym that
was pressed.
insert-selection(sourcename [, ...])
This action inserts the string found in the
selection or cutbuffer indicated by sour-
cename. Sources are checked in the order
given (case is significant) until one is
found. Commonly-used selections include:
PRIMARY, SECONDARY, and CLIPBOARD. Cut
buffers are typically named CUT_BUFFER0
through CUT_BUFFER7.
keymap(name)
This action dynamically defines a new trans-
lation table whose resource name is name
with the suffix Keymap (case is signifi-
cant). The name None restores the original
translation table.
mouse-button-down()
This action generates an SCO event manager
mouse button down event associated with the
X windows mouse button that was pressed.
mouse-button-up()
This action generates an SCO event manager
mouse button up event associated with the X
windows mouse button that was released.
mouse-motion()
This action generates an SCO event manager
mouse motion event associated with the X
windows mouse motion.
popup-menu(menuname)
This action displays the specified popup
menu. Valid names (case is significant)
include: mainMenu, ansiMenu, and fontMenu.
select-start()
This action begins text selection at the
current pointer location. See the section
on POINTER USAGE for information on making
selections.
select-extend()
This action tracks the pointer and extends
the selection. It should only be bound to
Motion events.
select-end(destname [, ...])
This action puts the currently selected text
into all of the selections or cutbuffers
specified by destname.
select-cursor-start()
This action is similar to select-start
except that it begins the selection at the
current text cursor position.
select-cursor-end(destname [, ...])
This action is similar to select-end except
that it should be used with select-cursor-
start.
font]])
set-ansi-font(d/1/2/3/4/e/s [,normalfont [, bold-
This action sets the font or fonts currently
being used in the scoterm window. The first
argument is a single character that speci-
fies the font to be used: d or D indicate
the default font (the font initially used
when scoterm was started), 1 through 4 indi-
cate the fonts specified by the font1
through font4 resources, e or E indicate the
normal and bold fonts that may be set
through escape codes (or specified as the
second and third action arguments, respec-
tively), and s or S indicate the font selec-
tion (as made by programs such as
xfontsel(X)) indicated by the second action
argument.
start-extend()
This action is similar to select-start
except that the selection is extended to the
current pointer location.
start-cursor-extend()
This action is similar to select-extend
except that the selection is extended to the
current text cursor position.
string(string)
This action inserts the specified text
string as if it had been typed. Quotation
is necessary if the string contains white
space or non-alphanumeric characters. If
the string argument begins with the charac-
ters ``0x'', it is interpreted as a hex
character constant.
scroll-back(count [,units])
This action scrolls the text window backward
so that text that had previously scrolled
off the top of the screen is now visible.
The count argument indicates the number of
units (which may be page, halfpage, pixel,
or line) by which to scroll.
scroll-forw(count [,units])
This action scrolls is similar to scroll-
back except that it scrolls the other direc-
tion.
allow-send-events(on/off/toggle)
This action set or toggles the allowSen-
dEvents resource and is also invoked by the
allowsends entry in mainMenu.
set-logging(on/off/toggle)
This action toggles the logging resource and
is also invoked by the logging entry in
mainMenu.
redraw()
This action redraws the window and is also
invoked by the redraw entry in mainMenu.
send-signal(signame)
This action sends the signal named by sig-
name (which may also be a number) to the
scoterm subprocess (the shell or program
specified with the -e command line option)
and is also invoked by the suspend, con-
tinue, interrupt, hangup, terminate, and
kill entries in mainMenu. Allowable signal
names are (case is not significant):
suspend, tstp (if supported by the operating
system), cont (if supported by the operating
system), int, hup, term, and kill.
quit() This action sends a SIGHUP to the subprogram
and exits. It is also invoked by the quit
entry in mainMenu.
set-scrollbar(on/off/toggle)
This action toggles the scrollbar resource
and is also invoked by the scrollbar entry
in ansiMenu.
set-jumpscroll(on/off/toggle)
This action toggles the jumpscroll resource
and is also invoked by the jumpscroll entry
in ansiMenu.
set-reverse-video(on/off/toggle)
This action toggles the reverseVideo
resource.
set-autowrap(on/off/toggle)
This action toggles automatic wrapping of
long lines and is also invoked by the
autowrap entry in ansiMenu.
set-reversewrap(on/off/toggle)
This action toggles the reverseWrap resource
and is also invoked by the reversewrap entry
in ansiMenu.
set-autolinefeed(on/off/toggle)
This action toggles automatic insertion of
linefeeds and is also invoked by the auto-
linefeed entry in ansiMenu.
set-scroll-on-key(on/off/toggle)
This action toggles the scrollKey resource
and is also invoked from the scrollkey entry
in ansiMenu.
set-scroll-on-tty-output(on/off/toggle)
This action toggles the scrollTtyOutput
resource and is also invoked from the
scrollttyoutput entry in ansiMenu.
set-visual-bell(on/off/toggle)
This action toggles the visualBell resource
and is also invoked by the visualbell entry
in ansiMenu.
set-marginbell(on/off/toggle)
This action toggles the marginBell resource
and is also invoked from the marginbell
entry in ansiMenu.
set-altscreen(on/off/toggle)
This action toggles between the alternative
and current screens.
soft-reset()
This action resets the scrolling region and
is also invoked from the softreset entry in
ansiMenu.
hard-reset()
This action resets the scrolling region,
tabs, window size, and cursor keys, reini-
tializes the keyboard, restores the default
sprite, and clears the screen. It is also
invoked from the hardreset entry in
ansiMenu.
The default bindings in the scoterm window are:
! Ctrl Alt <Key>BackSpace: focus-mouse() \n\
! Ctrl <Btn1Down>: popup-menu(mainMenu) \n\
! Ctrl <Btn2Down>: popup-menu(ansiMenu) \n\
! Ctrl <Btn3Down>: popup-menu(fontMenu) \n\
! Shift Ctrl <Btn1Down>: popup-menu(mainMenu)\n\
! Shift Ctrl <Btn2Down>: popup-menu(ansiMenu)\n\
! Shift Ctrl <Btn3Down>: popup-menu(fontMenu)\n\
! Shift <Key>Prior: scroll-back(1,halfpage) \n\
! Shift <Key>Next: scroll-forw(1,halfpage) \n\
! Shift <Key>Select: select-cursor-start() \
select-cursor-end(PRIMARY, CUT_BUFFER0) \n\
! Shift <Key>Insert: insert-selection(PRIMARY, CUT_BUFFER0) \n\
Alt <KeyPress>: insert-eight-bit() \n\
Meta <KeyPress>: insert-eight-bit() \n\
~Alt <KeyPress>: insert-seven-bit() \n\
~Meta <KeyPress>: insert-seven-bit() \n\
<KeyRelease>: insert-seven-bit() \n\
Shift <Btn2Up>: insert-selection(PRIMARY, CUT_BUFFER0) \n\
Shift <Btn1Down>: select-start() \n\
Shift <Btn1Motion>: select-extend() \n\
Shift <Btn3Down>: start-extend() \n\
Shift <Btn3Motion>: select-extend() \n\
Shift <BtnUp>: select-end(PRIMARY, CUT_BUFFER0) \n\
~Shift <Btn2Up>: insert-selection(PRIMARY, CUT_BUFFER0) \n\
~Shift <Btn1Down>: select-start() \n\
~Shift <Btn1Motion>: select-extend() \n\
~Shift <Btn3Down>: start-extend() \n\
~Shift <Btn3Motion>: select-extend() \n\
~Shift <BtnUp>: select-end(PRIMARY, CUT_BUFFER0)
Below is a sample how of the keymap() action is used
to add special keys for entering commonly typed
words:
*Ansi.Translations: #override <Key>F5: keymap(dbx)
*Ansi.dbxKeymap.translations: \
<Key>F6: keymap(None) \n\
<Key>F9: string("next") string("0x0d") \n\
<Key>F10: string("step") string("0x0d") \n\
<Key>F11: string("continue") string("0x0d") \n\
<Key>F12: string("print ") \
insert-selection(PRIMARY, CUT_BUFFER0)
EMULATIONS
The ANSI emulation is fairly complete, but does not
support the blinking character attribute nor the
double-wide and double-size character sets. scoterm
takes ansi as its Termcap (F) entry. By default, the
scoterm program sets the TERM and the TERMCAP
environment variables to ansi.
COPYING AND PASTING TEXT WITH THE MOUSE
From within the scoterm window, you can use the
mouse and its buttons to copy and paste text. You
use one button to select the text you want and copy
it to a temporary buffer. You use another button to
paste the text back from the buffer. If you are run-
ning more than one scoterm window, you can just as
easily paste the text from one window to the next.
The following subsections describe the default mouse
commands for selecting, copying, and pasting text.
(Note that these functions can be assigned to other
buttons and keys through the resource database; see
ACTIONS earlier in this document.)
COPYING TEXT
To copy text (that is, to copy some text into the
cut buffer) use mouse button one, which is usually
the left-hand button. (This is the default button
assignment; it may have been changed on your sys-
tem.) Move the cursor to the beginning of the text.
Then hold the button down while moving the cursor to
the end of the region that you want to copy. Now
release the button.
The text that you have selected is highlighted and
is saved in the global cut buffer and made the PRI-
MARY selection when the button is released. If the
key/button bindings specify that an X selection is
to be made, scoterm leaves the selected text
highlighted for as long as it is the selection
owner.
As you drag the mouse to select text, by default the
highlighted area expands in increments of one char-
acter; thus you can select just part of a line or
part of a word. If you double-click the mouse, the
selected area instead expands in one-word incre-
ments; in this mode you can only select whole words,
not fragments. Triple-clicking makes the selection
expand by one entire line at a time. You can change
back and forth between these modes while selecting a
piece of text. Quadruple-click the mouse to return
to the default setting.
PASTING TEXT
To paste text that you have copied, press mouse but-
ton two, which is usually the middle button. (This
is the default button assignment; it may have been
changed on your system.) This action simultaneously
`types' (pastes) the text from the PRIMARY selec-
tion, if any, or from the cut buffer. The text is
inserted as keyboard input at the prompt in the win-
dow. You can paste the text back into the same win-
dow or switch to another scoterm window and paste it
there instead.
Press mouse button three (usually the right-hand
button) to modify the current selection by either
adding text to it or deselecting part of the current
text. If you position the pointer below or above
the currently selected text, the selection expands
to reach the pointer's location. If the pointer is
to the right or left of the selected text on the
same line, the selection expands right or left to
the cursor location.
Similarly, the selection contracts from its right or
left edge, or from its top and bottom edge, if the
pointer is positioned inside the selected text.
By cutting and pasting pieces of text without trail-
ing new lines, you can take text from several places
in different windows and form a command to the
shell, for example, or take output from a program
and insert it into your favorite editor. Because
the cut buffer is globally shared among different
applications, you should regard it as a `file' whose
contents you know. The terminal emulator and other
text programs should treat the buffer as if it were
a text file.
Some applications that you run under scoterm may
also use the mouse. When that is the case, the but-
ton commands for copy and pasting will not work.
The mouse command goes to the application, which
interprets it according to its own rules. To use
the scoterm cut-and paste-commands under these
circumstances, press the <Shift> key and the
appropriate mouse button simultaneously. This sends
the mouse command to scoterm instead of the applica-
tion. You can then copy and paste text normally.
SCROLLING THE WINDOW WITH THE MOUSE
The scoterm program does not limit you to the 25
lines shown in the display window. By default, it
remembers the last 64 lines that appeared in the
window. So if you equipped the window with a
scrollbar, you can use the mouse buttons to scroll
up and down through the saved text.
Within the scrollbar is a highlighted region that
moves as you scroll back and forth through the saved
text. The scrollbar represents all the saved text,
and the highlighted area represents the part of the
text that is currently being displayed in the
scoterm window. As you continue working in the win-
dow and scoterm saves the lines that scroll off the
top of the screen, the highlighted area of the
scrollbar grows smaller.
If, for example, the highlighted area fills half the
scrollbar, then only half of the saved lines are
currently visible on screen. You would have to
scroll back or forward to see the rest. When you
start the window, before any lines are saved, the
highlighted area fills the entire scrollbar.
When you position the mouse in the scrollbar, the
pointer changes to a two-headed arrow. Clicking
mouse button one in the scrollbar causes the saved
text to scroll forward through the window, toward
the latest line saved. The lines at the bottom of
the window move up to the top.
Clicking button three in the scrollbar causes the
saved text to scroll backward through the window,
toward the oldest line saved. The lines at the top
of the window move down to the bottom.
Clicking button two moves the display to a position
in the saved text that corresponds to the pointer's
position in the scrollbar. For example, if you move
the pointer to the very top of the scroll region and
click button two, the display moves up to near the
beginning of the saved text.
FOCUSING THE MOUSE WITHIN SCOTERM
The scoterm window supports all character-based
applications, including those that are not compati-
ble with the X Window System. If an application
uses a mouse but does not recognize X, you can focus
all mouse activity within the scoterm window by
pressing <Ctrl> <Alt> <Backspace> at the same time.
When you do this, the X cursor disappears. The
application in the scoterm window now controls the
mouse, and the cursor stays within the confines of
the window. To return mouse control to X, press
<Ctrl> <Alt> <Backspace> again.
MENUS
Scoterm has three menus, named mainMenu,
ansiMenu,and fontMenu. Each menu pops up in
response to a particular combination of key and but-
ton presses.
Most menus are divided into two sections separated
by a horizontal line. The top section lists various
optional scoterm features or modes of operation that
can be turned on or off. To turn on one of these
modes, simply select it from the menu. When you next
look at the menu, you see a check mark beside that
mode to show that it has been activated. The
feature remains active until you specifically turn
it off. To do this, just select the mode from the
menu again. When you look at the menu again, the
checkmark by the mode name is gone.
The menu selections below the horizontal lines are
command entries. When you select one, it simply per-
forms the operation in question and then stops.
THE MAIN MENU
The mainMenu menu pops up when the ``control'' key
and mouse button one are pressed in a window. By
default, the label at the top of this menu reads
Main Options. The mainMenu menu options send sig-
nals to the process group of the process running
under scoterm (usually the shell):
Secure Keyboard
You may use this option when typing in pass-
words or other sensitive data in an unsecure
environment; see SECURITY later in these
pages.
Allow SendEvents
This option allows applications other than
the X server to send events to the scoterm
window.
Log to File
This option sends all scoterm input and out-
put into a file in your home directory
called ScotrmLogXXXXX, where XXXXX
represents the scoterm process ID.
Redraw Window
This option redraws the contents of the win-
dow.
Send STOP Signal
This option suspends a process. (Techni-
cally speaking, it sends the SIGSTP signal
to the process group of the process running
under scoterm, usually the shell). If your
system supports job control, this item is
the equivalent of typing <Ctrl>Z. If your
system does not support job control, this
item does not work.
Send CONT Signal
This option continues a process that has
been suspended. (Technically speaking, this
menu item sends the SIGCONT signal to the
process group of the process running under
scoterm, usually the shell). This item is
especially useful on systems with job con-
trol if you accidentally type <Ctrl>Z and
suspend a process.
Send INT Signal
This option interrupts a process. That is,
it sends the SIGINT signal to the process
group of the process running under scoterm,
usually the shell.
Send HUP Signal
This option hangs up the process. That is,
it sends the SIGHUP signal to the process
group of the process running under scoterm,
usually the shell. This usually kills the
scoterm process, and the window disappears
from the screen.
Send TERM Signal
This option terminates the process. That
is, it sends the SIGTERM signal to the pro-
cess group of the process running under
scoterm, usually the shell. This usually
kills the scoterm process, and the window
disappears from the screen.
Send KILL Signal
This option kills the process. That is, it
sends the SIGKILL signal to the process
group of the process running under scoterm,
usually the shell. This kills the scoterm
process, and the window disappears from the
screen.
Quit Use this option to quit scoterm when you are
through working with it.
THE ANSI MENU
The ansiMenu sets various modes in scoterm's ANSI
emulation. By default, the label at the top of this
menu reads Screen Options. To make this menu
appear, press the ``control'' key and mouse button
two. The menu has numerous options:
Enable Scrollbar
This option gives the scoterm window a
scrollbar, which allows the user to scroll
previous input and output back onto the
screen for review.
Enable Jump Scroll
This option tells scoterm to scroll several
lines at a time off the top of the screen,
instead of just one line at a time. scoterm
selects this option by default.
Enable Auto Wraparound
This option allows text or data to wrap to
the next line when you are entering text and
the cursor reaches the right-hand window
border.
Enable Reverse Wraparound
This option allows the cursor to wrap around
from the leftmost column of a line to the
rightmost column of the previous line. In
other words, you can backspace to the previ-
ous line.
Enable Auto Linefeed
This option tells scoterm to generate a
linefeed character at the end of each line.
This feature is useful with programs that
generate a carriage return without dropping
down a line on your screen. This option is
not usually needed on UNIX systems.
Scroll to Bottom on Keypress
This option works in conjunction with the
scrollbar. If you have used the scrollbar
to scroll up through previously displayed
text, pressing any key automatically snaps
the window back down to the last line of
text.
Scroll to Bottom on tty Output
This option works in conjunction with the
scrollbar. If you are using the scrollbar
to scroll up through previously-displayed
text and a program suddenly sends a message
to the screen, scoterm automatically scrolls
you back down to the bottom of the saved
text, to the place where the message has
appeared. This option turns on automati-
cally if the window has a scrollbar.
Enable Visual Bell
This option replaces the terminal bell with
a visual signal. In situations where the
terminal's bell would sound, the window
flashes brightly instead.
Enable Margin Bell
If a user is typing in text and nears the
right end of the line, this option tells
scoterm to ring the terminal bell as a warn-
ing.
Alternate Screen Showing
This option is ``greyed out,'' so that you
cannot select it. It is advisory only.
When a checkmark appears beside it, it is a
sign that you are looking at an alternate
screen (for example, the screen for an edi-
tor that you started from scoterm), not the
original scoterm screen.
Do Soft Reset
The soft reset entry resets scroll regions
from partial scroll (a portion of the win-
dow) to full scroll. Use this command when
a program has left the scroll region set
incorrectly.
Do Full Reset
The hard reset entry clears the screen,
resets tabs to every eight columns, reini-
tializes the keyboard mapping data, restores
the sprite to its default shape, and resets
the terminal modes (such as wrap and jump
scroll) to their initial states just after
scoterm has finished processing the command
line options.
THE FONT MENU
Use the fontMenu to choose the font used in the
scoterm window. This menu appears when you press
the ``control'' key and mouse button three. By
default, the label ``Font'' appears at the top of
the menu. When you make a selection, the window
automatically redraws itself with the new font.
The scoterm program supports up to five fonts at one
time, plus bold versions of each font. The fontMenu
lists the following fonts:
Default This option switches you to the default
scoterm screen font, IBM 6x13.
IBM 6x13
This is the default scoterm font.
IBM 8x13
The scoterm window automatically widens to
adjust for this wider font.
IBM 9x15
This is a somewhat larger font. The window
automatically widens to adjust for it.
IBM 10x20
This is a substantially larger font. The
window automatically widens to adjust for
it.
You may add your own fonts to this menu by editing
the file usr/lib/X11/apps-defaults/Scoterm. Replace
one or more of the five fonts you find listed there
with the font or fonts that you want to add.
The fonts that SCO supplies work only with the SCO X
server. If you run scoterm on a non-SCO X server,
then, you will probably want to replace all the
fonts on the fontMenu with fonts supported by your
own X server.
If you add ISO fonts to the fontMenu, do not use
these fonts when running applications that draw
lines on the screen. ISO fonts have a limited
selection of line-drawing characters, and so the
lines drawn by the applications may look wrong, or
may not appear on the screen at all.
SECURITY
X environments differ in their security conscious-
ness. MIT servers, run under xdm, are capable of
using a ``magic cookie'' authorization scheme that
can provide a reasonable level of security for many
people.
But if your server is only using a host-based
mechanism to control access to the server (see
xhost(X)), security may be inadequate. When you
enable access for a host and other users are also
permitted to run clients on that same host, there is
every possibility that someone can run an applica-
tion that uses the basic services of the X protocol
to snoop on your activities, including everything
you type at the keyboard. This is of particular
concern when you want to type in a password or other
sensitive data. The best solution to this problem
is to use a better authorization mechanism than
host-based control, but a simple mechanism exists
for protecting keyboard input in scoterm.
The mainMenu (see MENUS earlier in these pages) con-
tains a Secure Keyboard entry which, when enabled,
ensures that all keyboard input is directed only to
scoterm (using the GrabKeyboard protocol request).
When an application prompts you for a password (or
other sensitive data), you can enable Secure Key-
board using the menu, type in the data, and then
disable Secure Keyboard using the menu again. Only
one X client at a time can secure the keyboard, so
when you attempt to enable Secure Keyboard it may
fail. In this case, the bell sounds. If the Secure
Keyboard succeeds, any characters that you type are
displayed in reverse video. If this doesn't happen,
then you should be very suspicious that you are
being spoofed. If the application you are running
displays a prompt before asking for the password, it
is safest to enter secure mode before the prompt
gets displayed, and then to make sure that the text
that you type is displayed in reverse video, to
minimize the probability of spoofing. You can also
bring up the menu again and make sure that a check
mark appears next to the entry.
Secure Keyboard mode is disabled automatically if
your scoterm window becomes iconified (or otherwise
unmapped), or if you start up a reparenting window
manager (that places a title bar or other decoration
around the window) while in Secure Keyboard mode.
(This is a feature of the X protocol not easily
overcome.) When this happens, the foreground and
background colors are switched back and the bell
sounds in warning.
CHARACTER CLASSES
Clicking the first mouse button twice in rapid suc-
cession causes all contiguous characters of the same
class (for example, letters, white space, punctua-
tion) to be selected. Because different people have
different preferences for what should be selected
(for example, should filenames be selected as a
whole or only the separate subnames), the default
mapping can be overridden through the use of the
charClass (class CharClass) resource.
This resource is simply a list of range:value pairs
where the range is either a single number or low-
high in the range of 0 to 127, corresponding to the
ASCII code for the character or characters to be
set. The value is arbitrary, although the default
table uses the character number of the first charac-
ter occurring in the set.
The default table is:
static int charClass[256] = {
/* NUL SOH STX ETX EOT ENQ ACK BEL */
32, 1, 1, 1, 1, 1, 1, 1,
/* BS HT NL VT NP CR SO SI */
1, 32, 1, 1, 1, 1, 1, 1,
/* DLE DC1 DC2 DC3 DC4 NAK SYN ETB */
1, 1, 1, 1, 1, 1, 1, 1,
/* CAN EM SUB ESC FS GS RS US */
1, 1, 1, 1, 1, 1, 1, 1,
/* SP ! " # $ % & ' */
32, 33, 34, 35, 36, 37, 38, 39,
/* ( ) * + , - . / */
40, 41, 42, 43, 44, 45, 46, 47,
/* 0 1 2 3 4 5 6 7 */
48, 48, 48, 48, 48, 48, 48, 48,
/* 8 9 : ; < = > ? */
48, 48, 58, 59, 60, 61, 62, 63,
/* @ A B C D E F G */
64, 48, 48, 48, 48, 48, 48, 48,
/* H I J K L M N O */
48, 48, 48, 48, 48, 48, 48, 48,
/* P Q R S T U V W */
48, 48, 48, 48, 48, 48, 48, 48,
/* X Y Z [ ] ^ _ */
48, 48, 48, 91, 92, 93, 94, 48,
/* ` a b c d e f g */
96, 48, 48, 48, 48, 48, 48, 48,
/* h i j k l m n o */
48, 48, 48, 48, 48, 48, 48, 48,
/* p q r s t u v w */
48, 48, 48, 48, 48, 48, 48, 48,
/* x y z { | } ~ DEL */
48, 48, 48, 123, 124, 125, 126, 1,
/* 128 129 130 131 132 133 134 135 */
48, 48, 48, 48, 48, 48, 48, 48,
/* 136 137 138 139 140 141 142 143 */
48, 48, 48, 48, 48, 48, 48, 48,
/* 144 145 146 147 148 149 150 151 */
48, 48, 48, 48, 48, 48, 48, 48,
/* 152 153 154 155 156 157 158 159 */
48, 48, 48, 155, 156, 157, 158, 159,
/* 160 161 162 163 164 165 166 167 */
48, 48, 48, 48, 48, 48, 48, 48,
/* 168 169 170 171 172 173 174 175 */
168, 169, 170, 171, 172, 173, 174, 175,
/* 176 177 178 179 180 181 182 183 */
176, 177, 178, 179, 179, 179, 179, 179,
/* 184 185 186 187 188 189 190 191 */
179, 179, 179, 179, 179, 179, 179, 179,
/* 192 193 194 195 196 197 198 199 */
179, 179, 179, 179, 179, 179, 179, 179,
/* 200 201 202 203 204 205 206 207 */
179, 179, 179, 179, 179, 179, 179, 179,
/* 208 209 210 211 212 213 214 215 */
179, 179, 179, 179, 179, 179, 179, 179,
/* 216 217 218 219 220 221 222 223 */
179, 179, 179, 219, 219, 219, 219, 219,
/* 224 225 226 227 228 229 230 231 */
224, 224, 224, 224, 224, 224, 224, 224,
/* 232 233 234 235 236 237 238 239 */
224, 224, 224, 224, 236, 224, 224, 239,
/* 240 241 242 243 244 245 246 247 */
240, 241, 242, 243, 244, 245, 246, 247,
/* 248 249 250 251 252 253 254 255 */
248, 249, 250, 251, 252, 253, 254, 255
};
For example, the string ``33:48,37:48,45-
47:48,64:48'' indicates that the exclamation mark,
percent sign, dash, period, slash, and ampersand
characters should be treated the same way as charac-
ters and numbers. This is very useful for cutting
and pasting electronic mailing addresses and
filenames.
ENVIRONMENT
Scoterm sets the environment variables TERM and
TERMCAP properly for the size window you have
created. It also uses and sets the environment
variable DISPLAY to specify which bit map display
terminal to use. The environment variable WINDOWID
is set to the X window ID number of the scoterm win-
dow.
SEE ALSO
resize(X)
X(X)
pty(F)
tty(F)
scoterm Control Sequences
RESTRICTIONS AND LIMITATIONS
The class name is Scoterm.
Proportional fonts are not supported.
When a font name begins with the prefix ``ibm,''
scoterm assumes that the font is an IBM code page
437 font.
COPYRIGHT
Copyright 1990, The Santa Cruz Operation, Inc.