NAME
xterm - terminal emulator for X
SYNOPSIS
xterm
[-_t_o_o_l_k_i_t_o_p_t_i_o_n ...] [-option ...]
DESCRIPTION
The _x_t_e_r_m program is a terminal emulator for the X Window System.
It provides DEC VT102/VT220 (VTxxx) and Tektronix 4014
compatible terminals for programs that cannot
use the window system directly.
If the underlying operating system supports
terminal resizing capabilities (for example, the SIGWINCH signal in systems
derived from 4.3bsd), _x_t_e_r_m will use the facilities to notify programs
running in the window whenever it is resized.
The VTxxx and Tektronix 4014 terminals each have their own window so that you
can edit text in one and look at graphics in the other at the same time.
To maintain the correct aspect ratio (height/width), Tektronix graphics will
be restricted to the largest box with a 4014's aspect ratio that will fit in
the window.
This box is located in the upper left area of the window.
Although both windows may be displayed at the same time, one of them is
considered the ``active'' window for receiving keyboard input and terminal
output.
This is the window that contains the text cursor.
The active window can be chosen through escape sequences,
the ``VT Options'' menu in the VTxxx window, and the ``Tek Options''
menu in the 4014 window.
EMULATIONS
The VT102 emulation is fairly complete, but does not support
autorepeat.
Double-size characters are displayed properly if your font server supports
scalable fonts.
The VT220 emulation does not support soft fonts, it is otherwise complete.
Termcap(5)
entries that work with
xterm
include
an optional platform-specific entry,
``xterm,'' ``vt102,'' ``vt100'' and ``ansi,'' and ``dumb.''
xterm
automatically searches the termcap file in this order for these entries and then
sets the ``TERM'' and the ``TERMCAP'' environment variables.
You may also use ``vt220,'' but must set the terminal emulation level
with the ddeeccTTeerrmmiinnaallIIDD resource.
(The ``TERMCAP'' environment variable is not set if _x_t_e_r_m is linked
against a terminfo library, since the requisite information is not provided
by the termcap emulation of terminfo libraries).
Many of the special
xterm
features may be modified under program control
through a set of escape sequences different from the standard VT102 escape
sequences.
(See the
Xterm Control Sequences
document.)
The Tektronix 4014 emulation is also fairly good.
It supports 12-bit graphics addressing, scaled to the window size.
Four different font sizes and five different lines types are supported.
There is no write-through or defocused mode support.
The Tektronix text and graphics commands are recorded internally by
xterm
and may be written to a file by sending the COPY escape sequence (or through
the
Tektronix
menu; see below).
The name of the file will be
``CCOOPPYY_y_y_y_y--_M_M--_d_d.._h_h::_m_m::_s_s'', where
yyyy,
MM,
dd,
hh,
mm
and
ss
are the year, month, day, hour, minute and second when the COPY was performed
(the file is created in the directory
xterm
is started in, or the home directory for a login
xterm).
Not all of the features described in this manual are necessarily available in
this version of _x_t_e_r_m.
Some (e.g., the non-VT220 extensions) are available
only if they were compiled in, though the most commonly-used are in the
default configuration.
OTHER FEATURES
Xterm
automatically highlights the text cursor when the
pointer enters the window (selected) and unhighlights it when the pointer
leaves the window (unselected).
If the window is the focus window, then the text cursor is
highlighted no matter where the pointer is.
In VT102 mode, there are escape sequences to activate and deactivate
an alternate screen buffer, which is the same size as the display area
of the window.
When activated, the current screen is saved and replaced with the alternate
screen.
Saving of lines scrolled off the top of the window is disabled until the
normal screen is restored.
The
termcap(5)
entry for
xterm
allows the visual editor
vi(1)
to switch to the alternate screen for editing and to restore the screen
on exit.
A popup menu entry makes it simple to switch between the normal and
alternate screens for cut and paste.
In either VT102 or Tektronix mode, there are escape sequences to change the
name of the windows.
Additionally, in VT102 mode,
_x_t_e_r_m implements the window-manipulation control
sequences from _d_t_t_e_r_m, such as resizing the window, setting its location
on the screen.
Xterm
allows character-based applications to receive mouse events (currently
button-press and release events, and button-motion events)
as keyboard control sequences.
See _X_t_e_r_m _C_o_n_t_r_o_l _S_e_q_u_e_n_c_e_s for details.
OPTIONS
The _x_t_e_r_m terminal emulator
accepts all of the standard X Toolkit command line options as well as
the following.
If the option begins with a
instead of a
the option is restored to its default value.
The --vveerrssiioonn and --hheellpp options are interpreted even if _x_t_e_r_m cannot
open the display, and are useful for testing and configuration scripts:
-
-version
-
This causes _x_t_e_r_m to print a version number to the standard output.
-
-help
-
This causes _x_t_e_r_m to print out a verbose message describing its options.
The message is written to the standard error.
The other options are used to control the appearance and behavior.
Not all options are necessarily configured into your copy of _x_t_e_r_m.
-
-132
-
Normally, the VT102 DECCOLM escape sequence that switches between 80 and
132 column mode is ignored.
This option causes the DECCOLM escape sequence to be recognized, and the
xterm
window will resize appropriately.
-
-ah
-
This option indicates that
xterm
should always highlight the text cursor.
By default,
xterm
will display a hollow text cursor whenever the focus is lost or the
pointer leaves the window.
-
+ah
-
This option indicates that
xterm
should do text cursor highlighting based on focus.
-
-ai
-
This option disables active icon support if that feature was compiled
into _x_t_e_r_m.
This is equivalent to setting the _v_t_1_0_0 resource
aaccttiivveeIIccoonn to FALSE.
-
+ai
-
This option enables active icon support if that feature was compiled
into _x_t_e_r_m.
This is equivalent to setting the _v_t_1_0_0 resource
aaccttiivveeIIccoonn to TRUE.
-
-aw
-
This option indicates that auto-wraparound should be allowed.
This
allows the cursor to automatically wrap to the beginning of the next
line when when it is at the rightmost position of a line and text is
output.
-
+aw
-
This option indicates that auto-wraparound should not be allowed.
-
-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.
-
+bc
-
turn off text cursor blinking.
This overrides the ccuurrssoorrBBlliinnkk resource.
-
-bc
-
turn on text cursor blinking.
This overrides the ccuurrssoorrBBlliinnkk resource.
-
-bcf milliseconds
-
time text cursor is off when blinking
-
-bcn milliseconds
-
time text cursor is on when blinking
-
-bdc
-
Set the _v_t_1_0_0 resource ccoolloorrBBDDMMooddee to FALSE,
disabling the display of characters with bold attribute as color
-
+bdc
-
Set the _v_t_1_0_0 resource ccoolloorrBBDDMMooddee to TRUE,
enabling the display of characters with bold attribute as color
rather than bold
-
-cb
-
Set the _v_t_1_0_0 resource ccuuttTTooBBeeggiinnnniinnggOOffLLiinnee to FALSE.
-
+cb
-
Set the _v_t_1_0_0 resource ccuuttTTooBBeeggiinnnniinnggOOffLLiinnee to TRUE.
-
-cc _c_h_a_r_a_c_t_e_r_c_l_a_s_s_r_a_n_g_e:_v_a_l_u_e[,...]
-
This sets classes indicated by the given ranges for using in selecting by
words.
See the section specifying character classes.
-
-cjk_width
-
Set the ccjjkkWWiiddtthh resource to ``true''.
When turned on, characters with East Asian Ambiguous (A) category in UTR 11
have a column width of 2.
Othrwise, they have a column width of 1.
This may be useful for some legacy CJK text
terminal-based programs assuming box drawings and others to have a column
width of 2.
It also has to be turned on when you specify a truetype
CJK double-width (bi-width/monospace) font either with --ffaa at
the command line or ffaacceeNNaammee resource.
The default is ``false''
-
+cjk_width
-
Reset the ccjjkkWWiiddtthh resource.
-
-class string
-
This option allows you to override _x_t_e_r_m's resource class.
Normally it is ``XTerm'', but
can be set to another class such as ``UXTerm'' to override selected resources.
-
-cm
-
This option disables recognition of ANSI color-change escape sequences.
-
+cm
-
This option enables recognition of ANSI color-change escape sequences.
This is the same as the _v_t_1_0_0 resource ccoolloorrMMooddee.
-
-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.
-
-cr color
-
This option specifies the color to use for text cursor.
The default is to
use the same foreground color that is used for text.
-
-cu
-
This option indicates that _x_t_e_r_m should work around a bug in the
more(1)
program that causes it
to incorrectly display lines that are exactly the width of the window and
are followed by a line beginning with a tab
(the leading tabs are not displayed).
This option is so named because it was originally thought to be a bug
in the
curses(3x)
cursor motion package.
-
+cu
-
This option indicates that _x_t_e_r_m should not work around the
more(1)
bug mentioned above.
-
-dc
-
This option disables the escape sequence to change dynamic colors:
the vt100 foreground and background colors,
its text cursor color,
the pointer cursor foreground and background colors,
the Tektronix emulator foreground and background colors,
its text cursor color
and highlight color.
-
+dc
-
This option enables the escape sequence to change dynamic colors.
-
-e program _[ _a_r_g_u_m_e_n_t_s _._._. _]_<_/_i_>
_<_d_d_>
_T_h_i_s _o_p_t_i_o_n _s_p_e_c_i_f_i_e_s _t_h_e _p_r_o_g_r_a_m _(_a_n_d _i_t_s _c_o_m_m_a_n_d _l_i_n_e _a_r_g_u_m_e_n_t_s_) _t_o _b_e
_r_u_n _i_n _t_h_e _x_t_e_r_m _w_i_n_d_o_w_.
_I_t _a_l_s_o _s_e_t_s _t_h_e _w_i_n_d_o_w _t_i_t_l_e _a_n_d _i_c_o_n
_n_a_m_e _t_o _b_e _t_h_e _b_a_s_e_n_a_m_e _o_f _t_h_e _p_r_o_g_r_a_m _b_e_i_n_g _e_x_e_c_u_t_e_d _i_f _n_e_i_t_h_e_r _-_T
_n_o_r _-_n _a_r_e _g_i_v_e_n _o_n _t_h_e _c_o_m_m_a_n_d _l_i_n_e_.
TThhiiss mmuusstt bbee tthhee llaasstt ooppttiioonn oonn tthhee ccoommmmaanndd lliinnee..
_<_d_t_>
_<_b_>_-_e_n_<_/_b_>_<_i_> _e_n_c_o_d_i_n_g_<_/_i_>
_<_d_d_>
_T_h_i_s _o_p_t_i_o_n _d_e_t_e_r_m_i_n_e_s _t_h_e _e_n_c_o_d_i_n_g _o_n _w_h_i_c_h _x_t_e_r_m _r_u_n_s_.
_I_t _c_o_r_r_e_s_p_o_n_d_s _t_o _t_h_e llooccaallee resource.
Encodings other than UTF-8 are supported by using _l_u_i_t.
The --llcc option should be used instead of --eenn for
systems with locale support.
-
-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 will be used as the
normal font and the bold font will be produced by overstriking this font.
The default is to do overstriking of the normal font.
See also the discussion of bboollddFFoonntt and bboollddMMooddee resources.
-
-fa pattern
-
This option sets the pattern for fonts selected from the FreeType
library if support for that library was compiled into _x_t_e_r_m.
This corresponds to the ffaacceeNNaammee resource.
When a CJK
double-width font is specified, you also need to turn
on the ccjjkkWWiiddtthh resource.
-
-fbb
-
This option indicates that _x_t_e_r_m should compare normal and bold fonts bounding
boxes to ensure they are compatible.
-
+fbb
-
This option indicates that _x_t_e_r_m should not compare normal and bold fonts bounding
boxes to ensure they are compatible.
-
-fbx
-
This option indicates that _x_t_e_r_m should not assume that the
normal and bold fonts have VT100 line-drawing characters.
If any are missing, _x_t_e_r_m will draw the characters directly.
-
+fbx
-
This option indicates that _x_t_e_r_m should assume that the
normal and bold fonts have VT100 line-drawing characters.
-
-fd pattern
-
This option sets the pattern for double-width fonts selected from the FreeType
library if support for that library was compiled into _x_t_e_r_m.
This corresponds to the ffaacceeNNaammeeDDoouubblleessiizzee resource.
-
-fi font
-
This option sets the font for active icons if that feature was compiled
into _x_t_e_r_m.
See also the discussion of the iiccoonnFFoonntt resource.
-
-fs size
-
This option sets the pointsize for fonts selected from the FreeType
library if support for that library was compiled into _x_t_e_r_m.
This corresponds to the ffaacceeSSiizzee resource.
-
-fw _f_o_n_t
-
This option specifies the font to be used for displaying wide text.
By default,
it will attempt to use a font twice as wide as the font that will be used to
draw normal text.
If no doublewidth font is found, it will improvise, by stretching
the normal font.
This corresponds to the wwiiddeeFFoonntt resource.
-
-fwb _f_o_n_t
-
This option specifies the font to be used for displaying bold wide text.
By default,
it will attempt to use a font twice as wide as the font that will be used to
draw bold text.
If no doublewidth font is found, it will improvise, by stretching
the bold font.
This corresponds to the wwiiddeeBBoollddFFoonntt resource.
-
-fx _f_o_n_t
-
This option specifies the font to be used for displaying the preedit string
in the "OverTheSpot" input method.
See also the discussion of the xxiimmFFoonntt resource.
-
-hc color
-
This option specifies the color to use for the background of
selected or otherwise highlighted text.
If not specified,
reverse video is used.
-
-hf
-
This option indicates that HP Function Key escape codes should be generated
for function keys.
-
+hf
-
This option indicates that HP Function Key escape codes should not be generated
for function keys.
-
-hold
-
Turn on the hhoolldd resource, i.e.,
_x_t_e_r_m will not immediately destroy its window when the shell command completes.
It will wait until you use the window manager to destroy/kill the window, or
if you use the menu entries that send a signal, e.g., HUP or KILL.
-
+hold
-
Turn off the hhoolldd resource, i.e.,
_x_t_e_r_m will immediately destroy its window when the shell command completes.
-
-ie
-
Turn on the ppttyyIInniittiiaallEErraassee resource, i.e.,
use the pseudo-terminal's sense of the stty erase value.
-
+ie
-
Turn off the ppttyyIInniittiiaallEErraassee resource, i.e.,
set the stty erase value using the kkbb string from the termcap entry as
a reference, if available.
-
-im
-
Turn on the uusseeIInnsseerrttMMooddee resource.
-
+im
-
Turn off the uusseeIInnsseerrttMMooddee resource.
-
-into windowId
-
Given an X window identifier (a decimal integer),
_x_t_e_r_m will reparent its top-level shell widget to that window.
This is used to embed _x_t_e_r_m within other applications.
-
-j
-
This option indicates that _x_t_e_r_m should do jump scrolling.
Normally,
text is scrolled one line at a time; this option allows _x_t_e_r_m to move
multiple lines at a time so that it does not fall as far behind.
Its use is
strongly recommended since it makes _x_t_e_r_m much faster when scanning
through large amounts of text.
The VT100 escape sequences for enabling and
disabling smooth scroll as well as the ``VT Options''
menu can be used to turn this
feature on or off.
-
+j
-
This option indicates that _x_t_e_r_m should not do jump scrolling.
-
-k8
-
This option sets the aalllloowwCC11PPrriinnttaabbllee resource.
When aalllloowwCC11PPrriinnttaabbllee is set, _x_t_e_r_m overrides the mapping
of C1 control characters (code 128-159) to treat them as printable.
-
+k8
-
This option resets the aalllloowwCC11PPrriinnttaabbllee resource.
-
-l
-
Turn logging on.
Normally logging is not supported, due to security concerns.
Some versions of _x_t_e_r_m may have logging enabled.
The logfile is written to the directory from which _x_t_e_r_m is
invoked.
The filename is generated, of the form
XtermLog._X_X_X_X_X_X
or
Xterm.log._h_o_s_t_n_a_m_e_._y_y_y_y_._m_m_._d_d_._h_h_._m_m_._s_s_._X_X_X_X_X_X
depending on how _x_t_e_r_m was built.
-
+l
-
Turn logging off.
-
-lc
-
Turn on support of various encodings according to the users'
locale setting, i.e., LC_ALL, LC_CTYPE, or LANG environment variables.
This is achieved by turning on UTF-8 mode and by invoking _l_u_i_t for
conversion between locale encodings and UTF-8.
(_l_u_i_t is not invoked in UTF-8 locales.)
This corresponds to the llooccaallee resource.
-
The actual list of encodings which are supported is determined by _l_u_i_t.
-
Consult the _l_u_i_t manual page for further details.
See also the discussion of the --uu88 option which supports UTF-8 locales.
-
+lc
-
Turn off support of automatic selection of locale encodings.
Conventional 8bit mode or, in UTF-8 locales or with --uu88 option,
UTF-8 mode will be used.
-
-lcc path
-
File name for the encoding converter from/to locale encodings
and UTF-8 which is used with --llcc option or llooccaallee resource.
This corresponds to the llooccaalleeFFiilltteerr resource.
-
-leftbar
-
Force scrollbar to the left side of VT100 screen.
This is the default, unless you have set the rightScrollBar resource.
-
-lf filename
-
Specify the log-filename.
See the --ll option.
-
-ls
-
This option indicates that the shell that is started in the _x_t_e_r_m window
will be a login shell (i.e., the first character of argv[0] will be a dash,
indicating to the shell that it should read the user's .login or .profile).
-
The --llss flag and the llooggiinnSShheellll resource
-
are ignored if --ee is also given,
because _x_t_e_r_m does not know how to make the shell
start the given command after whatever it does when it is a login
shell - the user's shell of choice need not be a Bourne shell after all.
Also, _x_t_e_r_m _-_e is supposed to provide a consistent
functionality for other applications that need to start text-mode
programs in a window, and if llooggiinnSShheellll were not ignored, the
result of ~/.profile might interfere with that.
-
If you do want the effect of --llss and --aa simultaneously, you
-
may get away with something like
xterm -e /bin/bash -l -c "my command here"
-
Finally, --llss is not completely ignored,
-
because _x_t_e_r_m _-_l_s _-_e does write a _/_e_t_c_/_w_t_m_p entry
(if configured to do so),
whereas _x_t_e_r_m _-_e does not.
-
+ls
-
This option indicates that the shell that is started should not be a login
shell (i.e., it will be a normal ``subshell'').
-
-mb
-
This option indicates that _x_t_e_r_m 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 ``VT Options'' menu.
-
+mb
-
This option indicates that margin bell should not be rung.
-
-mc milliseconds
-
This option specifies the maximum time between multi-click selections.
-
-mesg
-
Turn off the mmeessssaaggeess resource, i.e.,
disallow write access to the terminal.
-
+mesg
-
Turn on the mmeessssaaggeess resource, i.e.,
allow write access to the terminal.
-
-ms color
-
This option specifies the color to be used for the pointer cursor.
The default
is to use the foreground color.
-
-nb number
-
This option specifies the number of characters from the right end of a line
at which the margin bell, if enabled, will ring.
The default is 10.
-
-nul
-
This option disables the display of underlining.
-
+nul
-
This option enables the display of underlining.
-
-pc
-
This option enables the PC-style use of bold colors (see boldColors
resource).
-
+pc
-
This option disables the PC-style use of bold colors.
-
-pob
-
This option indicates that the window should be raised whenever a
Control-G is received.
-
+pob
-
This option indicates that the window should not be raised whenever a
Control-G is received.
-
-rightbar
-
Force scrollbar to the right side of VT100 screen.
-
-rvc
-
This option disables the display of characters with reverse attribute as color.
-
+rvc
-
This option enables the display of characters with reverse attribute as color.
-
-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 ``VT Options'' menu.
-
+rw
-
This option indicates that reverse-wraparound should not be allowed.
-
-s
-
This option indicates that _x_t_e_r_m may scroll asynchronously, meaning that
the screen does not have to be kept completely up to date while scrolling.
This allows _x_t_e_r_m 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 _x_t_e_r_m should scroll synchronously.
-
-samename
-
Does not send title and icon name change requests when the request
would have no effect: the name is not changed.
This has the advantage
of preventing flicker and the disadvantage of requiring an extra
round trip to the server to find out the previous value.
In practice
this should never be a problem.
-
+samename
-
Always send title and icon name change requests.
-
-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
``VT Options'' menu.
-
+sb
-
This option indicates that a scrollbar should not be displayed.
-
-sf
-
This option indicates that Sun Function Key escape codes should be generated
for function keys.
-
+sf
-
This option indicates that the standard escape codes should be generated for
function keys.
-
-si
-
This option indicates that output to a window should not automatically
reposition the screen to the bottom of the scrolling region.
This option can be turned on and off from the ``VT Options'' menu.
-
+si
-
This option indicates that output to a window 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.
This corresponds to the ssaavveeLLiinneess resource.
The default is 64.
-
-sm
-
This option, corresponding to the sseessssiioonnMMggtt resource,
indicates that _x_t_e_r_m should
set up session manager callbacks.
-
+sm
-
This option indicates that _x_t_e_r_m should
not set up session manager callbacks.
-
-sp
-
This option indicates that Sun/PC keyboard should be assumed,
providing mapping for keypad `+' to `,', and
CTRL-F1 to F13, CTRL-F2 to F14, etc.
-
+sp
-
This option indicates that the standard escape codes should be generated for
keypad and function keys.
-
-t
-
This option indicates that _x_t_e_r_m should start in Tektronix mode, rather
than in VT102 mode.
Switching between the two windows is done using the
``Options'' menus.
Termcap(5)
entries that work with
xterm
``tek4014,'' ``tek4015,'' ``tek4012'', ``tek4013'' and ``tek4010,'' and ``dumb.''
xterm
automatically searches the termcap file in this order for these entries and then
sets the ``TERM'' and the ``TERMCAP'' environment variables.
-
+t
-
This option indicates that _x_t_e_r_m should start in VT102 mode.
-
-ti term_id
-
Specify the name used by _x_t_e_r_m to select the
correct response to terminal ID queries.
It also specifies the emulation level,
used to determine the type of response to a DA control sequence.
Valid values include vt52, vt100, vt101, vt102, and vt220 (the "vt" is optional).
The default is vt100.
The term_id argument specifies the terminal ID to use.
(This is the same as the ddeeccTTeerrmmiinnaallIIDD resource).
-
-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 _s_t_t_y
program.
The keywords and their values are described in detail in the ttttyyMMooddeess
resource.
-
-tn name
-
This option specifies the name of the terminal type to be set in the TERM
environment variable.
It corresponds to the tteerrmmNNaammee resource.
This terminal type must exist in the terminal
database
(termcap or terminfo, depending on how _x_t_e_r_m is built)
and should have _l_i_# and _c_o_# entries.
If the terminal type is not found, _x_t_e_r_m uses the built-in list
``xterm'', ``vt102'', etc.
-
-u8
-
This option sets the uuttff88 resource.
When uuttff88 is set, _x_t_e_r_m interprets incoming data as UTF-8.
This sets the wwiiddeeCChhaarrss resource as a side-effect,
but the UTF-8 mode set by this option prevents it from being turned off.
If you must turn it on and off, use the wwiiddeeCChhaarrss resource.
-
This option and the uuttff88 resource are overridden by
-
the --llcc and --eenn options and llooccaallee resource.
That is, if _x_t_e_r_m has been compiled to support _l_u_i_t,
and the llooccaallee resource is not ``false''
this option is ignored.
We recommend using
the --llcc option or the ``llooccaallee:: ttrruuee'' resource
in UTF-8 locales when your operating system supports locale,
or --eenn UUTTFF--88 option or the ``llooccaallee:: UUTTFF--88'' resource
when your operating system does not support locale.
-
+u8
-
This option resets the uuttff88 resource.
-
-ulc
-
This option disables the display of characters with underline attribute as
color rather than with underlining.
-
+ulc
-
This option enables the display of characters with underline attribute as
color rather than with underlining.
-
-ut
-
This option indicates that _x_t_e_r_m should not write a record into the
the system _u_t_m_p log file.
-
+ut
-
This option indicates that _x_t_e_r_m should write a record into
the system _u_t_m_p log file.
-
-vb
-
This option indicates that a visual bell is preferred over an audible one.
Instead of ringing the terminal bell whenever a Control-G is received, the
window will be flashed.
-
+vb
-
This option indicates that a visual bell should not be used.
-
-wc
-
This option sets the wwiiddeeCChhaarrss resource.
When wwiiddeeCChhaarrss is set, _x_t_e_r_m maintains internal structures for 16-bit
characters.
If you do not set this resource to ``true'',
_x_t_e_r_m will ignore the escape sequence which turns UTF-8 mode on and off.
The default is ``false''.
-
+wc
-
This option resets the wwiiddeeCChhaarrss resource.
-
-wf
-
This option indicates that _x_t_e_r_m 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 _x_t_e_r_m show not wait before starting the
subprocess.
-
-ziconbeep _p_e_r_c_e_n_t
-
Same as zIconBeep resource.
If percent is non-zero, xterms that produce output while iconified
will cause an XBell sound at the given volume
and have "***" prepended to their icon titles.
Most window managers will detect this change immediately, showing you
which window has the output.
(A similar feature was in x10 _x_t_e_r_m.)
-
-C
-
This option indicates that this window should receive console output.
This
is not supported on all systems.
To obtain console output, you must be the
owner of the console device, and you must have read and write permission
for it.
If you are running X under _x_d_m on the console screen you may
need to have the session startup and reset programs explicitly change the
ownership of the console device in order to get this option to work.
-
-S_c_c_n
-
This option allows _x_t_e_r_m to be used as an input and
output channel for an existing program and is sometimes used in specialized
applications.
The option value specifies the last few letters of the name of a pseudo-terminal
to use in slave mode, plus the number of the inherited file descriptor.
If the option contains a ``/'' character, that delimits the characters
used for the pseudo-terminal name from the file descriptor.
Otherwise, exactly two characters are used from the option for
the pseudo-terminal name, the remainder is the file descriptor.
Examples:
-S123/45
-Sab34
-
Note that _x_t_e_r_m does not close any file descriptor
-
which it did not open for its own use.
It is possible (though probably not portable) to have an application
which passes an open file descriptor down to _x_t_e_r_m past the
initialization or the --SS option to a process running in the _x_t_e_r_m.
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.
-
%_g_e_o_m
-
This option specifies the preferred size and position of the Tektronix window.
It is shorthand for specifying the ``_*_t_e_k_G_e_o_m_e_t_r_y'' resource.
-
#_g_e_o_m
-
This option specifies the preferred position of the icon window.
It is shorthand for specifying the ``_*_i_c_o_n_G_e_o_m_e_t_r_y'' resource.
-
-T string
-
This option specifies the title for _x_t_e_r_m's windows.
It is equivalent to --ttiittllee.
-
-n string
-
This option specifies the icon name for _x_t_e_r_m's windows.
It is shorthand for specifying the ``_*_i_c_o_n_N_a_m_e'' resource.
Note that this is not the same as the toolkit option --nnaammee (see below).
The default icon name is the application name.
-
-r
-
This option indicates that reverse video should be simulated by swapping
the foreground and background colors.
It is equivalent to
--rrvv.
-
-w number
-
This option specifies the width in pixels of the border surrounding the window.
It is equivalent to --bboorrddeerrwwiiddtthh or --bbww.
The following standard X Toolkit command line arguments are commonly used
with _x_t_e_r_m:
-
-bd _c_o_l_o_r
-
This option specifies the color to use for the border of the window.
The default is ``black.''
-
-bg _c_o_l_o_r
-
This option specifies the color to use for the background of the window.
The default is ``white.''
-
-bw _n_u_m_b_e_r
-
This option specifies the width in pixels of the border surrounding the window.
-
-display _d_i_s_p_l_a_y
-
This option specifies the X server to contact; see _X_(_7_).
-
-fg _c_o_l_o_r
-
This option specifies the color to use for displaying text.
The default is
``black.''
-
-fn _f_o_n_t
-
This option specifies the font to be used for displaying normal text.
The
default is _f_i_x_e_d.
-
-font _f_o_n_t
-
This is the same as --ffnn.
-
-geometry _g_e_o_m_e_t_r_y
-
This option specifies the preferred size and position of the VT102 window;
see _X_(_7_).
-
-iconic
-
This option indicates that _x_t_e_r_m should ask the window manager to
start it as an icon rather than as the normal window.
-
-name _n_a_m_e
-
This option specifies the application name under which resources are to be
obtained, rather than the default executable file name.
_N_a_m_e should not contain ``.'' or ``*'' characters.
-
-rv
-
This option indicates that reverse video should be simulated by swapping
the foreground and background colors.
-
+rv
-
Disable the simulation of reverse video by swapping foreground and background
colors.
-
-title _s_t_r_i_n_g
-
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 --ee option, if any, otherwise the application
name.
-
-xrm _r_e_s_o_u_r_c_e_s_t_r_i_n_g
-
This option specifies a resource string to be used.
This is especially
useful for setting resources that do not have separate command line options.
RESOURCES
The program understands all of the core X Toolkit resource names and classes.
Application specific resources (e.g., "XXTTeerrmm.._N_A_M_E") follow:
-
backarrowKeyIsErase (_c_l_a_s_s BBaacckkaarrrroowwKKeeyyIIssEErraassee))</bb>>
<>
TTiiee tthhee VVTTxxxxxx bbaacckkaarrrroowwKKeeyy aanndd ppttyyIInniittiiaallEErraassee rreessoouurrcceess
ttooggeetthheerr bbyy sseettttiinngg tthhee DDEECCBBKKMM ssttaattee aaccccoorrddiinngg ttoo wwhheetthheerr tthhee iinniittiiaall vvaalluuee ooff
ssttttyy eerraassee iiss aa bbaacckkssppaaccee ((88)) oorr ddeelleettee ((112277)) cchhaarraacctteerr..
TThhee ddeeffaauulltt iiss ````ffaallssee'''',, wwhhiicchh ddiissaabblleess tthhiiss ffeeaattuurree..
<>
<>hhoolldd ((ccllaassss HHoolldd))</bb>>
<>
IIff ttrruuee,,
_x_t_e_r_m wwiillll nnoott iimmmmeeddiiaatteellyy ddeessttrrooyy iittss wwiinnddooww wwhheenn tthhee sshheellll ccoommmmaanndd ccoommpplleetteess..
IItt wwiillll wwaaiitt uunnttiill yyoouu uussee tthhee wwiinnddooww mmaannaaggeerr ttoo ddeessttrrooyy//kkiillll tthhee wwiinnddooww,, oorr
iiff yyoouu uussee tthhee mmeennuu eennttrriieess tthhaatt sseenndd aa ssiiggnnaall,, ee..gg..,, HHUUPP oorr KKIILLLL..
YYoouu mmaayy ssccrroollll bbaacckk,, sseelleecctt tteexxtt,, eettcc..,, ttoo ppeerrffoorrmm mmoosstt ggrraapphhiiccaall ooppeerraattiioonnss..
RReessiizziinngg tthhee ddiissppllaayy wwiillll lloossee ddaattaa,, hhoowweevveerr,, ssiinnccee tthhiiss iinnvvoollvveess iinntteerraaccttiioonn
wwiitthh tthhee sshheellll wwhhiicchh iiss nnoo lloonnggeerr rruunnnniinngg..
<>
<>hhppFFuunnccttiioonnKKeeyyss ((_c_l_a_s_s HHppFFuunnccttiioonnKKeeyyss))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott HHPP FFuunnccttiioonn KKeeyy eessccaappee ccooddeess sshhoouulldd bbee ggeenneerraatteedd ffoorr
ffuunnccttiioonn kkeeyyss iinnsstteeaadd ooff ssttaannddaarrdd eessccaappee sseeqquueenncceess..
<>
<>iiccoonnGGeeoommeettrryy ((_c_l_a_s_s IIccoonnGGeeoommeettrryy))</bb>>
<>
SSppeecciiffiieess tthhee pprreeffeerrrreedd ssiizzee aanndd ppoossiittiioonn ooff tthhee aapppplliiccaattiioonn wwhheenn iiccoonniiffiieedd..
IItt iiss nnoott nneecceessssaarriillyy oobbeeyyeedd bbyy aallll wwiinnddooww mmaannaaggeerrss..
<>
<>iiccoonnNNaammee ((_c_l_a_s_s IIccoonnNNaammee))</bb>>
<>
SSppeecciiffiieess tthhee iiccoonn nnaammee..
TThhee ddeeffaauulltt iiss tthhee aapppplliiccaattiioonn nnaammee..
<>
<>mmeessssaaggeess ((_c_l_a_s_s MMeessssaaggeess))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr wwrriittee aacccceessss ttoo tthhee tteerrmmiinnaall iiss aalllloowweedd iinniittiiaallllyy..
SSeeee
<>mmeessgg((11))</aa>>
TThhee ddeeffaauulltt iiss ````ttrruuee''''..
<>
<>ppttyyHHaannddsshhaakkee ((_c_l_a_s_sPPttyyHHaannddsshhaakkee))</bb>>
<>
IIff ````ttrruuee'''',, _x_t_e_r_m wwiillll ppeerrffoorrmm hhaannddsshhaakkiinngg dduurriinngg iinniittiiaalliizzaattiioonn
ttoo eennssuurree tthhaatt tthhee ppaarreenntt aanndd cchhiilldd pprroocceesssseess uuppddaattee tthhee uuttmmpp
aanndd ssttttyy ssttaattee..
PPllaattffoorrmmss wwiitthh nneewweerr ppsseeuuddoo--tteerrmmiinnaall iinntteerrffaacceess ddoo nnoott rreeqquuiirree tthhiiss ffeeaattuurree;;
nnoorrmmaallllyy iitt iiss nnoott ccoonnffiigguurreedd..
TThhee ddeeffaauulltt iiss ````ttrruuee''''..
<>
<>ppttyyIInniittiiaallEErraassee ((ccllaassss PPttyyIInniittiiaallEErraassee))</bb>>
<>
IIff ````ttrruuee'''',, _x_t_e_r_m wwiillll uussee tthhee ppsseeuuddoo--tteerrmmiinnaall''ss sseennssee ooff tthhee ssttttyy eerraassee
vvaalluuee..
IIff ````ffaallssee'''',, _x_t_e_r_m wwiillll sseett tthhee ssttttyy eerraassee vvaalluuee ttoo mmaattcchh iittss oowwnn
ccoonnffiigguurraattiioonn,, uussiinngg tthhee kkbb ssttrriinngg ffrroomm tthhee tteerrmmccaapp eennttrryy aass
aa rreeffeerreennccee,, iiff aavvaaiillaabbllee..
IInn eeiitthheerr ccaassee,, tthhee rreessuulltt iiss aapppplliieedd ttoo tthhee TTEERRMMCCAAPP vvaarriiaabbllee
wwhhiicchh _x_t_e_r_m sseettss..
TThhee ddeeffaauulltt iiss ````ffaallssee''''..
<>
<>ssaammeeNNaammee ((_c_l_a_s_s SSaammeeNNaammee))</bb>>
<>
IIff tthhee vvaalluuee ooff tthhiiss rreessoouurrccee iiss ````ttrruuee'''',, _x_t_e_r_m ddooeess nnoott sseenndd
ttiittllee aanndd iiccoonn nnaammee cchhaannggee rreeqquueessttss wwhheenn tthhee rreeqquueesstt
wwoouulldd hhaavvee nnoo eeffffeecctt:: tthhee nnaammee iiss nnoott cchhaannggeedd..
TThhiiss hhaass tthhee aaddvvaannttaaggee
ooff pprreevveennttiinngg fflliicckkeerr aanndd tthhee ddiissaaddvvaannttaaggee ooff rreeqquuiirriinngg aann eexxttrraa
rroouunndd ttrriipp ttoo tthhee sseerrvveerr ttoo ffiinndd oouutt tthhee pprreevviioouuss vvaalluuee..
IInn pprraaccttiiccee
tthhiiss sshhoouulldd nneevveerr bbee aa pprroobblleemm..
TThhee ddeeffaauulltt iiss ````ttrruuee''''..
<>
<>ssccooFFuunnccttiioonnKKeeyyss ((_c_l_a_s_s SSccooFFuunnccttiioonnKKeeyyss))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott SSCCPP FFuunnccttiioonn KKeeyy eessccaappee ccooddeess sshhoouulldd bbee ggeenneerraatteedd ffoorr
ffuunnccttiioonn kkeeyyss iinnsstteeaadd ooff ssttaannddaarrdd eessccaappee sseeqquueenncceess..
<>
<>sseessssiioonnMMggtt ((_c_l_a_s_s SSeessssiioonnMMggtt))</bb>>
<>
IIff tthhee vvaalluuee ooff tthhiiss rreessoouurrccee iiss ````ttrruuee'''',,
_x_t_e_r_m sseettss uupp sseessssiioonn mmaannaaggeerr ccaallllbbaacckkss
ffoorr XXttNNddiieeCCaallllbbaacckk and XXttNNssaavveeCCaallllbbaacckk.
The default is ``true''.
-
sunFunctionKeys (ccllaassss SSuunnFFuunnccttiioonnKKeeyyss))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott SSuunn FFuunnccttiioonn KKeeyy eessccaappee ccooddeess sshhoouulldd bbee ggeenneerraatteedd ffoorr
ffuunnccttiioonn kkeeyyss iinnsstteeaadd ooff ssttaannddaarrdd eessccaappee sseeqquueenncceess..
<>
<>ssuunnKKeeyybbooaarrdd ((ccllaassss SSuunnKKeeyybbooaarrdd))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott SSuunn//PPCC kkeeyybbooaarrdd llaayyoouutt sshhoouulldd bbee aassssuummeedd rraatthheerr
tthhaann DDEECC VVTT222200..
TThhiiss ccaauusseess tthhee kkeeyyppaadd ``++'' ttoo bbee mmaappppeedd ttoo ``,,''..
aanndd
CCTTRRLL FF11--FF1122 ttoo FF1111--FF2200,, ddeeppeennddiinngg oonn tthhee sseettttiinngg ooff tthhee ccttrrllFFKKeeyyss
rreessoouurrccee..
ssoo _x_t_e_r_m eemmuullaatteess aa DDEECC VVTT222200 mmoorree aaccccuurraatteellyy..
OOtthheerrwwiissee ((tthhee ddeeffaauulltt,, wwiitthh ssuunnKKeeyybbooaarrdd sseett ttoo ````ffaallssee'''')),,
_x_t_e_r_m uusseess PPCC--ssttyyllee bbiinnddiinnggss ffoorr tthhee ffuunnccttiioonn kkeeyyss aanndd kkeeyyppaadd..
<>
<></bb>>
PPCC--ssttyyllee bbiinnddiinnggss
<>
uussee tthhee SShhiifftt,, AAlltt,, CCoonnttrrooll aanndd MMeettaa kkeeyyss aass mmooddiiffiieerrss ffoorr ffuunnccttiioonn--kkeeyyss
aanndd kkeeyyppaadd
((sseeee tthhee ddooccuummeenntt _X_t_e_r_m _C_o_n_t_r_o_l _S_e_q_u_e_n_c_e_s ffoorr ddeettaaiillss))..
TThhee PPCC--ssttyyllee bbiinnddiinnggss aarree aannaallooggoouuss ttoo PPCCTTeerrmm,, bbuutt nnoott tthhee ssaammee tthhiinngg..
NNoorrmmaallllyy tthheessee bbiinnddiinnggss ddoo nnoott ccoonnfflliicctt wwiitthh tthhee uussee ooff tthhee MMeettaa kkeeyy
aass ddeessccrriibbeedd ffoorr tthhee eeiigghhttBBiittIInnppuutt rreessoouurrccee..
IIff tthheeyy ddoo,, nnoottee tthhaatt tthhee PPCC--ssttyyllee bbiinnddiinnggss aarree eevvaalluuaatteedd ffiirrsstt..
<>
<>tteerrmmNNaammee ((ccllaassss TTeerrmmNNaammee))</bb>>
<>
SSppeecciiffiieess tthhee tteerrmmiinnaall ttyyppee nnaammee ttoo bbee sseett iinn tthhee TTEERRMM eennvviirroonnmmeenntt vvaarriiaabbllee..
<>
<>ttiittllee ((ccllaassss TTiittllee))</bb>>
<>
SSppeecciiffiieess aa ssttrriinngg tthhaatt mmaayy bbee uusseedd bbyy tthhee wwiinnddooww mmaannaaggeerr wwhheenn ddiissppllaayyiinngg
tthhiiss aapppplliiccaattiioonn..
<>
<>ttttyyMMooddeess ((ccllaassss TTttyyMMooddeess))</bb>>
<>
SSppeecciiffiieess aa ssttrriinngg ccoonnttaaiinniinngg tteerrmmiinnaall sseettttiinngg kkeeyywwoorrddss aanndd tthhee cchhaarraacctteerrss
ttoo wwhhiicchh tthheeyy mmaayy bbee bboouunndd..
AAlllloowwaabbllee kkeeyywwoorrddss iinncclluuddee::
bbrrkk,,
ddssuusspp,,
eeooff,,
eeooll,,
eeooll22,,
eerraassee,,
eerraassee22,,
fflluusshh,,
iinnttrr,,
kkiillll,,
llnneexxtt,,
qquuiitt,,
rrpprrnntt,,
ssttaarrtt,,
ssttaattuuss,,
ssttoopp,,
ssuusspp,,
sswwttcchh aanndd
wweerraass..
CCoonnttrrooll cchhaarraacctteerrss mmaayy bbee ssppeecciiffiieedd aass ^^cchhaarr ((ee..gg..,, ^^cc oorr ^^uu))
aanndd ^^?? mmaayy bbee uusseedd ttoo iinnddiiccaattee ddeelleettee ((112277))..
UUssee ^^-- ttoo ddeennoottee _u_n_d_e_f..
UUssee \\003344 ttoo rreepprreesseenntt ^^\\,, ssiinnccee aa lliitteerraall bbaacckkssllaasshh iinn
aann XX rreessoouurrccee eessccaappeess tthhee nneexxtt cchhaarraacctteerr..
<>
<></bb>>
TThhiiss iiss vveerryy uusseeffuull ffoorr oovveerrrriiddiinngg
<>
tthhee ddeeffaauulltt tteerrmmiinnaall sseettttiinnggss wwiitthhoouutt hhaavviinngg ttoo ddoo aann _s_t_t_y eevveerryy ttiimmee
aann _x_t_e_r_m iiss ssttaarrtteedd..
NNoottee,, hhoowweevveerr,, tthhaatt tthhee ssttttyy pprrooggrraamm oonn aa ggiivveenn hhoosstt mmaayy uussee ddiiffffeerreenntt
kkeeyywwoorrddss;; _x_t_e_r_m's table is built-in.
-
useInsertMode (_c_l_a_s_s UUsseeIInnsseerrttMMooddee))</bb>>
<>
FFoorrccee uussee ooff iinnsseerrtt mmooddee bbyy aaddddiinngg aapppprroopprriiaattee eennttrriieess ttoo tthhee TTEERRMMCCAAPP
eennvviirroonnmmeenntt vvaarriiaabbllee..
TThhiiss iiss uusseeffuull iiff tthhee ssyysstteemm tteerrmmccaapp iiss bbrrookkeenn..
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>uuttmmppDDiissppllaayyIIdd ((_c_l_a_s_s UUttmmppDDiissppllaayyIIdd))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott _x_t_e_r_m sshhoouulldd ttrryy ttoo rreeccoorrdd tthhee ddiissppllaayy
iiddeennttiiffiieerr ((ddiissppllaayy nnuummbbeerr aanndd ssccrreeeenn nnuummbbeerr)) aass wweellll aass tthhee hhoossttnnaammee iinn
tthhee ssyysstteemm _u_t_m_p lloogg ffiillee..
TThhee ddeeffaauulltt iiss ````ttrruuee..''''
<>
<>uuttmmppIInnhhiibbiitt ((_c_l_a_s_s UUttmmppIInnhhiibbiitt))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott _x_t_e_r_m sshhoouulldd ttrryy ttoo rreeccoorrdd tthhee uusseerr''ss tteerrmmiinnaall
iinn
tthhee ssyysstteemm _u_t_m_p lloogg ffiillee..
IIff ttrruuee,, _x_t_e_r_m wwiillll nnoott ttrryy..
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>wwaaiittFFoorrMMaapp ((_c_l_a_s_s WWaaiittFFoorrMMaapp))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott _x_t_e_r_m sshhoouulldd wwaaiitt ffoorr tthhee iinniittiiaall wwiinnddooww mmaapp
bbeeffoorree ssttaarrttiinngg tthhee ssuubbpprroocceessss..
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>zzIIccoonnBBeeeepp ((_c_l_a_s_s ZZIIccoonnBBeeeepp))</bb>>
<>
SSaammee aass --zziiccoonnbbeeeepp ccoommmmaanndd lliinnee aarrgguummeenntt..
IIff tthhee vvaalluuee ooff tthhiiss rreessoouurrccee iiss nnoonn--zzeerroo,, xxtteerrmmss tthhaatt pprroodduuccee oouuttppuutt
wwhhiillee iiccoonniiffiieedd wwiillll ccaauussee aann XXBBeellll ssoouunndd aatt tthhee ggiivveenn vvoolluummee
aanndd hhaavvee ""******"" pprreeppeennddeedd ttoo tthheeiirr iiccoonn ttiittlleess..
MMoosstt wwiinnddooww mmaannaaggeerrss wwiillll ddeetteecctt tthhiiss cchhaannggee iimmmmeeddiiaatteellyy,, sshhoowwiinngg yyoouu
wwhhiicchh wwiinnddooww hhaass tthhee oouuttppuutt..
((AA ssiimmiillaarr ffeeaattuurree wwaass iinn xx1100 _x_t_e_r_m.)
The default is ``false.''
The following resources are specified as part
of the _v_t_1_0_0 widget (class _V_T_1_0_0):
These are specified by patterns such as "XXTTeerrmm..vvtt110000.._N_A_M_E":
-
activeIcon (_c_l_a_s_s AAccttiivveeIIccoonn))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott aaccttiivvee iiccoonn wwiinnddoowwss aarree ttoo bbee uusseedd wwhheenn tthhee
_x_t_e_r_m wwiinnddooww iiss iiccoonniiffiieedd,, iiff tthhiiss ffeeaattuurree iiss ccoommppiilleedd iinnttoo _x_t_e_r_m.
The active icon is a miniature representation of the content of the
window and will update as the content changes.
Not all window managers
necessarily support application icon windows.
Some window managers
will allow you to enter keystrokes into the active icon window.
The default is ``false.''
-
allowC1Printable (_c_l_a_s_s AAlllloowwCC11PPrriinnttaabbllee))</bb>>
<>
IIff ttrruuee,, oovveerrrriiddeess tthhee mmaappppiinngg ooff CC11 ccoonnttrroollss
((ccooddeess 112288--115599)) ttoo mmaakkee tthheemm bbee ttrreeaatteedd
aass iiff tthheeyy wweerree pprriinnttaabbllee cchhaarraacctteerrss..
AAlltthhoouugghh tthhiiss ccoorrrreessppoonnddss ttoo nnoo ppaarrttiiccuullaarr ssttaannddaarrdd,,
ssoommee uusseerrss iinnssiisstt iitt iiss aa VVTT110000..
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>aalllloowwSSeennddEEvveennttss ((_c_l_a_s_s AAlllloowwSSeennddEEvveennttss))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott ssyynntthheettiicc kkeeyy aanndd bbuuttttoonn eevveennttss ((ggeenneerraatteedd uussiinngg
tthhee XX pprroottooccooll SSeennddEEvveenntt rreeqquueesstt)) sshhoouulldd bbee iinntteerrpprreetteedd oorr ddiissccaarrddeedd..
TThhee ddeeffaauulltt iiss ````ffaallssee'''' mmeeaanniinngg tthheeyy aarree ddiissccaarrddeedd..
NNoottee tthhaatt aalllloowwiinngg
ssuucchh eevveennttss ccrreeaatteess aa vveerryy llaarrggee sseeccuurriittyy hhoollee..
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>aalllloowwWWiinnddoowwOOppss ((_c_l_a_s_s AAlllloowwWWiinnddoowwOOppss))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr eexxtteennddeedd wwiinnddooww ccoonnttrrooll sseeqquueenncceess ((aass uusseedd iinn ddtttteerrmm))
ffoorr sshhoouulldd bbee aalllloowweedd..
TThhee ddeeffaauulltt iiss ````ttrruuee..''''
<>
<>aallwwaayyssHHiigghhlliigghhtt ((_c_l_a_s_s AAllwwaayyssHHiigghhlliigghhtt))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott _x_t_e_r_m sshhoouulldd aallwwaayyss ddiissppllaayy aa hhiigghhlliigghhtteedd
tteexxtt ccuurrssoorr..
BByy ddeeffaauulltt ((iiff tthhiiss rreessoouurrccee iiss ffaallssee)),,
aa hhoollllooww tteexxtt ccuurrssoorr iiss ddiissppllaayyeedd wwhheenneevveerr tthhee
ppooiinntteerr mmoovveess oouutt ooff tthhee wwiinnddooww oorr tthhee wwiinnddooww lloosseess tthhee iinnppuutt ffooccuuss..
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>aallwwaayyssUUsseeMMooddss ((_c_l_a_s_s AAllwwaayyssUUsseeMMooddss))</bb>>
<>
OOvveerrrriiddee tthhee nnuummLLoocckk rreessoouurrccee,, tteelllliinngg _x_t_e_r_m to use the Alt and Meta
modifiers to construct parameters for function key sequences even if
those modifiers appear in the translations resource.
The default is ``false.''
-
answerbackString (_c_l_a_s_s AAnnsswweerrbbaacckkSSttrriinngg))</bb>>
<>
SSppeecciiffiieess tthhee ssttrriinngg tthhaatt _x_t_e_r_m sends in response to an ENQ (control/E)
character from the host.
The default is a blank string, i.e., ``''.
A hardware VT100 implements this feature as a setup option.
-
appcursorDefault (_c_l_a_s_s AAppppccuurrssoorrDDeeffaauulltt))</bb>>
<>
IIff ````ttrruuee,,'''' tthhee ccuurrssoorr kkeeyyss aarree iinniittiiaallllyy iinn aapppplliiccaattiioonn mmooddee..
TThhiiss iiss tthhee ssaammee aass tthhee VVTT110022 pprriivvaattee DDEECCCCKKMM mmooddee,,
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>aappppkkeeyyppaaddDDeeffaauulltt ((_c_l_a_s_s AAppppkkeeyyppaaddDDeeffaauulltt))</bb>>
<>
IIff ````ttrruuee,,'''' tthhee kkeeyyppaadd kkeeyyss aarree iinniittiiaallllyy iinn aapppplliiccaattiioonn mmooddee..
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>aauuttooWWrraapp ((_c_l_a_s_s AAuuttooWWrraapp))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott aauuttoo--wwrraappaarroouunndd sshhoouulldd bbee eennaabblleedd..
TThhiiss iiss tthhee ssaammee aass tthhee VVTT110022 DDEECCAAWWMM..
TThhee
ddeeffaauulltt iiss ````ttrruuee..''''
<>
<>aawwaaiittIInnppuutt ((_c_l_a_s_s AAwwaaiittIInnppuutt))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott tthhee _x_t_e_r_m uses a 50 millisecond timeout to
await input (i.e., to support the Xaw3d arrow scrollbar).
The default is ``false.''
-
backarrowKey (_c_l_a_s_s BBaacckkaarrrroowwKKeeyy))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr tthhee bbaacckkaarrrrooww kkeeyy ttrraannssmmiittss
aa bbaacckkssppaaccee ((88))
oorr ddeelleettee ((112277)) cchhaarraacctteerr..
TThhiiss ccoorrrreessppoonnddss ttoo tthhee DDEECCBBKKMM ccoonnttrrooll sseeqquueennccee..
TThhee ddeeffaauulltt ((bbaacckkssppaaccee)) iiss ````ttrruuee..''''
PPrreessssiinngg tthhee ccoonnttrrooll kkeeyy ttoogggglleess tthhiiss bbeehhaavviioorr..
<>
<>bbaacckkggrroouunndd ((_c_l_a_s_s BBaacckkggrroouunndd))</bb>>
<>
SSppeecciiffiieess tthhee ccoolloorr ttoo uussee ffoorr tthhee bbaacckkggrroouunndd ooff tthhee wwiinnddooww..
TThhee ddeeffaauulltt iiss
````wwhhiittee..''''
<>
<>bbeellllOOnnRReesseett ((_c_l_a_s_s BBeellllOOnnRReesseett))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr ttoo ssoouunndd aa bbeellll wwhheenn ddooiinngg aa hhaarrdd rreesseett..
TThhee ddeeffaauulltt iiss ````ttrruuee..''''
<>
<>bbeellllSSuupppprreessssTTiimmee ((_c_l_a_s_s BBeellllSSuupppprreessssTTiimmee))</bb>>
<>
NNuummbbeerr ooff mmiilllliisseeccoonnddss aafftteerr aa bbeellll ccoommmmaanndd iiss sseenntt dduurriinngg wwhhiicchh aaddddiittiioonnaall
bbeellllss wwiillll bbee ssuupppprreesssseedd..
DDeeffaauulltt iiss 220000..
IIff sseett nnoonn--zzeerroo,,
aaddddiittiioonnaall bbeellllss
wwiillll aallssoo bbee ssuupppprreesssseedd uunnttiill tthhee sseerrvveerr rreeppoorrttss tthhaatt pprroocceessssiinngg ooff
tthhee ffiirrsstt bbeellll hhaass bbeeeenn ccoommpplleetteedd;; tthhiiss ffeeaattuurree iiss mmoosstt uusseeffuull wwiitthh
tthhee vviissiibbllee bbeellll..
<>
<>bboollddCCoolloorrss ((_c_l_a_s_s CCoolloorrMMooddee))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr ttoo ccoommbbiinnee bboolldd aattttrriibbuuttee wwiitthh ccoolloorrss lliikkee tthhee IIBBMM PPCC,,
ii..ee..,, mmaapp ccoolloorrss 00 tthhrroouugghh 77 ttoo ccoolloorrss 88 tthhrroouugghh 1155..
TThheessee nnoorrmmaallllyy aarree tthhee bbrriigghhtteerr vveerrssiioonnss ooff tthhee ffiirrsstt 88 ccoolloorrss,, hheennccee bboolldd..
TThhee ddeeffaauulltt iiss ````ttrruuee..''''
<>
<>bboollddFFoonntt ((_c_l_a_s_s BBoollddFFoonntt))</bb>>
<>
SSppeecciiffiieess tthhee nnaammee ooff tthhee bboolldd ffoonntt ttoo uussee iinnsstteeaadd ooff oovveerrssttrriikkiinngg..
TThheerree iiss nnoo ddeeffaauulltt ffoorr tthhiiss rreessoouurrccee..
<>
<>bboollddMMooddee ((_c_l_a_s_s BBoollddMMooddee))</bb>>
<>
TThhiiss ssppeecciiffiieess wwhheetthheerr oorr nnoott tteexxtt wwiitthh tthhee bboolldd aattttrriibbuuttee sshhoouulldd bbee
oovveerrssttrruucckk ttoo ssiimmuullaattee bboolldd ffoonnttss iiff tthhee rreessoollvveedd bboolldd ffoonntt iiss tthhee
ssaammee aass tthhee nnoorrmmaall ffoonntt..
IItt mmaayy bbee ddeessiirraabbllee ttoo ddiissaabbllee bboolldd ffoonnttss wwhheenn ccoolloorr iiss bbeeiinngg
uusseedd ffoorr tthhee bboolldd aattttrriibbuuttee..
NNoottee tthhaatt _x_t_e_r_m hhaass oonnee bboolldd ffoonntt wwhhiicchh yyoouu mmaayy sseett eexxpplliicciittllyy..
IItt aatttteemmppttss ttoo mmaattcchh aa bboolldd ffoonntt ffoorr tthhee ootthheerr ffoonntt sseelleeccttiioonnss
((ffoonntt11 tthhrroouugghh ffoonntt66))..
IIff tthhee nnoorrmmaall aanndd bboolldd ffoonnttss aarree ddiissttiinncctt,, tthhiiss rreessoouurrccee hhaass nnoo eeffffeecctt..
TThhee ddeeffaauulltt iiss ````ttrruuee..''''
<>
<></bb>>
AAlltthhoouugghh _x_t_e_r_m aatttteemmppttss ttoo mmaattcchh aa bboolldd ffoonntt ffoorr ootthheerr ffoonntt sseelleeccttiioonnss,,
<>
tthhee ffoonntt sseerrvveerr mmaayy nnoott ccooooppeerraattee..
SSiinnccee XX1111RR66,, bbiittmmaapp ffoonnttss hhaavvee bbeeeenn ssccaalleedd..
TThhee ffoonntt sseerrvveerr ccllaaiimmss ttoo pprroovviiddee tthhee bboolldd ffoonntt tthhaatt _x_t_e_r_m rreeqquueessttss,,
bbuutt tthhee rreessuulltt iiss nnoott aallwwaayyss rreeaaddaabbllee..
XXFFrreeee8866 pprroovviiddeess aa ffeeaattuurree wwhhiicchh ccaann bbee uusseedd ttoo ssuupppprreessss tthhee ssccaalliinngg..
IInn tthhee XX sseerrvveerr''ss ccoonnffiigguurraattiioonn ffiillee ((ee..gg..,, ""//eettcc//XX1111//XXFFrreeee8866"")),, yyoouu
ccaann aadddd ""::uunnssccaalleedd"" ttoo tthhee eenndd ooff tthhee ddiirreeccttoorryy ssppeecciiffiiccaattiioonn ffoorr tthhee
""mmiisscc"" ffoonnttss,, wwhhiicchh ccoommpprriissee tthhee ffiixxeedd--ppiittcchh ffoonnttss tthhaatt aarree uusseedd bbyy _x_t_e_r_m..
FFoorr eexxaammppllee
FFoonnttPPaatthh ""//uussrr//lliibb//XX1111//ffoonnttss//mmiisscc//""
<>
<></bb>>
wwoouulldd bbeeccoommee
<>
FFoonnttPPaatthh ""//uussrr//lliibb//XX1111//ffoonnttss//mmiisscc//::uunnssccaalleedd""
<>
<></bb>>
DDeeppeennddiinngg oonn yyoouurr ccoonnffiigguurraattiioonn,, tthhee ffoonntt sseerrvveerr mmaayy hhaavvee iittss oowwnn ccoonnffiigguurraattiioonn
<>
ffiillee..
TThhee ssaammee ""::uunnssccaalleedd"" ccaann bbee aaddddeedd ttoo iittss ccoonnffiigguurraattiioonn ffiillee aatt tthhee
eenndd ooff tthhee ddiirreeccttoorryy ssppeecciiffiiccaattiioonn ffoorr ""mmiisscc""..
<>
<>bbrrookkeennLLiinnuuxxOOSSCC ((_c_l_a_s_s BBrrookkeennLLiinnuuxxOOSSCC))</bb>>
<>
IIff ttrruuee,, _x_t_e_r_m aapppplliieess aa wwoorrkkaarroouunndd ttoo iiggnnoorree mmaallffoorrmmeedd ccoonnttrrooll
sseeqquueenncceess tthhaatt aa LLiinnuuxx ssccrriipptt mmiigghhtt sseenndd..
CCoommppaarree tthhee ppaalleettttee ccoonnttrrooll sseeqquueenncceess ddooccuummeenntteedd iinn _c_o_n_s_o_l_e___c_o_d_e_s
with ECMA-48.
The default is ``true.''
-
brokenSelections (_c_l_a_s_s BBrrookkeennSSeelleeccttiioonnss))</bb>>
<>
IIff ttrruuee,, _x_t_e_r_m iinn 88--bbiitt mmooddee wwiillll iinntteerrpprreett
<>SSTTRRIINNGG</bb>>
sseelleeccttiioonnss aass ccaarrrryyiinngg tteexxtt iinn tthhee ccuurrrreenntt llooccaallee''ss eennccooddiinngg..
NNoorrmmaallllyy
<>SSTTRRIINNGG</bb>>
sseelleeccttiioonnss ccaarrrryy IISSOO--88885599--11 eennccooddeedd tteexxtt..
SSeettttiinngg tthhiiss rreessoouurrccee ttoo
````ttrruuee'''' vviioollaatteess tthhee IICCCCCCMM;; iitt mmaayy,, hhoowweevveerr,, bbee uusseeffuull ffoorr iinntteerraaccttiinngg
wwiitthh ssoommee bbrrookkeenn XX cclliieennttss..
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>bbrrookkeennSSttrriinnggTTeerrmm ((_c_l_a_s_s BBrrookkeennSSttrriinnggTTeerrmm))</bb>>
<>
pprroovviiddeess aa wwoorrkk--aarroouunndd ffoorr ssoommee IISSDDNN rroouutteerrss wwhhiicchh ssttaarrtt aann aapppplliiccaattiioonn
ccoonnttrrooll ssttrriinngg wwiitthhoouutt ccoommpplleettiinngg iitt..
SSeett tthhiiss ttoo ````ttrruuee'''' iiff _x_t_e_r_m aappppeeaarrss ttoo ffrreeeezzee wwhheenn ccoonnnneeccttiinngg..
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>cc113322 ((_c_l_a_s_s CC113322))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott tthhee VVTT110022 DDEECCCCOOLLMM eessccaappee sseeqquueennccee,,
uusseedd ttoo sswwiittcchh bbeettwweeeenn 8800 aanndd 113322 ccoolluummnnss,, sshhoouulldd bbee hhoonnoorreedd..
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>ccaacchheeDDoouubblleessiizzee ((_c_l_a_s_s CCaacchheeDDoouubblleessiizzee))</bb>>
<>
SSppeecciiffiieess tthhee mmaaxxiimmuumm nnuummbbeerr ooff ddoouubbllee--ssiizzeedd ffoonnttss wwhhiicchh aarree ccaacchheedd bbyy
_x_t_e_r_m.
The default (8) may be too large for some X terminals with limited memory.
Set this to zero to disable doublesize fonts altogether.
-
charClass (_c_l_a_s_s CChhaarrCCllaassss))</bb>>
<>
SSppeecciiffiieess ccoommmmaa--sseeppaarraatteedd lliissttss ooff cchhaarraacctteerr ccllaassss bbiinnddiinnggss ooff tthhee ffoorrmm
[[_l_o_w--]]_h_i_g_h::_v_a_l_u_e..
TThheessee aarree uusseedd iinn ddeetteerrmmiinniinngg wwhhiicchh
sseettss ooff cchhaarraacctteerrss sshhoouulldd bbee ttrreeaatteedd tthhee ssaammee wwhheenn ddooiinngg ccuutt aanndd ppaassttee..
SSeeee tthhee CCHHAARRAACCTTEERR CCLLAASSSSEESS sseeccttiioonn..
<>
<>ccjjkkWWiiddtthh ((_c_l_a_s_s CCjjkkWWiiddtthh))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr _x_t_e_r_m sshhoouulldd ffoollllooww
tthhee ttrraaddiittiioonnaall EEaasstt AAssiiaann wwiiddtthh ccoonnvveennttiioonn..
WWhheenn ttuurrnneedd oonn,, cchhaarraacctteerrss wwiitthh EEaasstt AAssiiaann AAmmbbiigguuoouuss ((AA)) ccaatteeggoorryy iinn UUTTRR
1111 hhaavvee aa ccoolluummnn wwiiddtthh ooff 22..
YYoouu mmaayy hhaavvee ttoo sseett tthhiiss ooppttiioonn ttoo ````ttrruuee''''
iiff yyoouu hhaavvee ssoommee oolldd EEaasstt AAssiiaann tteerrmmiinnaall bbaasseedd pprrooggrraammss tthhaatt aassssuummee tthhaatt
lliinnee--ddrraawwiinngg cchhaarraacctteerrss hhaavvee aa ccoolluummnn wwiiddtthh ooff 22..
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>ccoolloorr00 ((_c_l_a_s_s CCoolloorr00))</bb>>
<>
<>
<>ccoolloorr11 ((_c_l_a_s_s CCoolloorr11))</bb>>
<>
<>
<>ccoolloorr22 ((_c_l_a_s_s CCoolloorr22))</bb>>
<>
<>
<>ccoolloorr33 ((_c_l_a_s_s CCoolloorr33))</bb>>
<>
<>
<>ccoolloorr44 ((_c_l_a_s_s CCoolloorr44))</bb>>
<>
<>
<>ccoolloorr55 ((_c_l_a_s_s CCoolloorr55))</bb>>
<>
<>
<>ccoolloorr66 ((_c_l_a_s_s CCoolloorr66))</bb>>
<>
<>
<>ccoolloorr77 ((_c_l_a_s_s CCoolloorr77))</bb>>
<>
TThheessee ssppeecciiffyy tthhee ccoolloorrss ffoorr tthhee IISSOO 66442299 eexxtteennssiioonn..
TThhee ddeeffaauullttss aarree,,
rreessppeeccttiivveellyy,,
bbllaacckk,,
rreedd33,,
ggrreeeenn33,,
yyeellllooww33,,
aa ccuussttoommiizzaabbllee ddaarrkk bblluuee,,
mmaaggeennttaa33,,
ccyyaann33,,
aanndd
ggrraayy9900..
TThhee ddeeffaauulltt sshhaaddeess ooff ccoolloorr aarree cchhoosseenn ttoo aallllooww tthhee ccoolloorrss 88--1155
ttoo bbee uusseedd aass bbrriigghhtteerr vveerrssiioonnss..
<>
<>ccoolloorr88 ((_c_l_a_s_s CCoolloorr88))</bb>>
<>
<>
<>ccoolloorr99 ((_c_l_a_s_s CCoolloorr99))</bb>>
<>
<>
<>ccoolloorr1100 ((_c_l_a_s_s CCoolloorr1100))</bb>>
<>
<>
<>ccoolloorr1111 ((_c_l_a_s_s CCoolloorr1111))</bb>>
<>
<>
<>ccoolloorr1122 ((_c_l_a_s_s CCoolloorr1122))</bb>>
<>
<>
<>ccoolloorr1133 ((_c_l_a_s_s CCoolloorr1133))</bb>>
<>
<>
<>ccoolloorr1144 ((_c_l_a_s_s CCoolloorr1144))</bb>>
<>
<>
<>ccoolloorr1155 ((_c_l_a_s_s CCoolloorr1155))</bb>>
<>
TThheessee ssppeecciiffyy tthhee ccoolloorrss ffoorr tthhee IISSOO 66442299 eexxtteennssiioonn iiff tthhee bboolldd aattttrriibbuuttee
iiss aallssoo eennaabblleedd..
TThhee ddeeffaauulltt rreessoouurrccee vvaalluueess aarree rreessppeeccttiivveellyy,,
ggrraayy3300,,
rreedd,,
ggrreeeenn,,
yyeellllooww,,
aa ccuussttoommiizzaabbllee lliigghhtt bblluuee,,
mmaaggeennttaa,,
ccyyaann,,
aanndd
wwhhiittee..
<>
<>ccoolloorr1166 ((_c_l_a_s_s CCoolloorr1166))</bb>>
<>
<>
tthhrroouugghh
<>
<>
<>ccoolloorr225555 ((_c_l_a_s_s CCoolloorr225555))</bb>>
<>
TThheessee ssppeecciiffyy tthhee ccoolloorrss ffoorr tthhee 225566--ccoolloorr eexxtteennssiioonn..
TThhee ddeeffaauulltt rreessoouurrccee vvaalluueess
aarree ffoorr ccoolloorrss 1166 tthhrroouugghh 223311 ttoo mmaakkee aa 66xx66xx66 ccoolloorr ccuubbee,, aanndd ccoolloorrss
223322 tthhrroouugghh 225555 ttoo mmaakkee aa ggrraayyssccaallee rraammpp..
<>
<>ccoolloorrAAttttrrMMooddee ((_c_l_a_s_s CCoolloorrAAttttrrMMooddee))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr ````ccoolloorrBBDD'''',, ````ccoolloorrBBLL'''',, ````ccoolloorrUULL'''',, aanndd
````ccoolloorrRRVV'''' sshhoouulldd oovveerrrriiddee AANNSSII ccoolloorrss..
IIff nnoott,, tthheessee aarree ddiissppllaayyeedd oonnllyy wwhheenn nnoo AANNSSII ccoolloorrss
hhaavvee bbeeeenn sseett ffoorr tthhee ccoorrrreessppoonnddiinngg ppoossiittiioonn..
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>ccoolloorrBBDD ((_c_l_a_s_s CCoolloorrBBDD))</bb>>
<>
TThhiiss ssppeecciiffiieess tthhee ccoolloorr ttoo uussee ttoo ddiissppllaayy bboolldd cchhaarraacctteerrss iiff
tthhee ````ccoolloorrBBDDMMooddee'''' rreessoouurrccee iiss eennaabblleedd..
TThhee ddeeffaauulltt iiss ````XXttDDeeffaauullttFFoorreeggrroouunndd..''''
<>
<>ccoolloorrBBDDMMooddee ((_c_l_a_s_s CCoolloorrAAttttrrMMooddee))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr cchhaarraacctteerrss wwiitthh tthhee bboolldd aattttrriibbuuttee sshhoouulldd bbee ddiissppllaayyeedd iinn
ccoolloorr oorr aass bboolldd cchhaarraacctteerrss..
NNoottee tthhaatt sseettttiinngg ccoolloorrMMooddee off disables
all colors, including bold.
The default is ``false.''
-
colorBL (ccllaassss CCoolloorrBBLL))</bb>>
<>
TThhiiss ssppeecciiffiieess tthhee ccoolloorr ttoo uussee ttoo ddiissppllaayy bblliinnkk cchhaarraacctteerrss iiff
tthhee ````ccoolloorrBBLLMMooddee'''' rreessoouurrccee iiss eennaabblleedd..
TThhee ddeeffaauulltt iiss ````XXttDDeeffaauullttFFoorreeggrroouunndd..''''
<>
<>ccoolloorrBBLLMMooddee ((ccllaassss CCoolloorrAAttttrrMMooddee))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr cchhaarraacctteerrss wwiitthh tthhee bblliinnkk aattttrriibbuuttee sshhoouulldd bbee ddiissppllaayyeedd iinn
ccoolloorr..
NNoottee tthhaatt sseettttiinngg ccoolloorrMMooddee off disables all colors, including this.
The default is ``false.''
-
colorMode (ccllaassss CCoolloorrMMooddee))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott rreeccooggnniittiioonn ooff AANNSSII ((IISSOO 66442299))
ccoolloorr cchhaannggee eessccaappee sseeqquueenncceess sshhoouulldd bbee eennaabblleedd..
TThhee ddeeffaauulltt iiss ````ttrruuee..''''
<>
<>ccoolloorrRRVV ((ccllaassss CCoolloorrRRVV))</bb>>
<>
TThhiiss ssppeecciiffiieess tthhee ccoolloorr ttoo uussee ttoo ddiissppllaayy rreevveerrssee cchhaarraacctteerrss iiff
tthhee ````ccoolloorrRRVVMMooddee'''' rreessoouurrccee iiss eennaabblleedd..
TThhee ddeeffaauulltt iiss ````XXttDDeeffaauullttFFoorreeggrroouunndd..''''
<>
<>ccoolloorrRRVVMMooddee ((ccllaassss CCoolloorrAAttttrrMMooddee))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr cchhaarraacctteerrss wwiitthh tthhee rreevveerrssee aattttrriibbuuttee sshhoouulldd bbee ddiissppllaayyeedd iinn
ccoolloorr..
NNoottee tthhaatt sseettttiinngg ccoolloorrMMooddee off disables all colors, including this.
The default is ``false.''
-
colorUL (ccllaassss CCoolloorrUULL))</bb>>
<>
TThhiiss ssppeecciiffiieess tthhee ccoolloorr ttoo uussee ttoo ddiissppllaayy uunnddeerrlliinneedd cchhaarraacctteerrss iiff
tthhee ````ccoolloorrUULLMMooddee'''' rreessoouurrccee iiss eennaabblleedd..
TThhee ddeeffaauulltt iiss ````XXttDDeeffaauullttFFoorreeggrroouunndd..''''
<>
<>ccoolloorrUULLMMooddee ((ccllaassss CCoolloorrAAttttrrMMooddee))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr cchhaarraacctteerrss wwiitthh tthhee uunnddeerrlliinnee aattttrriibbuuttee sshhoouulldd bbee ddiissppllaayyeedd
iinn ccoolloorr oorr aass uunnddeerrlliinneedd cchhaarraacctteerrss..
NNoottee tthhaatt sseettttiinngg ccoolloorrMMooddee off
disables all colors, including underlining.
The default is ``false.''
-
ctrlFKeys (ccllaassss CCttrrllFFKKeeyyss))</bb>>
<>
IInn VVTT222200 kkeeyybbooaarrdd mmooddee ((sseeee ssuunnKKeeyybbooaarrdd rreessoouurrccee)),,
ssppeecciiffiieess tthhee aammoouunntt bbyy wwhhiicchh ttoo sshhiifftt FF11--FF1122 ggiivveenn aa ccoonnttrrooll mmooddiiffiieerr ((CCTTRRLL))..
TThhiiss aalllloowwss yyoouu ttoo ggeenneerraattee kkeeyy ssyymmbboollss ffoorr FF1100--FF2200 oonn aa SSuunn//PPCC kkeeyybbooaarrdd..
TThhee ddeeffaauulltt iiss ````1100'''',, wwhhiicchh mmeeaannss tthhaatt CCTTRRLL FF11 ggeenneerraatteess tthhee kkeeyy
ssyymmbbooll ffoorr FF1111..
<>
<>ccuurrsseess ((ccllaassss CCuurrsseess))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott tthhee llaasstt ccoolluummnn bbuugg iinn
<>mmoorree((11))</aa>>
sshhoouulldd bbee wwoorrkkeedd aarroouunndd..
SSeeee tthhee --ccuu ooppttiioonn ffoorr ddeettaaiillss..
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>ccuurrssoorrBBlliinnkk ((ccllaassss CCuurrssoorrBBlliinnkk))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr ttoo mmaakkee tthhee ccuurrssoorr bblliinnkk..
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>ccuurrssoorrCCoolloorr ((ccllaassss CCuurrssoorrCCoolloorr))</bb>>
<>
SSppeecciiffiieess tthhee ccoolloorr ttoo uussee ffoorr tthhee tteexxtt ccuurrssoorr..
TThhee ddeeffaauulltt iiss ````bbllaacckk..''''
<>
<>ccuurrssoorrOOffffTTiimmee ((ccllaassss CCuurrssoorrOOffffTTiimmee))</bb>>
<>
SSppeecciiffiieess tthhee dduurraattiioonn ooff tthhee ""ooffff"" ppaarrtt ooff tthhee ccuurrssoorr bblliinnkk ccyyccllee--ttiimmee
iinn mmiilllliisseeccoonnddss..
TThhee ssaammee ttiimmeerr iiss uusseedd ffoorr tteexxtt bblliinnkkiinngg..
TThhee ddeeffaauulltt iiss 330000..
<>
<>ccuurrssoorrOOnnTTiimmee ((ccllaassss CCuurrssoorrOOnnTTiimmee))</bb>>
<>
SSppeecciiffiieess tthhee dduurraattiioonn ooff tthhee ""oonn"" ppaarrtt ooff tthhee ccuurrssoorr bblliinnkk ccyyccllee--ttiimmee,,
iinn mmiilllliisseeccoonnddss..
TThhee ssaammee ttiimmeerr iiss uusseedd ffoorr tteexxtt bblliinnkkiinngg..
TThhee ddeeffaauulltt iiss 660000..
<>
<>ccuuttNNeewwlliinnee ((ccllaassss CCuuttNNeewwlliinnee))</bb>>
<>
IIff ````ffaallssee'''',, ttrriippllee cclliicckkiinngg ttoo sseelleecctt aa lliinnee ddooeess nnoott iinncclluuddee tthhee NNeewwlliinnee
aatt tthhee eenndd ooff tthhee lliinnee..
IIff ````ttrruuee'''',, tthhee NNeewwlliinnee iiss sseelleecctteedd..
TThhee ddeeffaauulltt iiss ````ttrruuee..''''
<>
<>ccuuttTTooBBeeggiinnnniinnggOOffLLiinnee ((ccllaassss CCuuttTTooBBeeggiinnnniinnggOOffLLiinnee))</bb>>
<>
IIff ````ffaallssee'''',, ttrriippllee cclliicckkiinngg ttoo sseelleecctt aa lliinnee sseelleeccttss oonnllyy ffrroomm tthhee
ccuurrrreenntt wwoorrdd ffoorrwwaarrdd..
IIff ````ttrruuee'''',, tthhee eennttiirree lliinnee iiss sseelleecctteedd..
TThhee ddeeffaauulltt iiss ````ttrruuee..''''
<>
<>ddeeccTTeerrmmiinnaallIIDD ((ccllaassss DDeeccTTeerrmmiinnaallIIDD))</bb>>
<>
SSppeecciiffiieess tthhee eemmuullaattiioonn lleevveell ((110000==VVTT110000,, 222200==VVTT222200,, eettcc..)),, uusseedd ttoo ddeetteerrmmiinnee
tthhee ttyyppee ooff rreessppoonnssee ttoo aa DDAA ccoonnttrrooll sseeqquueennccee..
LLeeaaddiinngg nnoonn--ddiiggiitt cchhaarraacctteerrss aarree iiggnnoorreedd,, ee..gg..,, ""vvtt110000"" aanndd ""110000"" aarree tthhee ssaammee..
TThhee ddeeffaauulltt iiss 110000..
<>
<>ddeelleetteeIIssDDEELL ((ccllaassss DDeelleetteeIIssDDEELL))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr tthhee DDeelleettee kkeeyy oonn tthhee eeddiittiinngg kkeeyyppaadd sshhoouulldd sseenndd DDEELL ((112277))
oorr tthhee VVTT222200--ssttyyllee RReemmoovvee eessccaappee sseeqquueennccee..
TThhee ddeeffaauulltt iiss ````ffaallssee,,'''' ffoorr tthhee llaatttteerr..
<>
<>ddyynnaammiiccCCoolloorrss ((ccllaassss DDyynnaammiiccCCoolloorrss))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott eessccaappee sseeqquueenncceess ttoo cchhaannggee ccoolloorrss aassssiiggnneedd ttoo
ddiiffffeerreenntt aattttrriibbuutteess aarree rreeccooggnniizzeedd..
<>
<>eeiigghhttBBiittCCoonnttrrooll ((ccllaassss EEiigghhttBBiittCCoonnttrrooll))</bb>>
<>
SSppeecciiffiieess wwhheetthheerr oorr nnoott ccoonnttrrooll sseeqquueenncceess sseenntt bbyy tthhee
tteerrmmiinnaall sshhoouulldd bbee eeiigghhtt--bbiitt cchhaarraacctteerrss oorr eessccaappee sseeqquueenncceess..
TThhee ddeeffaauulltt iiss ````ffaallssee..''''
<>
<>eeiigghhttBBiittIInnppuutt ((ccllaassss EEiigghhttBBiittIInnppuutt))</bb>>
<>
IIff ````ttrruuee'''',, MMeettaa cchhaarraacctteerrss
((aa cchhaarraacctteerr ccoommbbiinneedd wwiitthh tthhee _k_e_y_s mmooddiiffiieerr kkeeyy))
iinnppuutt ffrroomm tthhee kkeeyybbooaarrdd aarree pprreesseenntteedd aass aa
ssiinnggllee cchhaarraacctteerr wwiitthh tthhee eeiigghhtthh bbiitt ttuurrnneedd oonn..
TThhee tteerrmmiinnaall iiss ppuutt iinnttoo 88--bbiitt mmooddee..
IIff ````ffaallssee'''',, MMeettaa cchhaarraacctteerrss aarree ccoonnvveerrtteedd iinnttoo aa ttwwoo--cchhaarraacctteerr
sseeqquueennccee wwiitthh tthhee cchhaarraacctteerr iittsseellff pprreecceeddeedd bbyy EESSCC..
TThhee tteerrmmiinnaall iiss ppuutt iinnttoo 77--bbiitt mmooddee..
TThhee mmeettaaSSeennddssEEssccaappee rreessoouurrccee mmaayy oovveerrrriiddee tthhiiss..
TThhee ddeeffaauulltt iiss ````ttrruuee..''''
<>
<></bb>>
NNoottee tthhaatt tthhee _A_l_t kkeeyy iiss nnoott nneecceessssaarriillyy tthhee ssaammee aass tthhee
<>
_M_e_t_a mmooddiiffiieerr..
_x_m_o_d_m_a_p lliissttss yyoouurr kkeeyy mmooddiiffiieerrss..
XX ddeeffiinneess mmooddiiffiieerrss ffoorr sshhiifftt,, ((ccaappss)) lloocckk aanndd ccoonnttrrooll,,
aass wweellll aass 55 aaddddiittiioonnaall mmooddiiffiieerrss wwhhiicchh aarree ggeenneerraallllyy uusseedd ttoo ccoonnffiigguurree
kkeeyy mmooddiiffiieerrss..
_x_t_e_r_m iinnssppeeccttss tthhee ssaammee iinnffoorrmmaattiioonn ttoo ffiinndd tthhee mmooddiiffiieerr aassssoocciiaatteedd
wwiitthh eeiitthheerr _M_e_t_a kkeeyy ((lleefftt oorr rriigghhtt)),,
aanndd uusseess tthhaatt kkeeyy aass tthhee _M_e_t_a mmooddiiffiieerr..
IItt aallssoo llooookkss ffoorr tthhee NNuummLLoocckk kkeeyy,,
ttoo rreeccooggnniizzee tthhee mmooddiiffiieerr wwhhiicchh iiss aassssoocciiaatteedd wwiitthh tthhaatt..
<>
<></bb>>
IIff yyoouurr _x_m_o_d_m_a_p ccoonnffiigguurraattiioonn
<>
uusseess tthhee ssaammee kkeeyyccooddeess ffoorr AAlltt-- aanndd MMeettaa--kkeeyyss,,
_x_t_e_r_m wwiillll oonnllyy sseeee tthhee AAlltt--kkeeyy ddeeffiinniittiioonnss,, ssiinnccee tthhoossee aarree tteesstteedd
bbeeffoorree MMeettaa--kkeeyyss..
NNuummLLoocckk iiss tteesstteedd ffiirrsstt..
IItt iiss iimmppoorrttaanntt ttoo kkeeeepp tthheessee kkeeyyss ddiissttiinncctt;;
ootthheerrwwiissee ssoommee ooff _x_t_e_r_m''ss ffuunnccttiioonnaalliittyy iiss nnoott aavvaaiillaabbllee..
<>
<>eeiigghhttBBiittOOuuttppuutt ((_c_l_a_s_s EEiigghhttBBiittOOuuttppuutt_)_<_/_b_>
_<_d_d_>
_S_p_e_c_i_f_i_e_s _w_h_e_t_h_e_r _o_r _n_o_t _e_i_g_h_t_-_b_i_t _c_h_a_r_a_c_t_e_r_s _s_e_n_t _f_r_o_m _t_h_e _h_o_s_t _s_h_o_u_l_d _b_e
_a_c_c_e_p_t_e_d _a_s _i_s _o_r _s_t_r_i_p_p_e_d _w_h_e_n _p_r_i_n_t_e_d_.
_T_h_e _d_e_f_a_u_l_t _i_s _`_`_t_r_u_e_,_'_'
_w_h_i_c_h _m_e_a_n_s _t_h_a_t _t_h_e_y _a_r_e _a_c_c_e_p_t_e_d _a_s _i_s_.
_<_d_t_>
_<_b_>_f_a_c_e_N_a_m_e _(ccllaassss FFaacceeNNaammee))</bb>>
<>
SSppeecciiffyy tthhee ppaatttteerrnn ffoorr ffoonnttss sseelleecctteedd ffrroomm tthhee FFrreeeeTTyyppee
lliibbrraarryy iiff ssuuppppoorrtt ffoorr tthhaatt lliibbrraarryy wwaass ccoommppiilleedd iinnttoo _x_t_e_r_m.
There is no default.
If not specified,
or if there is no match for both normal and bold fonts,
_x_t_e_r_m uses the ffoonntt and related resources.
-
faceNameDoublesize (ccllaassss FFaacceeNNaammeeDDoouubblleessiizzee))</bb>>
<>
SSppeecciiffyy aann ddoouubbllee--wwiiddtthh ffoonntt ffoorr ccaasseess wwhheerree aann aapppplliiccaattiioonn rreeqquuiirreess
tthhiiss,, ee..gg..,, iinn CCJJKK aapppplliiccaattiioonnss..
TThheerree iiss nnoo ddeeffaauulltt..
IIff tthhee aapppplliiccaattiioonn uusseess ddoouubbllee--wwiiddee cchhaarraacctteerrss aanndd tthhiiss rreessoouurrccee iiss nnoott ggiivveenn,,
_x_t_e_r_m wwiillll uussee aa ssccaalleedd vveerrssiioonn ooff tthhee ffoonntt ggiivveenn bbyy ffaacceeNNaammee..
<>
<>ffaacceeSSiizzee ((ccllaassss FFaacceeSSiizzee))</bb>>
<>
SSppeecciiffyy tthhee ppooiinnttssiizzee ffoorr ffoonnttss sseelleecctteedd ffrroomm tthhee FFrreeeeTTyyppee
lliibbrraarryy iiff ssuuppppoorrtt ffoorr tthhaatt lliibbrraarryy wwaass ccoommppiilleedd iinnttoo _x_t_e_r_m.
The default is ``14.''
-
font (_c_l_a_s_s FFoonntt))</bb>>
<>
SSppeecciiffiieess tthhee nnaammee ooff tthhee nnoorrmmaall ffoonntt..
TThhee ddeeffaauulltt iiss ````ffiixxeedd..''''
<>
<></bb>>
SSeeee tthhee ddiissccuussssiioonn ooff tthhee llooccaallee rreessoouurrccee,,
<>
wwhhiicchh ddeessccrriibbeess hhooww tthhiiss ffoonntt mmaayy bbee oovveerrrriiddddeenn..
<>
<></bb>>
NNOOTTEE:: ssoommee rreessoouurrccee ffiilleess uussee ppaatttteerrnnss ssuucchh aass
<>
**ffoonntt:: ffiixxeedd
<>
<></bb>>
wwhhiicchh aarree oovveerrllyy bbrrooaadd,, aaffffeeccttiinngg bbootthh
<>
xxtteerrmm..vvtt110000..ffoonntt
<>
<></bb>>
aanndd
<>
xxtteerrmm..vvtt110000....uuttff88ffoonnttss..ffoonntt
<>
<></bb>>
wwhhiicchh iiss pprroobbaabbllyy nnoott wwhhaatt yyoouu iinntteennddeedd..
<>
<>
<>ffoonntt11 ((ccllaassss FFoonntt11))</bb>>
<>
SSppeecciiffiieess tthhee nnaammee ooff tthhee ffiirrsstt aalltteerrnnaattiivvee ffoonntt..
<>
<>ffoonntt22 ((ccllaassss FFoonntt22))</bb>>
<>
SSppeecciiffiieess tthhee nnaammee ooff tthhee sseeccoonndd aalltteerrnnaattiivvee ffoonntt..
<>
<>ffoonntt33 ((ccllaassss FFoonntt33))</bb>>
<