aboutsummaryrefslogtreecommitdiff
path: root/nx-X11/programs/xterm/xterm.man
diff options
context:
space:
mode:
Diffstat (limited to 'nx-X11/programs/xterm/xterm.man')
-rw-r--r--nx-X11/programs/xterm/xterm.man4418
1 files changed, 0 insertions, 4418 deletions
diff --git a/nx-X11/programs/xterm/xterm.man b/nx-X11/programs/xterm/xterm.man
deleted file mode 100644
index 36fa64df0..000000000
--- a/nx-X11/programs/xterm/xterm.man
+++ /dev/null
@@ -1,4418 +0,0 @@
-.\" $XTermId: xterm.man,v 1.320 2005/11/13 23:10:36 tom Exp $
-.\" $Xorg: xterm.man,v 1.4 2001/02/09 02:06:03 xorgcvs Exp $
-.\"
-.\"
-.\" Copyright 1996-2004,2005 by Thomas E. Dickey
-.\"
-.\" All Rights Reserved
-.\"
-.\" Permission is hereby granted, free of charge, to any person obtaining a
-.\" copy of this software and associated documentation files (the
-.\" "Software"), to deal in the Software without restriction, including
-.\" without limitation the rights to use, copy, modify, merge, publish,
-.\" distribute, sublicense, and/or sell copies of the Software, and to
-.\" permit persons to whom the Software is furnished to do so, subject to
-.\" the following conditions:
-.\"
-.\" The above copyright notice and this permission notice shall be included
-.\" in all copies or substantial portions of the Software.
-.\"
-.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-.\" IN NO EVENT SHALL THE ABOVE LISTED COPYRIGHT HOLDER(S) BE LIABLE FOR ANY
-.\" CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-.\" TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-.\" SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-.\"
-.\" Except as contained in this notice, the name(s) of the above copyright
-.\" holders shall not be used in advertising or otherwise to promote the
-.\" sale, use or other dealings in this Software without prior written
-.\" authorization.
-.\"
-.\"
-.\" Copyright 1989 The Open Group
-.\"
-.\" Permission to use, copy, modify, distribute, and sell this software and its
-.\" documentation for any purpose is hereby granted without fee, provided that
-.\" the above copyright notice appear in all copies and that both that
-.\" copyright notice and this permission notice appear in supporting
-.\" documentation.
-.\"
-.\" The above copyright notice and this permission notice shall be included
-.\" in all copies or substantial portions of the Software.
-.\"
-.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
-.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
-.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
-.\" OTHER DEALINGS IN THE SOFTWARE.
-.\"
-.\" Except as contained in this notice, the name of The Open Group shall
-.\" not be used in advertising or otherwise to promote the sale, use or
-.\" other dealings in this Software without prior written authorization
-.\" from The Open Group.
-.\"
-.\" $XFree86: xc/programs/xterm/xterm.man,v 3.118 2005/11/13 23:10:36 dickey Exp $
-.\"
-.\" updated by Thomas E. Dickey for XFree86, July 1996 - July 2004.
-.
-.de DS
-.sp
-.in +4
-.nf
-.ft C \" Courier
-..
-.de DE
-.fi
-.ft P
-.sp
-.in -4
-..
-.TH XTERM 1 __vendorversion__
-.SH NAME
-xterm \- terminal emulator for X
-.SH SYNOPSIS
-.B xterm
-[-\fItoolkitoption\fP ...] [-\fIoption\fP ...] [\fIshell\fP]
-.SH DESCRIPTION
-The \fIxterm\fP 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), \fIxterm\fP will use the facilities to notify programs
-running in the window whenever it is resized.
-.
-.PP
-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.
-.
-.PP
-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.
-.
-.SH 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.
-.IR Termcap (5)
-entries that work with
-.I xterm
-include
-an optional platform-specific entry,
-``xterm,'' ``vt102,'' ``vt100'' and ``ansi,'' and ``dumb.''
-.I 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 \fBdecTerminalID\fP resource.
-(The ``TERMCAP'' environment variable is not set if \fIxterm\fP is linked
-against a terminfo library, since the requisite information is not provided
-by the termcap emulation of terminfo libraries).
-.
-.PP
-Many of the special
-.I xterm
-features may be modified under program control
-through a set of escape sequences different from the standard VT102 escape
-sequences.
-(See the
-.I "Xterm Control Sequences"
-document.)
-.
-.PP
-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
-.I xterm
-and may be written to a file by sending the COPY escape sequence (or through
-the
-.B Tektronix
-menu; see below).
-The name of the file will be
-``\fBCOPY\fIyyyy\fB-\fIMM\fB-\fIdd\fB.\fIhh\fB:\fImm\fB:\fIss\fR'', where
-.IR yyyy ,
-.IR MM ,
-.IR dd ,
-.IR hh ,
-.I mm
-and
-.I ss
-are the year, month, day, hour, minute and second when the COPY was performed
-(the file is created in the directory
-.I xterm
-is started in, or the home directory for a login
-.IR xterm ).
-.
-.PP
-Not all of the features described in this manual are necessarily available in
-this version of \fIxterm\fP.
-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.
-.
-.SH "OTHER FEATURES"
-.I 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.
-.
-.PP
-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
-.IR termcap (5)
-entry for
-.I xterm
-allows the visual editor
-.IR 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.
-.
-.PP
-In either VT102 or Tektronix mode, there are escape sequences to change the
-name of the windows.
-Additionally, in VT102 mode,
-\fIxterm\fP implements the window-manipulation control
-sequences from \fIdtterm\fP, such as resizing the window, setting its location
-on the screen.
-.
-.PP
-.I Xterm
-allows character-based applications to receive mouse events (currently
-button-press and release events, and button-motion events)
-as keyboard control sequences.
-See \fIXterm Control Sequences\fP for details.
-.
-.
-.SH OPTIONS
-The \fIxterm\fP terminal emulator
-accepts all of the standard X Toolkit command line options as well as
-the following.
-If the option begins with a
-.RB ` + '
-instead of a
-.RB ` - ',
-the option is restored to its default value.
-The \fB-version\fP and \fB-help\fP options are interpreted even if \fIxterm\fP cannot
-open the display, and are useful for testing and configuration scripts:
-.TP 8
-.B -version
-This causes \fIxterm\fP to print a version number to the standard output.
-.TP 8
-.B -help
-This causes \fIxterm\fP to print out a verbose message describing its options.
-The message is written to the standard error.
-.
-.PP
-One parameter (after all options) may be given.
-That overrides \fIxterm\fP's built-in choice of shell program.
-Normally \fIxterm\fP checks the SHELL variable.
-If that is not set, \fIxterm\fP tries to use the shell program specified
-in the password file.
-If that is not set, \fIxterm\fP uses \fI/bin/sh\fP.
-If the parameter names an executable file, \fIxterm\fP uses that instead.
-The parameter must be an absolute path, or name a file found on the user's
-PATH (and thereby construct an absolute path).
-The \fB-e\fP option cannot be used with this parameter since
-it uses all parameters following the option.
-.PP
-The other options are used to control the appearance and behavior.
-Not all options are necessarily configured into your copy of \fIxterm\fP:
-.TP 8
-.B -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
-.I xterm
-window will resize appropriately.
-.TP 8
-.B -ah
-This option indicates that
-.I xterm
-should always highlight the text cursor.
-By default,
-.I xterm
-will display a hollow text cursor whenever the focus is lost or the
-pointer leaves the window.
-.TP 8
-.B +ah
-This option indicates that
-.I xterm
-should do text cursor highlighting based on focus.
-.TP 8
-.B -ai
-This option disables active icon support if that feature was compiled
-into \fIxterm\fP.
-This is equivalent to setting the \fIvt100\fP resource
-\fBactiveIcon\fP to ``false''.
-.TP 8
-.B +ai
-This option enables active icon support if that feature was compiled
-into \fIxterm\fP.
-This is equivalent to setting the \fIvt100\fP resource
-\fBactiveIcon\fP to ``true''.
-.TP 8
-.B -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.
-.TP 8
-.B +aw
-This option indicates that auto-wraparound should not be allowed.
-.TP 8
-.BI -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.
-That is the \fIvt100\fP \fIinternalBorder\fP resource.
-The
-default is 2.
-.TP 8
-.B +bc
-turn off text cursor blinking.
-This overrides the \fBcursorBlink\fR resource.
-.TP 8
-.B -bc
-turn on text cursor blinking.
-This overrides the \fBcursorBlink\fR resource.
-.TP 8
-.BI -bcf " milliseconds"
-set the amount of time text cursor is off when blinking via the
-\fIcursorOffTime\fP resource.
-.TP 8
-.BI -bcn " milliseconds"
-set the amount of time text cursor is on when blinking via the
-\fIcursorOffTime\fP resource.
-.TP 8
-.B "-bdc"
-Set the \fIvt100\fP resource \fBcolorBDMode\fR to ``false'',
-disabling the display of characters with bold attribute as color
-.TP 8
-.B "+bdc"
-Set the \fIvt100\fP resource \fBcolorBDMode\fR to ``true'',
-enabling the display of characters with bold attribute as color
-rather than bold
-.TP 8
-.B "-cb"
-Set the \fIvt100\fP resource \fBcutToBeginningOfLine\fP to ``false''.
-.TP 8
-.B "+cb"
-Set the \fIvt100\fP resource \fBcutToBeginningOfLine\fP to ``true''.
-.TP 8
-.B "-cc \fIcharacterclassrange\fP:\fIvalue\fP[,...]"
-This sets classes indicated by the given ranges for using in selecting by
-words.
-See the section specifying character classes.
-and discussion of the \fIcharClass\fP resource.
-.TP 8
-.B "-cjk_width"
-Set the \fBcjkWidth\fP resource to ``true''.
-When turned on, characters with East Asian Ambiguous (A) category in UTR 11
-have a column width of 2.
-Otherwise, 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 \fB-fa\fP at
-the command line or \fBfaceName\fP resource.
-The default is ``false''
-.TP 8
-.B "+cjk_width"
-Reset the \fBcjkWidth\fP resource.
-.TP 8
-.BI -class " string"
-This option allows you to override \fIxterm\fP's resource class.
-Normally it is ``XTerm'', but
-can be set to another class such as ``UXTerm'' to override selected resources.
-.TP 8
-.B "-cm"
-This option disables recognition of ANSI color-change escape sequences.
-It sets the \fIcolorMode\fP resource to ``false''.
-.TP 8
-.B "+cm"
-This option enables recognition of ANSI color-change escape sequences.
-This is the same as the \fIvt100\fP resource \fBcolorMode\fP.
-.TP 8
-.B "-cn"
-This option indicates that newlines should not be cut in line-mode
-selections.
-It sets the \fIcutNewline\fP resource to ``false''.
-.TP 8
-.B +cn
-This option indicates that newlines should be cut in line-mode selections.
-It sets the \fIcutNewline\fP resource to ``true''.
-.TP 8
-.BI -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.
-It sets the \fIcursorColor\fP resource according to the parameter.
-.TP 8
-.B -cu
-This option indicates that \fIxterm\fP should work around a bug in the
-.IR 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
-.IR curses (3x)
-cursor motion package.
-.TP 8
-.B +cu
-This option indicates that \fIxterm\fP should not work around the
-.IR more (1)
-bug mentioned above.
-.TP 8
-.B "-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.
-The option sets the \fIdynamicColors\fP option to ``false''.
-.TP 8
-.B "+dc"
-This option enables the escape sequence to change dynamic colors.
-The option sets the \fIdynamicColors\fP option to ``true''.
-.TP 8
-.BI -e " program \fP[ \fIarguments \fP.\|.\|. ]\fI"
-This option specifies the program (and its command line arguments) to be
-run in the \fIxterm\fP window.
-It also sets the window title and icon
-name to be the basename of the program being executed if neither \fI-T\fP
-nor \fI-n\fP are given on the command line.
-\fBThis must be the last option on the command line.\fP
-.TP 8
-.BI -en " encoding"
-This option determines the encoding on which \fIxterm\fP runs.
-It sets the \fBlocale\fR resource.
-Encodings other than UTF-8 are supported by using \fIluit\fR.
-The \fB-lc\fR option should be used instead of \fB-en\fR for
-systems with locale support.
-.TP 8
-.BI -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 \fBboldFont\fP and \fBboldMode\fP resources.
-.TP 8
-.BI -fa " pattern"
-This option sets the pattern for fonts selected from the FreeType
-library if support for that library was compiled into \fIxterm\fP.
-This corresponds to the \fBfaceName\fP resource.
-When a CJK
-double-width font is specified, you also need to turn
-on the \fBcjkWidth\fP resource.
-.TP 8
-.BI -fbb
-This option indicates that \fIxterm\fP should compare normal and bold fonts bounding
-boxes to ensure they are compatible.
-It sets the \fBfreeBoldBox\fP resource to ``false''.
-.TP 8
-.BI +fbb
-This option indicates that \fIxterm\fP should not compare normal and bold fonts bounding
-boxes to ensure they are compatible.
-It sets the \fBfreeBoldBox\fP resource to ``true''.
-.TP 8
-.BI -fbx
-This option indicates that \fIxterm\fP should not assume that the
-normal and bold fonts have VT100 line-drawing characters.
-If any are missing, \fIxterm\fP will draw the characters directly.
-It sets the \fBforceBoxChars\fP resource to ``false''.
-.TP 8
-.BI +fbx
-This option indicates that \fIxterm\fP should assume that the
-normal and bold fonts have VT100 line-drawing characters.
-It sets the \fBforceBoxChars\fP resource to ``true''.
-.TP 8
-.BI -fd " pattern"
-This option sets the pattern for double-width fonts selected from the FreeType
-library if support for that library was compiled into \fIxterm\fP.
-This corresponds to the \fBfaceNameDoublesize\fP resource.
-.TP 8
-.BI -fi " font"
-This option sets the font for active icons if that feature was compiled
-into \fIxterm\fP.
-See also the discussion of the \fBiconFont\fP resource.
-.TP 8
-.BI -fs " size"
-This option sets the pointsize for fonts selected from the FreeType
-library if support for that library was compiled into \fIxterm\fP.
-This corresponds to the \fBfaceSize\fP resource.
-.TP 8
-.B -fw \fIfont\fP
-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 \fBwideFont\fP resource.
-.TP 8
-.B -fwb \fIfont\fP
-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 \fBwideBoldFont\fP resource.
-.TP 8
-.B -fx \fIfont\fP
-This option specifies the font to be used for displaying the preedit string
-in the "OverTheSpot" input method.
-See also the discussion of the \fBximFont\fP resource.
-.TP 8
-.BI -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.
-See the discussion of the \fBhighlightColor\fP resource.
-.TP 8
-.BI -hf
-This option indicates that HP Function Key escape codes should be generated
-for function keys.
-It sets the \fBhpFunctionKeys\fP resource to ``true''.
-.TP 8
-.BI +hf
-This option indicates that HP Function Key escape codes should not be generated
-for function keys.
-It sets the \fBhpFunctionKeys\fP resource to ``false''.
-.TP 8
-.BI -hold
-Turn on the \fBhold\fP resource, i.e.,
-\fIxterm\fP 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.
-.TP 8
-.BI +hold
-Turn off the \fBhold\fP resource, i.e.,
-\fIxterm\fP will immediately destroy its window when the shell command completes.
-.TP 8
-.B -ie
-Turn on the \fBptyInitialErase\fP resource, i.e.,
-use the pseudo-terminal's sense of the stty erase value.
-.TP 8
-.B +ie
-Turn off the \fBptyInitialErase\fP resource, i.e.,
-set the stty erase value using the \fBkb\fP string from the termcap entry as
-a reference, if available.
-.TP 8
-.B -im
-Turn on the \fBuseInsertMode\fP resource,
-which forces use of insert mode by adding appropriate entries to the TERMCAP
-environment variable.
-.TP 8
-.B +im
-Turn off the \fBuseInsertMode\fP resource.
-.TP 8
-.BI -into " windowId"
-Given an X window identifier (a decimal integer),
-\fIxterm\fP will reparent its top-level shell widget to that window.
-This is used to embed \fIxterm\fP within other applications.
-.TP 8
-.B -j
-This option indicates that \fIxterm\fP should do jump scrolling.
-It corresponds to the \fBjumpScroll\fP resource.
-Normally,
-text is scrolled one line at a time; this option allows \fIxterm\fP to move
-multiple lines at a time so that it does not fall as far behind.
-Its use is
-strongly recommended since it makes \fIxterm\fP 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.
-.TP 8
-.B +j
-This option indicates that \fIxterm\fP should not do jump scrolling.
-.TP 8
-.B -k8
-This option sets the \fBallowC1Printable\fP resource.
-When \fBallowC1Printable\fP is set, \fIxterm\fP overrides the mapping
-of C1 control characters (code 128-159) to treat them as printable.
-.TP 8
-.B +k8
-This option resets the \fBallowC1Printable\fP resource.
-.TP 8
-.BI -kt " keyboardtype"
-This option sets the \fBkeyboardType\fP resource.
-Possible values include: ``hp'', ``sco'', ``sun'' and ``vt220''.
-The default value ``unknown'',
-causes the corresponding resource to be ignored.
-.TP 8
-.B -l
-Turn logging on.
-Normally logging is not supported, due to security concerns.
-Some versions of \fIxterm\fP may have logging enabled.
-The logfile is written to the directory from which \fIxterm\fP is
-invoked.
-The filename is generated, of the form
-.sp
- XtermLog.\fIXXXXXX\fR
-.sp
-or
-.sp
- Xterm.log.\fIhostname.yyyy.mm.dd.hh.mm.ss.XXXXXX\fR
-.sp
-depending on how \fIxterm\fP was built.
-.TP 8
-.B +l
-Turn logging off.
-.TP 8
-.B -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 \fIluit\fR for
-conversion between locale encodings and UTF-8.
-(\fIluit\fR is not invoked in UTF-8 locales.)
-This corresponds to the \fBlocale\fR resource.
-.IP
-The actual list of encodings which are supported is determined by \fIluit\fR.
-Consult the \fIluit\fR manual page for further details.
-See also the discussion of the \fB-u8\fP option which supports UTF-8 locales.
-.TP 8
-.B +lc
-Turn off support of automatic selection of locale encodings.
-Conventional 8bit mode or, in UTF-8 locales or with \fB-u8\fP option,
-UTF-8 mode will be used.
-.TP 8
-.BI -lcc " path"
-File name for the encoding converter from/to locale encodings
-and UTF-8 which is used with \fB-lc\fP option or \fBlocale\fR resource.
-This corresponds to the \fBlocaleFilter\fR resource.
-.TP 8
-.B -leftbar
-Force scrollbar to the left side of VT100 screen.
-This is the default, unless you have set the rightScrollBar resource.
-.TP 8
-.BI -lf " filename"
-Specify the log-filename.
-See the \fB-l\fP option.
-.TP 8
-.B -ls
-This option indicates that the shell that is started in the \fIxterm\fP 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).
-.IP
-The \fB-ls\fP flag and the \fBloginShell\fP resource
-are ignored if \fB-e\fP is also given,
-because \fIxterm\fP 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, \fIxterm\ -e\fP is supposed to provide a consistent
-functionality for other applications that need to start text-mode
-programs in a window, and if \fBloginShell\fP were not ignored, the
-result of ~/.profile might interfere with that.
-.IP
-If you do want the effect of \fB-ls\fP and \fB-e\fP simultaneously, you
-may get away with something like
-.RS 15
-xterm -e /bin/bash -l -c "my command here"
-.RE
-.IP
-Finally, \fB-ls\fP is not completely ignored,
-because \fIxterm\ -ls\ -e\fP does write a \fI/etc/wtmp\fP entry
-(if configured to do so),
-whereas \fIxterm\ -e\fP does not.
-.TP 8
-.B +ls
-This option indicates that the shell that is started should not be a login
-shell (i.e., it will be a normal ``subshell'').
-.TP 8
-.B -mb
-This option indicates that \fIxterm\fP 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.
-.TP 8
-.B +mb
-This option indicates that margin bell should not be rung.
-.TP 8
-.BI -mc " milliseconds"
-This option specifies the maximum time between multi-click selections.
-.TP 8
-.B -mesg
-Turn off the \fBmessages\fP resource, i.e.,
-disallow write access to the terminal.
-.TP 8
-.B +mesg
-Turn on the \fBmessages\fP resource, i.e.,
-allow write access to the terminal.
-.TP 8
-.B "-mk_width"
-Set the \fBmkWidth\fP resource to ``true''.
-This makes \fIxterm\fP use a built-in version of the wide-character width
-calculation.
-The default is ``false''
-.TP 8
-.B "+mk_width"
-Reset the \fBmkWidth\fP resource.
-.TP 8
-.BI -ms " color"
-This option specifies the color to be used for the pointer cursor.
-The default
-is to use the foreground color.
-This sets the \fIpointerColor\fP resource.
-.TP 8
-.BI -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.
-.TP 8
-.B "-nul"
-This option disables the display of underlining.
-.TP 8
-.B "+nul"
-This option enables the display of underlining.
-.TP 8
-.B -pc
-This option enables the PC-style use of bold colors (see boldColors
-resource).
-.TP 8
-.B +pc
-This option disables the PC-style use of bold colors.
-.TP 8
-.B -pob
-This option indicates that the window should be raised whenever a
-Control-G is received.
-.TP 8
-.B +pob
-This option indicates that the window should not be raised whenever a
-Control-G is received.
-.TP 8
-.B -rightbar
-Force scrollbar to the right side of VT100 screen.
-.TP 8
-.B "-rvc"
-This option disables the display of characters with reverse attribute as color.
-.TP 8
-.B "+rvc"
-This option enables the display of characters with reverse attribute as color.
-.TP 8
-.B -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.
-.TP 8
-.B +rw
-This option indicates that reverse-wraparound should not be allowed.
-.TP 8
-.B -s
-This option indicates that \fIxterm\fP may scroll asynchronously, meaning that
-the screen does not have to be kept completely up to date while scrolling.
-This allows \fIxterm\fP to run faster when network latencies are very high
-and is typically useful when running across a very large internet or many
-gateways.
-.TP 8
-.B +s
-This option indicates that \fIxterm\fP should scroll synchronously.
-.TP 8
-.B -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.
-.TP 8
-.B +samename
-Always send title and icon name change requests.
-.TP 8
-.B -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.
-.TP 8
-.B +sb
-This option indicates that a scrollbar should not be displayed.
-.TP 8
-.B -sf
-This option indicates that Sun Function Key escape codes should be generated
-for function keys.
-.TP 8
-.B +sf
-This option indicates that the standard escape codes should be generated for
-function keys.
-.TP 8
-.B -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.
-.TP 8
-.B +si
-This option indicates that output to a window should cause it to
-scroll to the bottom.
-.TP 8
-.B -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.
-.TP 8
-.B +sk
-This option indicates that pressing a key while using the scrollbar
-should not cause the window to be repositioned.
-.TP 8
-.BI -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 \fBsaveLines\fP resource.
-The default is 64.
-.TP 8
-.B -sm
-This option, corresponding to the \fBsessionMgt\fR resource,
-indicates that \fIxterm\fR should
-set up session manager callbacks.
-.TP 8
-.B +sm
-This option indicates that \fIxterm\fR should
-not set up session manager callbacks.
-.TP 8
-.B -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.
-.TP 8
-.B +sp
-This option indicates that the standard escape codes should be generated for
-keypad and function keys.
-.TP 8
-.B -t
-This option indicates that \fIxterm\fP should start in Tektronix mode, rather
-than in VT102 mode.
-Switching between the two windows is done using the
-``Options'' menus.
-.IR Termcap (5)
-entries that work with
-.I xterm
-``tek4014,'' ``tek4015,'' ``tek4012'', ``tek4013'' and ``tek4010,'' and ``dumb.''
-.I xterm
-automatically searches the termcap file in this order for these entries and then
-sets the ``TERM'' and the ``TERMCAP'' environment variables.
-.TP 8
-.B +t
-This option indicates that \fIxterm\fP should start in VT102 mode.
-.TP 8
-.B -tb
-This option, corresponding to the \fBtoolBar\fR resource,
-indicates that \fIxterm\fR should display a toolbar (or menubar)
-at the top of its window. The buttons in the toolbar correspond to
-the popup menus, e.g., control/left/mouse for "Main Options".
-.TP 8
-.B +tb
-This option indicates that \fIxterm\fR should
-not set up a toolbar.
-.TP 8
-.BI -ti " term_id"
-Specify the name used by \fIxterm\fP 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 \fBdecTerminalID\fP resource).
-.TP 8
-.BI -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 \fIstty\fP
-program.
-The keywords and their values are described in detail in the \fBttyModes\fP
-resource.
-.TP 8
-.BI -tn " name"
-This option specifies the name of the terminal type to be set in the TERM
-environment variable.
-It corresponds to the \fBtermName\fP resource.
-This terminal type must exist in the terminal
-database
-(termcap or terminfo, depending on how \fIxterm\fP is built)
-and should have \fIli#\fP and \fIco#\fP entries.
-If the terminal type is not found, \fIxterm\fP uses the built-in list
-``xterm'', ``vt102'', etc.
-.TP 8
-.B -u8
-This option sets the \fButf8\fP resource.
-When \fButf8\fP is set, \fIxterm\fP interprets incoming data as UTF-8.
-This sets the \fBwideChars\fP 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 \fBwideChars\fP resource.
-.IP
-This option and the \fButf8\fR resource are overridden by
-the \fB-lc\fP and \fB-en\fP options and \fBlocale\fR resource.
-That is, if \fIxterm\fP has been compiled to support \fIluit\fR,
-and the \fBlocale\fP resource is not ``false''
-this option is ignored.
-We recommend using
-the \fB-lc\fR option or the ``\fBlocale:\ true\fR'' resource
-in UTF-8 locales when your operating system supports locale,
-or \fB-en\ UTF-8\fP option or the ``\fBlocale:\ UTF-8\fR'' resource
-when your operating system does not support locale.
-.TP 8
-.B +u8
-This option resets the \fButf8\fP resource.
-.TP 8
-.B "-ulc"
-This option disables the display of characters with underline attribute as
-color rather than with underlining.
-.TP 8
-.B "+ulc"
-This option enables the display of characters with underline attribute as
-color rather than with underlining.
-.TP 8
-.B -ut
-This option indicates that \fIxterm\fP should not write a record into the
-the system \fIutmp\fP log file.
-.TP 8
-.B +ut
-This option indicates that \fIxterm\fP should write a record into
-the system \fIutmp\fP log file.
-.TP 8
-.B -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.
-.TP 8
-.B +vb
-This option indicates that a visual bell should not be used.
-.TP 8
-.B -wc
-This option sets the \fBwideChars\fP resource.
-When \fBwideChars\fP is set, \fIxterm\fP maintains internal structures for 16-bit
-characters.
-If you do not set this resource to ``true'',
-\fIxterm\fP will ignore the escape sequence which turns UTF-8 mode on and off.
-The default is ``false''.
-.TP 8
-.B +wc
-This option resets the \fBwideChars\fP resource.
-.TP 8
-.B -wf
-This option indicates that \fIxterm\fP 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.
-.TP 8
-.B +wf
-This option indicates that \fIxterm\fP should not wait before starting the
-subprocess.
-.TP 8
-.B -ziconbeep \fIpercent\fP
-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 \fIxterm\fP.)
-.TP 8
-.B -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 \fIxdm\fP 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.
-.TP 8
-.B -S\fIccn\fP
-This option allows \fIxterm\fP 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:
-.nf
-.RS 15
--S123/45
--Sab34
-.RE
-.fi
-.IP
-Note that \fIxterm\fP 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 \fIxterm\fP past the
-initialization or the \fB-S\fP option to a process running in the \fIxterm\fP.
-.PP
-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.
-.TP 8
-.B "%\fIgeom\fP"
-This option specifies the preferred size and position of the Tektronix window.
-It is shorthand for specifying the ``\fI*tekGeometry\fP'' resource.
-.TP 8
-.B \ #\fIgeom\fP
-This option specifies the preferred position of the icon window.
-It is shorthand for specifying the ``\fI*iconGeometry\fP'' resource.
-.TP 8
-.BI -T " string"
-This option specifies the title for \fIxterm\fP's windows.
-It is equivalent to \fB-title\fP.
-.TP 8
-.BI -n " string"
-This option specifies the icon name for \fIxterm\fP's windows.
-It is shorthand for specifying the ``\fI*iconName\fP'' resource.
-Note that this is not the same as the toolkit option \fB-name\fP (see below).
-The default icon name is the application name.
-.TP 8
-.B -r
-This option indicates that reverse video should be simulated by swapping
-the foreground and background colors.
-It is equivalent to
-\fB-rv\fP.
-.TP 8
-.BI -w " number"
-This option specifies the width in pixels of the border surrounding the window.
-It is equivalent to \fB-borderwidth\fP or \fB-bw\fP.
-.
-.PP
-The following standard X Toolkit command line arguments are commonly used
-with \fIxterm\fP:
-.TP 8
-.B -bd \fIcolor\fP
-This option specifies the color to use for the border of the window.
-The default is ``black.''
-.TP 8
-.B -bg \fIcolor\fP
-This option specifies the color to use for the background of the window.
-The default is ``white.''
-.TP 8
-.B -bw \fInumber\fP
-This option specifies the width in pixels of the border surrounding the window.
-.TP 8
-.B -display \fIdisplay\fP
-This option specifies the X server to contact; see \fIX(__miscmansuffix__)\fP.
-.TP 8
-.B -fg \fIcolor\fP
-This option specifies the color to use for displaying text.
-The default is
-``black.''
-.TP 8
-.B -fn \fIfont\fP
-This option specifies the font to be used for displaying normal text.
-The
-default is \fIfixed\fP.
-.TP 8
-.B -font \fIfont\fP
-This is the same as \fB-fn\fP.
-.TP 8
-.B -geometry \fIgeometry\fP
-This option specifies the preferred size and position of the VT102 window;
-see \fIX(__miscmansuffix__)\fP.
-.TP 8
-.B -iconic
-This option indicates that \fIxterm\fP should ask the window manager to
-start it as an icon rather than as the normal window.
-.TP 8
-.B -name \fIname\fP
-This option specifies the application name under which resources are to be
-obtained, rather than the default executable file name.
-\fIName\fP should not contain ``.'' or ``*'' characters.
-.TP 8
-.B -rv
-This option indicates that reverse video should be simulated by swapping
-the foreground and background colors.
-.TP 8
-.B +rv
-Disable the simulation of reverse video by swapping foreground and background
-colors.
-.TP 8
-.B -title \fIstring\fP
-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 \fB-e\fP option, if any, otherwise the application
-name.
-.TP 8
-.B -xrm \fIresourcestring\fP
-This option specifies a resource string to be used.
-This is especially
-useful for setting resources that do not have separate command line options.
-.
-.
-.SH RESOURCES
-The program understands all of the core X Toolkit resource names and classes.
-Application specific resources (e.g., "\fBXTerm.\fP\fINAME\fP") follow:
-.TP 8
-.B "backarrowKeyIsErase (\fPclass\fB BackarrowKeyIsErase)"
-Tie the VTxxx \fBbackarrowKey\fP and \fBptyInitialErase\fP resources
-together by setting the DECBKM state according to whether the initial value of
-stty erase is a backspace (8) or delete (127) character.
-The default is ``false'', which disables this feature.
-.TP 8
-.B "hold (\fPclass\fB Hold)"
-If true,
-\fIxterm\fP 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.
-You may scroll back, select text, etc., to perform most graphical operations.
-Resizing the display will lose data, however, since this involves interaction
-with the shell which is no longer running.
-.TP 8
-.B "hpFunctionKeys (\fPclass\fB HpFunctionKeys)"
-Specifies whether or not HP Function Key escape codes should be generated for
-function keys instead of standard escape sequences.
-See also the \fBkeyboardType\fP resource.
-.TP 8
-.B "iconGeometry (\fPclass\fB IconGeometry)"
-Specifies the preferred size and position of the application when iconified.
-It is not necessarily obeyed by all window managers.
-.TP 8
-.B "iconName (\fPclass\fB IconName)"
-Specifies the icon name.
-The default is the application name.
-.TP 8
-.B "keyboardType (\fPclass\fB KeyboardType)"
-Enables one (or none) of the various keyboard-type resources:
-\fBhpFunctionKeys\fP,
-\fBscoFunctionKeys\fP,
-\fBsunFunctionKeys\fP and
-\fBsunKeyboard\fP.
-The resource's value should be one of the corresponding strings
-hp, sco, sun or vt220.
-The individual resources are provided for legacy support;
-this resource is simpler to use.
-.TP 8
-.B "maxBufSize (\fPclass\fB MaxBufSize)"
-Specify the maximum size of the input buffer.
-The default is 32768.
-You cannot set this to a value less than the \fBminBufSize\fR resource.
-It will be increased as needed to make that value evenly divide this one.
-.IP
-On some systems you may want to increase one or both of the
-\fBmaxBufSize\fP and
-\fBminBufSize\fP resource values to achieve better performance
-if the operating system prefers larger buffer sizes.
-.TP 8
-.B "messages (\fPclass\fB Messages)"
-Specifies whether write access to the terminal is allowed initially.
-See
-.BR mesg (1).
-The default is ``true''.
-.TP 8
-.B "minBufSize (\fPclass\fB MinBufSize)"
-Specify the minimum size of the input buffer, i.e., the amount of data
-that \fIxterm\fR requests on each read.
-The default is 4096.
-You cannot set this to a value less than 64.
-.TP 8
-.B "ptyHandshake (\fPclass\fB PtyHandshake)
-If ``true'', \fIxterm\fP will perform handshaking during initialization
-to ensure that the parent and child processes update the \fButmp\fP
-and \fBstty\fP state.
-Platforms with newer pseudo-terminal interfaces do not require this feature;
-normally it is not configured.
-The default is ``true''.
-.TP 8
-.B "ptyInitialErase (\fPclass\fB PtyInitialErase)"
-If ``true'', \fIxterm\fP will use the pseudo-terminal's sense of the stty erase
-value.
-If ``false'', \fIxterm\fP will set the stty erase value to match its own
-configuration, using the \fBkb\fP string from the termcap entry as
-a reference, if available.
-In either case, the result is applied to the TERMCAP variable
-which \fIxterm\fP sets.
-The default is ``false''.
-.TP 8
-.B "sameName (\fPclass\fB SameName)"
-If the value of this resource is ``true'', \fIxterm\fP 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.
-The default is ``true''.
-.TP 8
-.B "scoFunctionKeys (\fPclass\fB ScoFunctionKeys)"
-Specifies whether or not SCP Function Key escape codes should be generated for
-function keys instead of standard escape sequences.
-See also the \fBkeyboardType\fP resource.
-.TP 8
-.B "sessionMgt (\fPclass\fB SessionMgt)"
-If the value of this resource is ``true'',
-\fIxterm\fP sets up session manager callbacks
-for \fBXtNdieCallback\fR and \fBXtNsaveCallback\fR.
-The default is ``true''.
-.TP 8
-.B "sunFunctionKeys (\fPclass\fB SunFunctionKeys)"
-Specifies whether or not Sun Function Key escape codes should be generated for
-function keys instead of standard escape sequences.
-See also the \fBkeyboardType\fP resource.
-.TP 8
-.B "sunKeyboard (\fPclass\fB SunKeyboard)"
-Specifies whether or not Sun/PC keyboard layout should be assumed rather
-than DEC VT220.
-This causes the keypad `+' to be mapped to `,'.
-and
-CTRL F1-F12 to F11-F20, depending on the setting of the \fBctrlFKeys\fP
-resource.
-so \fIxterm\fP emulates a DEC VT220 more accurately.
-Otherwise (the default, with \fBsunKeyboard\fP set to ``false''),
-\fIxterm\fP uses PC-style bindings for the function keys and keypad.
-.IP
-PC-style bindings
-use the Shift, Alt, Control and Meta keys as modifiers for function-keys
-and keypad
-(see the document \fIXterm Control Sequences\fP for details).
-The PC-style bindings are analogous to PCTerm, but not the same thing.
-Normally these bindings do not conflict with the use of the Meta key
-as described for the \fBeightBitInput\fP resource.
-If they do, note that the PC-style bindings are evaluated first.
-See also the \fBkeyboardType\fP resource.
-.TP 8
-.B "termName (\fPclass\fB TermName)"
-Specifies the terminal type name to be set in the TERM environment variable.
-.TP 8
-.B "title (\fPclass\fB Title)"
-Specifies a string that may be used by the window manager when displaying
-this application.
-.TP 8
-.B "toolBar (\fPclass\fB ToolBar)"
-Specifies whether or not the toolbar should be displayed.
-The default is
-``true.''
-.TP 8
-.B "ttyModes (\fPclass\fB TtyModes)"
-Specifies a string containing terminal setting keywords and the characters
-to which they may be bound.
-Allowable keywords include:
-brk,
-dsusp,
-eof,
-eol,
-eol2,
-erase,
-erase2,
-flush,
-intr,
-kill,
-lnext,
-quit,
-rprnt,
-start,
-status,
-stop,
-susp,
-swtch and
-weras.
-Control characters may be specified as ^char (e.g., ^c or ^u)
-and \fB^?\fP may be used to indicate delete (127).
-Use \fB^-\fP to denote \fIundef\fP.
-Use \fB\\034\fP to represent \fB^\\\fP, since a literal backslash in
-an X resource escapes the next character.
-.IP
-This is very useful for overriding
-the default terminal settings without having to do an \fIstty\fP every time
-an \fIxterm\fP is started.
-Note, however, that the stty program on a given host may use different
-keywords; \fIxterm\fR's table is built-in.
-.TP 8
-.B "useInsertMode (\fPclass\fB UseInsertMode)"
-Force use of insert mode by adding appropriate entries to the TERMCAP
-environment variable.
-This is useful if the system termcap is broken.
-The default is ``false.''
-.TP 8
-.B "utmpDisplayId (\fPclass\fB UtmpDisplayId)"
-Specifies whether or not \fIxterm\fP should try to record the display
-identifier (display number and screen number) as well as the hostname in
-the system \fIutmp\fP log file.
-The default is ``true.''
-.TP 8
-.B "utmpInhibit (\fPclass\fB UtmpInhibit)"
-Specifies whether or not \fIxterm\fP should try to record the user's terminal
-in
-the system \fIutmp\fP log file.
-If true, \fIxterm\fP will not try.
-The default is ``false.''
-.TP 8
-.B "waitForMap (\fPclass\fB WaitForMap)"
-Specifies whether or not \fIxterm\fP should wait for the initial window map
-before starting the subprocess.
-The default is ``false.''
-.TP 8
-.B "zIconBeep (\fPclass\fB ZIconBeep)"
-Same as -ziconbeep command line argument.
-If the value of this resource 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 \fIxterm\fR.)
-The default is ``false.''
-.
-.PP
-The following resources are specified as part
-of the \fIvt100\fP widget (class \fIVT100\fP):
-These are specified by patterns such as "\fBXTerm.vt100.\fP\fINAME\fP":
-.TP 8
-.B "activeIcon (\fPclass\fB ActiveIcon)"
-Specifies whether or not active icon windows are to be used when the
-\fIxterm\fP window is iconified, if this feature is compiled into \fIxterm\fR.
-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.''
-.TP 8
-.B "allowC1Printable (\fPclass\fB AllowC1Printable)"
-If true, overrides the mapping of C1 controls
-(codes 128-159) to make them be treated
-as if they were printable characters.
-Although this corresponds to no particular standard,
-some users insist it is a VT100.
-The default is ``false.''
-.TP 8
-.B "allowSendEvents (\fPclass\fB AllowSendEvents)"
-Specifies whether or not synthetic key and button events (generated using
-the X protocol SendEvent request) should be interpreted or discarded.
-The default is ``false'' meaning they are discarded.
-Note that allowing
-such events creates a very large security hole.
-The default is ``false.''
-.TP
-.B "allowWindowOps (\fPclass\fB AllowWindowOps)"
-Specifies whether extended window control sequences (as used in dtterm)
-for should be allowed.
-The default is ``true.''
-.TP 8
-.B "alwaysHighlight (\fPclass\fB AlwaysHighlight)"
-Specifies whether or not \fIxterm\fP should always display a highlighted
-text cursor.
-By default (if this resource is false),
-a hollow text cursor is displayed whenever the
-pointer moves out of the window or the window loses the input focus.
-The default is ``false.''
-.TP 8
-.B "alwaysUseMods (\fPclass\fB AlwaysUseMods)"
-Override the \fBnumLock\fP resource, telling \fIxterm\fR 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.''
-.TP 8
-.B "answerbackString (\fPclass\fB AnswerbackString)"
-Specifies the string that \fIxterm\fR 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.
-.TP 8
-.B "appcursorDefault (\fPclass\fB AppcursorDefault)"
-If ``true,'' the cursor keys are initially in application mode.
-This is the same as the VT102 private DECCKM mode,
-The default is ``false.''
-.TP 8
-.B "appkeypadDefault (\fPclass\fB AppkeypadDefault)"
-If ``true,'' the keypad keys are initially in application mode.
-The default is ``false.''
-.TP 8
-.B "autoWrap (\fPclass\fB AutoWrap)"
-Specifies whether or not auto-wraparound should be enabled.
-This is the same as the VT102 DECAWM.
-The
-default is ``true.''
-.TP 8
-.B "awaitInput (\fPclass\fB AwaitInput)"
-Specifies whether or not the \fIxterm\fR uses a 50 millisecond timeout to
-await input (i.e., to support the Xaw3d arrow scrollbar).
-The default is ``false.''
-.TP 8
-.B "backarrowKey (\fPclass\fB BackarrowKey)"
-Specifies whether the backarrow key transmits
-a backspace (8)
-or delete (127) character.
-This corresponds to the DECBKM control sequence.
-The default (backspace) is ``true.''
-Pressing the control key toggles this behavior.
-.TP 8
-.B "background (\fPclass\fB Background)"
-Specifies the color to use for the background of the window.
-The default is
-``white.''
-.TP 8
-.B "bellOnReset (\fPclass\fB BellOnReset)"
-Specifies whether to sound a bell when doing a hard reset.
-The default is ``true.''
-.TP 8
-.B "bellSuppressTime (\fPclass\fB BellSuppressTime)"
-Number of milliseconds after a bell command is sent during which additional
-bells will be suppressed.
-Default is 200.
-If set non-zero,
-additional bells
-will also be suppressed until the server reports that processing of
-the first bell has been completed; this feature is most useful with
-the visible bell.
-.TP 8
-.B "boldColors (\fPclass\fB ColorMode)"
-Specifies whether to combine bold attribute with colors like the IBM PC,
-i.e., map colors 0 through 7 to colors 8 through 15.
-These normally are the brighter versions of the first 8 colors, hence bold.
-The default is ``true.''
-.TP 8
-.B "boldFont (\fPclass\fB BoldFont)"
-Specifies the name of the bold font to use instead of overstriking.
-There is no default for this resource.
-.TP 8
-.B "boldMode (\fPclass\fB BoldMode)"
-This specifies whether or not text with the bold attribute should be
-overstruck to simulate bold fonts if the resolved bold font is the
-same as the normal font.
-It may be desirable to disable bold fonts when color is being
-used for the bold attribute.
-Note that \fIxterm\fP has one bold font which you may set explicitly.
-It attempts to match a bold font for the other font selections
-(\fBfont1\fP through \fBfont6\fP).
-If the normal and bold fonts are distinct, this resource has no effect.
-The default is ``true.''
-.IP
-Although \fIxterm\fP attempts to match a bold font for other font selections,
-the font server may not cooperate.
-Since X11R6, bitmap fonts have been scaled.
-The font server claims to provide the bold font that \fIxterm\fP requests,
-but the result is not always readable.
-XFree86 provides a feature which can be used to suppress the scaling.
-In the X server's configuration file (e.g., "/etc/X11/XFree86"), you
-can add ":unscaled" to the end of the directory specification for the
-"misc" fonts, which comprise the fixed-pitch fonts that are used by \fIxterm\fP.
-For example
-.RS
- FontPath "/usr/lib/X11/fonts/misc/"
-.RE
-.IP
-would become
-.RS
- FontPath "/usr/lib/X11/fonts/misc/:unscaled"
-.RE
-.IP
-Depending on your configuration, the font server may have its own configuration
-file.
-The same ":unscaled" can be added to its configuration file at the
-end of the directory specification for "misc".
-.TP 8
-.B "brokenLinuxOSC (\fPclass\fB BrokenLinuxOSC)"
-If true, \fIxterm\fP applies a workaround to ignore malformed control
-sequences that a Linux script might send.
-Compare the palette control sequences documented in \fIconsole_codes\fR
-with ECMA-48.
-The default is ``true.''
-.TP 8
-.B "brokenSelections (\fPclass\fB BrokenSelections)"
-If true, \fIxterm\fP in 8-bit mode will interpret
-.B STRING
-selections as carrying text in the current locale's encoding.
-Normally
-.B STRING
-selections carry ISO-8859-1 encoded text.
-Setting this resource to
-``true'' violates the ICCCM; it may, however, be useful for interacting
-with some broken X clients.
-The default is ``false.''
-.TP 8
-.B "brokenStringTerm (\fPclass\fB BrokenStringTerm)"
-provides a work-around for some ISDN routers which start an application
-control string without completing it.
-Set this to ``true'' if \fIxterm\fP appears to freeze when connecting.
-The default is ``false.''
-.TP 8
-.B "c132 (\fPclass\fB C132)"
-Specifies whether or not the VT102 DECCOLM escape sequence,
-used to switch between 80 and 132 columns, should be honored.
-The default is ``false.''
-.TP 8
-.B "cacheDoublesize (\fPclass\fB CacheDoublesize)"
-Specifies the maximum number of double-sized fonts which are cached by
-\fIxterm\fR.
-The default (8) may be too large for some X terminals with limited memory.
-Set this to zero to disable doublesize fonts altogether.
-.TP 8
-.B "charClass (\fPclass\fB CharClass)"
-Specifies comma-separated lists of character class bindings of the form
-[\fIlow\fP-]\fIhigh\fP:\fIvalue\fP.
-These are used in determining which
-sets of characters should be treated the same when doing cut and paste.
-See the CHARACTER CLASSES section.
-.TP 8
-.B "cjkWidth (\fPclass\fB CjkWidth)"
-Specifies whether \fIxterm\fP should follow
-the traditional East Asian width convention.
-When turned on, characters with East Asian Ambiguous (A) category in UTR
-11 have a column width of 2.
-You may have to set this option to ``true''
-if you have some old East Asian terminal based programs that assume that
-line-drawing characters have a column width of 2.
-The default is ``false.''
-.TP 8
-.B "color0 (\fPclass\fB Color0)"
-.TP 8
-.B "color1 (\fPclass\fB Color1)"
-.TP 8
-.B "color2 (\fPclass\fB Color2)"
-.TP 8
-.B "color3 (\fPclass\fB Color3)"
-.TP 8
-.B "color4 (\fPclass\fB Color4)"
-.TP 8
-.B "color5 (\fPclass\fB Color5)"
-.TP 8
-.B "color6 (\fPclass\fB Color6)"
-.TP 8
-.B "color7 (\fPclass\fB Color7)"
-These specify the colors for the ISO 6429 extension.
-The defaults are,
-respectively,
-black,
-red3,
-green3,
-yellow3,
-a customizable dark blue,
-magenta3,
-cyan3,
-and
-gray90.
-The default shades of color are chosen to allow the colors 8-15
-to be used as brighter versions.
-.TP 8
-.B "color8 (\fPclass\fB Color8)"
-.TP 8
-.B "color9 (\fPclass\fB Color9)"
-.TP 8
-.B "color10 (\fPclass\fB Color10)"
-.TP 8
-.B "color11 (\fPclass\fB Color11)"
-.TP 8
-.B "color12 (\fPclass\fB Color12)"
-.TP 8
-.B "color13 (\fPclass\fB Color13)"
-.TP 8
-.B "color14 (\fPclass\fB Color14)"
-.TP 8
-.B "color15 (\fPclass\fB Color15)"
-These specify the colors for the ISO 6429 extension if the bold attribute
-is also enabled.
-The default resource values are respectively,
-gray30,
-red,
-green,
-yellow,
-a customizable light blue,
-magenta,
-cyan,
-and
-white.
-.TP 8
-.B "color16 (\fPclass\fB Color16)"
-.TP 8
-through
-.TP 8
-.B "color255 (\fPclass\fB Color255)"
-These specify the colors for the 256-color extension.
-The default resource values
-are for colors 16 through 231 to make a 6x6x6 color cube, and colors
-232 through 255 to make a grayscale ramp.
-.TP 8
-.B "colorAttrMode (\fPclass\fB ColorAttrMode)"
-Specifies whether \fBcolorBD\fP, \fBcolorBL\fP, \fBcolorRV\fP, and
-\fBcolorUL\fP should override ANSI colors.
-If not, these are displayed only when no ANSI colors
-have been set for the corresponding position.
-The default is ``false.''
-.TP 8
-.B "colorBD (\fPclass\fB ColorBD)"
-This specifies the color to use to display bold characters if
-the ``colorBDMode'' resource is enabled.
-The default is ``XtDefaultForeground.''
-.TP 8
-.B "colorBDMode (\fPclass\fB ColorAttrMode)"
-Specifies whether characters with the bold attribute should be displayed in
-color or as bold characters.
-Note that setting \fBcolorMode\fR off disables
-all colors, including bold.
-The default is ``false.''
-.TP 8
-.B "colorBL (\fPclass\fB ColorBL)"
-This specifies the color to use to display blink characters if
-the ``colorBLMode'' resource is enabled.
-The default is ``XtDefaultForeground.''
-.TP 8
-.B "colorBLMode (\fPclass\fB ColorAttrMode)"
-Specifies whether characters with the blink attribute should be displayed in
-color.
-Note that setting \fBcolorMode\fR off disables all colors, including this.
-The default is ``false.''
-.TP 8
-.B "colorMode (\fPclass\fB ColorMode)"
-Specifies whether or not recognition of ANSI (ISO 6429)
-color change escape sequences should be enabled.
-The default is ``true.''
-.TP 8
-.B "colorRV (\fPclass\fB ColorRV)"
-This specifies the color to use to display reverse characters if
-the ``colorRVMode'' resource is enabled.
-The default is ``XtDefaultForeground.''
-.TP 8
-.B "colorRVMode (\fPclass\fB ColorAttrMode)"
-Specifies whether characters with the reverse attribute should be displayed in
-color.
-Note that setting \fBcolorMode\fR off disables all colors, including this.
-The default is ``false.''
-.TP 8
-.B "colorUL (\fPclass\fB ColorUL)"
-This specifies the color to use to display underlined characters if
-the ``colorULMode'' resource is enabled.
-The default is ``XtDefaultForeground.''
-.TP 8
-.B "colorULMode (\fPclass\fB ColorAttrMode)"
-Specifies whether characters with the underline attribute should be displayed
-in color or as underlined characters.
-Note that setting \fBcolorMode\fR off
-disables all colors, including underlining.
-The default is ``false.''
-.TP 8
-.B "ctrlFKeys (\fPclass\fB CtrlFKeys)"
-In VT220 keyboard mode (see \fBsunKeyboard\fP resource),
-specifies the amount by which to shift F1-F12 given a control modifier (CTRL).
-This allows you to generate key symbols for F10-F20 on a Sun/PC keyboard.
-The default is ``10'', which means that CTRL F1 generates the key
-symbol for F11.
-.TP 8
-.B "curses (\fPclass\fB Curses)"
-Specifies whether or not the last column bug in
-.IR more (1)
-should be worked around.
-See the \fB-cu\fP option for details.
-The default is ``false.''
-.TP 8
-.B "cursorBlink (\fPclass\fB CursorBlink)"
-Specifies whether to make the cursor blink.
-The default is ``false.''
-.TP 8
-.B "cursorColor (\fPclass\fB CursorColor)"
-Specifies the color to use for the text cursor.
-The default is ``black.''
-.TP 8
-.B "cursorOffTime (\fPclass\fB CursorOffTime)"
-Specifies the duration of the "off" part of the cursor blink cycle-time
-in milliseconds.
-The same timer is used for text blinking.
-The default is 300.
-.TP 8
-.B "cursorOnTime (\fPclass\fB CursorOnTime)"
-Specifies the duration of the "on" part of the cursor blink cycle-time,
-in milliseconds.
-The same timer is used for text blinking.
-The default is 600.
-.TP 8
-.B "cutNewline (\fPclass\fB CutNewline)"
-If ``false'', triple clicking to select a line does not include the Newline
-at the end of the line.
-If ``true'', the Newline is selected.
-The default is ``true.''
-.TP 8
-.B "cutToBeginningOfLine (\fPclass\fB CutToBeginningOfLine)"
-If ``false'', triple clicking to select a line selects only from the
-current word forward.
-If ``true'', the entire line is selected.
-The default is ``true.''
-.TP 8
-.B "decTerminalID (\fPclass\fB DecTerminalID)"
-Specifies the emulation level (100=VT100, 220=VT220, etc.), used to determine
-the type of response to a DA control sequence.
-Leading non-digit characters are ignored, e.g., "vt100" and "100" are the same.
-The default is 100.
-.TP 8
-.B "deleteIsDEL (\fPclass\fB DeleteIsDEL)"
-Specifies whether the Delete key on the editing keypad should send DEL (127)
-or the VT220-style Remove escape sequence.
-The default is ``false,'' for the latter.
-.TP 8
-.B "dynamicColors (\fPclass\fB DynamicColors)"
-Specifies whether or not escape sequences to change colors assigned to
-different attributes are recognized.
-.TP 8
-.B "eightBitControl (\fPclass\fB EightBitControl\fP)"
-Specifies whether or not control sequences sent by the
-terminal should be eight-bit characters or escape sequences.
-The default is ``false.''
-.TP 8
-.B "eightBitInput (\fPclass\fB EightBitInput\fP)"
-If ``true'', Meta characters
-(a single-byte character combined with the \fIkeys\fP modifier key)
-input from the keyboard are presented as a
-single character with the eighth bit turned on.
-The terminal is put into 8-bit mode.
-If ``false'', Meta characters are converted into a two-character
-sequence with the character itself preceded by ESC.
-On startup, \fIxterm\fP tries to put the terminal into 7-bit mode.
-The \fBmetaSendsEscape\fP resource may override this.
-The default is ``true.''
-.IP
-Generally keyboards do not have a key labeled "Meta",
-but "Alt" keys are common, and they are conventionally used for "Meta".
-If they were synonymous, it would have been reasonable to name this
-resource "altSendsEscape", reversing its sense.
-For more background on this, see the \fBmeta\fP function in curses.
-.IP
-Note that the \fIAlt\fP key is not necessarily the same as the
-\fIMeta\fP modifier.
-\fIxmodmap\fP lists your key modifiers.
-X defines modifiers for shift, (caps) lock and control,
-as well as 5 additional modifiers which are generally used to configure
-key modifiers.
-\fIxterm\fP inspects the same information to find the modifier associated
-with either \fIMeta\fP key (left or right),
-and uses that key as the \fIMeta\fP modifier.
-It also looks for the NumLock key,
-to recognize the modifier which is associated with that.
-.IP
-If your \fIxmodmap\fP configuration
-uses the same keycodes for Alt- and Meta-keys,
-\fIxterm\fP will only see the Alt-key definitions, since those are tested
-before Meta-keys.
-NumLock is tested first.
-It is important to keep these keys distinct;
-otherwise some of \fIxterm\fP's functionality is not available.
-.TP 8
-.B "eightBitOutput (\fPclass\fB EightBitOutput\fP)"
-Specifies whether or not eight-bit characters sent from the host should be
-accepted as is or stripped when printed.
-The default is ``true,''
-which means that they are accepted as is.
-.TP 8
-.B "faceName (\fPclass\fB FaceName)"
-Specify the pattern for fonts selected from the FreeType
-library if support for that library was compiled into \fIxterm\fR.
-There is no default.
-If not specified,
-or if there is no match for both normal and bold fonts,
-\fIxterm\fR uses the \fBfont\fP and related resources.
-.TP 8
-.B "faceNameDoublesize (\fPclass\fB FaceNameDoublesize)"
-Specify an double-width font for cases where an application requires
-this, e.g., in CJK applications.
-There is no default.
-If the application uses double-wide characters and this resource is not given,
-\fIxterm\fP will use a scaled version of the font given by \fBfaceName\fP.
-.TP 8
-.B "faceSize (\fPclass\fB FaceSize)"
-Specify the pointsize for fonts selected from the FreeType
-library if support for that library was compiled into \fIxterm\fR.
-The default is ``14.''
-.TP 8
-.B "font (\fPclass\fB Font)"
-Specifies the name of the normal font.
-The default is ``fixed.''
-.IP
-See the discussion of the \fBlocale\fP resource,
-which describes how this font may be overridden.
-.IP
-NOTE: some resource files use patterns such as
-.RS
-*font: fixed
-.RE
-.IP
-which are overly broad, affecting both
-.RS
-xterm.vt100.font
-.RE
-.IP
-and
-.RS
-xterm.vt100..utf8fonts.font
-.RE
-.IP
-which is probably not what you intended.
-.TP 8
-.B "font1 (\fPclass\fB Font1)"
-Specifies the name of the first alternative font.
-.TP 8
-.B "font2 (\fPclass\fB Font2)"
-Specifies the name of the second alternative font.
-.TP 8
-.B "font3 (\fPclass\fB Font3)"
-Specifies the name of the third alternative font.
-.TP 8
-.B "font4 (\fPclass\fB Font4)"
-Specifies the name of the fourth alternative font.
-.TP 8
-.B "font5 (\fPclass\fB Font5)"
-Specifies the name of the fifth alternative font.
-.TP 8
-.B "font6 (\fPclass\fB Font6)"
-Specifies the name of the sixth alternative font.
-.TP 8
-.B "fontDoublesize (\fPclass\fB FontDoublesize)"
-Specifies whether \fIxterm\fP should attempt to use font scaling to draw
-doublesize characters.
-Some older font servers cannot do this properly, will return misleading
-font metrics.
-The default is ``true''.
-If disabled, \fIxterm\fP will simulate doublesize characters by drawing
-normal characters with spaces between them.
-.TP 8
-.B "forceBoxChars (\fPclass\fB ForceBoxChars)"
-Specifies whether \fIxterm\fP should assume the normal and bold fonts
-have VT100 line-drawing characters.
-The fixed-pitch fonts used by \fIxterm\fP
-normally have the VT100 line-drawing glyphs in cells 1-31.
-Other fixed-pitch fonts may be more attractive, but lack these glyphs.
-If ``false'', \fIxterm\fP will check for missing glyphs in cells 1-31
-and make line-drawing characters directly.
-If ``true'', \fIxterm\fP uses whatever is in cells 1-31 without checking.
-The default is ``false.''
-.TP 8
-.B "foreground (\fPclass\fB 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.
-The default
-is ``black.''
-.TP 8
-.B "freeBoldBox (\fPclass\fB freeBoldBox)"
-Specifies whether \fIxterm\fP should assume the bounding boxes for
-normal and bold fonts are compatible.
-If ``false'', \fIxterm\fP compares them and will reject choices of
-bold fonts that do not match the size of the normal font.
-The default is ``false'', which means that the comparison is performed.
-.TP 8
-.B "geometry (\fPclass\fB Geometry)"
-Specifies the preferred size and position of the VT102 window.
-There is no default for this resource.
-.TP 8
-.B "highlightColor (\fPclass\fB HighlightColor)"
-Specifies the color to use for the background of selected or otherwise
-highlighted text.
-If not specified, reverse video is used.
-The default is ``XtDefaultForeground.''
-.TP 8
-.B "highlightSelection (\fPclass\fB HighlightSelection)"
-If ``false'', selecting with the mouse highlights all positions on the screen
-between the beginning of the selection and the current position.
-If ``true'', \fIxterm\fP highlights only the positions that contain text that
-can be selected.
-The default is ``false.''
-.IP
-Depending on the way your applications write to the screen, there may
-be trailing blanks on a line.
-\fIXterm\fP stores data as it is shown on the screen.
-Erasing the display changes the internal state of each cell
-so it is not considered a blank for the purpose of selection.
-Blanks written since the last erase are selectable.
-If you do not wish to have trailing blanks in a selection,
-use the \fBtrimSelection\fP resource.
-.TP 8
-.B "hpLowerleftBugCompat (\fPclass\fB HpLowerleftBugCompat)"
-Specifies whether to work around a bug in HP's \fIxdb\fP,
-which ignores termcap and always sends
-ESC F to move to the lower left corner.
-``true'' causes \fIxterm\fP to interpret ESC F as a request to move to the
-lower left corner of the screen.
-The default is ``false.''
-.TP 8
-.B "i18nSelections (\fPclass\fB I18nSelections)"
-If false, \fIxterm\fP will never request the targets
-.B COMPOUND_TEXT
-or
-.BR TEXT .
-The default is ``true.'' It may be set to false in order to work around
-ICCCM violations by other X clients.
-.TP 8
-.B "iconBorderColor (\fPclass\fB BorderColor)"
-Specifies the border color for the active icon window if this feature
-is compiled into \fIxterm\fR.
-Not all window managers will make the icon
-border visible.
-.TP 8
-.B "iconBorderWidth (\fPclass\fB BorderWidth)"
-Specifies the border width for the active icon window if this feature
-is compiled into \fIxterm\fR.
-The default is 2.
-Not all window managers will make the border visible.
-.TP 8
-.B "iconFont (\fPclass\fB IconFont)"
-Specifies the font for the miniature active icon window, if this feature
-is compiled into \fIxterm\fR.
-The default is "nil2".
-.TP 8
-.B "internalBorder (\fPclass\fB BorderWidth)"
-Specifies the number of pixels between the characters and the window border.
-The default is 2.
-.TP 8
-.B "italicULMode (\fPclass\fB ColorAttrMode)"
-Specifies whether characters with the underline attribute should be displayed
-in an italic font or as underlined characters.
-.TP 8
-.B "jumpScroll (\fPclass\fB JumpScroll)"
-Specifies whether or not jump scroll should be used.
-This corresponds to the VT102 DECSCLM private mode.
-The default is ``true.''
-.TP 8
-.B "keyboardDialect (\fPclass\fB KeyboardDialect)"
-Specifies the initial keyboard dialect, as well as the default value when
-the terminal is reset.
-The value given is the same as the final character in the control sequences
-which change character sets.
-The default is ``B'', which corresponds to US ASCII.
-.TP 8
-.B "\fIname\fP\fBKeymap\fP (class\fB \fIName\fP\fBKeymap\fP)"
-See the discussion of the \fBkeymap()\fP action.
-.TP 8
-.B "limitResize (\fPclass\fB LimitResize)"
-Limits resizing of the screen via control sequence to a given multiple of
-the display dimensions.
-The default is ``1''.
-.TP 8
-.B "locale (\fPclass\fB Locale)"
-Specifies how to use \fIluit\fR, an encoding converter between UTF-8
-and locale encodings.
-The resource value (ignoring case) may be:
-.RS
-.TP 4
-.I true
-\fIxterm\fR will use the
-encoding specified by the users' LC_CTYPE locale (i.e., LC_ALL,
-LC_CTYPE, or LANG variables) as far as possible.
-This is realized
-by always enabling UTF-8 mode and invoking \fIluit\fR in non-UTF-8
-locales.
-.TP
-.I medium
-\fIxterm\fR will follow users'
-LC_CTYPE locale only for UTF-8, east Asian, and Thai locales,
-where the encodings were not supported by conventional 8bit mode
-with changing fonts.
-For other locales, \fIxterm\fR will use conventional 8bit mode.
-.TP
-.I checkfont
-If mini-luit is compiled-in, \fIxterm\fR will check if a Unicode font has
-been specified. If so, it checks if the character encoding for the
-current locale is POSIX, Latin-1 or Latin-9, uses the appropriate
-mapping to support those with the Unicode font.
-For other encodings, \fIxterm\fR assumes that UTF-8 encoding is required.
-.TP
-.I false
-\fIxterm\fR will use conventional 8bit mode
-or UTF-8 mode according to \fButf8\fR resource or \fB-u8\fP option.
-.RE
-.IP
-Any other value, e.g., ``UTF-8'' or ``ISO8859-2'',
-is assumed to be an encoding name;
-\fIluit\fR will be invoked to support the encoding.
-The actual list of supported encodings depends on \fIluit\fR.
-The default is ``medium''.
-.IP
-Regardless of your locale and encoding,
-you need an ISO-10646-1 font to display the result.
-Your configuration may not include this font,
-or locale-support by \fIxterm\fP may not be needed.
-At startup, \fIxterm\fP uses a mechanism equivalent to
-the \fBload-vt-fonts(utf8Fonts,\ Utf8Fonts)\fP action
-to load font name subresources of the VT100 widget.
-That is,
-resource patterns such as "\fB*vt100.utf8Fonts.font\fP" will be loaded,
-and (if this resource is enabled), override the normal fonts.
-If no subresources are found,
-the normal fonts such as "\fB*vt100.font\fP", etc., are used.
-The resource files distributed with \fIxterm\fP use ISO-10646-1 fonts,
-but do not rely on them unless you are using the locale mechanism.
-.TP 8
-.B "localeFilter (\fPclass\fB LocaleFilter)"
-Specifies the file name for the encoding converter from/to locale
-encodings and UTF-8 which is used with the \fB-lc\fR option or \fBlocale\fR resource.
-The help message shown by ``xterm -help'' lists the default value,
-which depends on your system configuration.
-.TP 8
-.B "loginShell (\fPclass\fB LoginShell)"
-Specifies whether or not the shell to be run in the window should be started
-as a login shell.
-The default is ``false.''
-.TP 8
-.B "marginBell (\fPclass\fB MarginBell)"
-Specifies whether or not the bell should be rung when the user types near the
-right margin.
-The default is ``false.''
-.TP 8
-.B "metaSendsEscape (\fPclass\fB MetaSendsEscape\fP)"
-If ``true'', Meta characters
-(a character combined with the \fIMeta\fP modifier key)
-are converted into a two-character
-sequence with the character itself preceded by ESC.
-This applies as well to function key control sequences, unless \fIxterm\fP
-sees that \fBMeta\fP is used in your key translations.
-If ``false'', Meta characters input from the keyboard are handled according
-to the \fBeightBitInput\fP resource.
-The default is ``false.''
-.TP 8
-.B "mkWidth (\fPclass\fB MkWidth)"
-Specifies whether \fIxterm\fP should use a built-in version of the wide
-character width calculation.
-The default is ``false.''
-.TP 8
-.B "modifyCursorKeys (\fPclass\fB ModifyCursorKeys\fP)"
-Tells how to handle the special case where
-Control-, Shift-, Alt- or Meta-modifiers are used to add a parameter to
-the escape sequence returned by a cursor-key.
-Set it to 0 to use the old/obsolete behavior.
-Set it to 1 to prefix modified sequences with CSI.
-Set it to 2 to force the modifier to be the second parameter.
-Set it to 3 to mark the sequence with a '>' to hint that it is private.
-The default is ``2''.
-.TP 8
-.B "multiClickTime (\fPclass\fB MultiClickTime)"
-Specifies the maximum time in milliseconds between multi-click select
-events.
-The default is 250 milliseconds.
-.TP 8
-.B "multiScroll (\fPclass\fB MultiScroll)"
-Specifies whether or not scrolling should be done asynchronously.
-The default is ``false.''
-.TP 8
-.B "nMarginBell (\fPclass\fB Column)"
-Specifies the number of characters from the right margin at which the margin
-bell should be rung, when enabled.
-.TP 8
-.B "numLock (\fPclass\fB NumLock)"
-If ``true'', \fIxterm\fR checks if NumLock is used as a modifier (see \fIxmodmap\fP(1)).
-If so, this modifier is used to simplify the logic when implementing special
-NumLock for the \fBsunKeyboard\fP resource.
-Also (when \fBsunKeyboard\fP is false), similar logic is used to find the
-modifier associated with the left and right Alt keys.
-The default is ``true.''
-.TP 8
-.B "oldXtermFKeys (\fPclass\fB OldXtermFKeys)"
-If ``true'', \fIxterm\fR will use old-style control sequences for function keys F1 to F4,
-for compatibility with X Consortium \fIxterm\fR.
-Otherwise, it uses the VT100-style
-codes for PF1 to PF4.
-The default is ``false.''
-.TP 8
-.B "pointerColor (\fPclass\fB PointerColor)"
-Specifies the foreground color of the pointer.
-The default is
-``XtDefaultForeground.''
-.TP 8
-.B "pointerColorBackground (\fPclass\fB PointerColorBackground)"
-Specifies the background color of the pointer.
-The default is
-``XtDefaultBackground.''
-.TP 8
-.B "pointerShape (\fPclass\fB Cursor)"
-Specifies the name of the shape of the pointer.
-The default is ``xterm.''
-.TP 8
-.B "popOnBell (\fPclass\fB PopOnBell)"
-Specifies whether the window whould be raised when Control-G is
-received.
-The default is ``false.''
-.TP 8
-.B "printAttributes (\fPclass\fB PrintAttributes)"
-Specifies whether to print graphic attributes along with the text.
-A real DEC VTxxx terminal will print the underline, highlighting codes
-but your printer may not handle these.
-A ``0'' disables the attributes.
-A ``1'' prints the normal set of attributes (bold, underline, inverse and blink)
-as VT100-style control sequences.
-A ``2'' prints ANSI color attributes as well.
-The default is ``1.''
-.TP 8
-.B "printerAutoClose (\fPclass\fB PrinterAutoClose)"
-If ``true'', \fIxterm\fR will close the printer (a pipe) when the application switches
-the printer offline with a Media Copy command.
-The default is ``false.''
-.TP 8
-.B "printerCommand (\fPclass\fB PrinterCommand)"
-Specifies a shell command to which
-.I xterm
-will open a pipe when the first
-MC (Media Copy) command is initiated.
-The default is a blank string.
-If the resource value is given as a blank string, the printer is disabled.
-.TP 8
-.B "printerControlMode (\fPclass\fB PrinterControlMode)"
-Specifies the printer control mode.
-A ``1'' selects autoprint mode, which causes
-.I xterm
-to print a line from the screen when you move the cursor off that
-line with a line feed, form feed or vertical tab character, or an
-autowrap occurs.
-Autoprint mode is overridden by printer controller mode (a ``2''),
-which causes all of the output to be directed to the printer.
-The default is ``0.''
-.TP 8
-.B "printerExtent (\fPclass\fB PrinterExtent)"
-Controls whether a print page function will print the entire page (true), or
-only the the portion within the scrolling margins (false).
-The default is ``false.''
-.TP 8
-.B "printerFormFeed (\fPclass\fB PrinterFormFeed)"
-Controls whether a form feed is sent to the printer at the end of a print
-page function.
-The default is ``false.''
-.TP 8
-.B "renderFont (\fPclass\fB RenderFont)"
-If \fIxterm\fR is built with the Xft library,
-this controls whether the \fBfaceName\fR resource is used.
-The default is ``true.''
-.TP 8
-.B "resizeGravity (\fPclass\fB ResizeGravity)"
-Affects the behavior when the window is resized to be taller or
-shorter.
-\fBNorthWest\fP
-specifies that the top line of text on the screen stay fixed.
-If the window
-is made shorter, lines are dropped from the bottom; if the window is
-made taller, blank lines are added at the bottom.
-This is compatible
-with the behavior in R4.
-\fBSouthWest\fP (the default) specifies that
-the bottom line of text on the screen stay fixed.
-If the window is
-made taller, additional saved lines will be scrolled down onto the
-screen; if the window is made shorter, lines will be scrolled off the
-top of the screen, and the top saved lines will be dropped.
-.TP 8
-.B "reverseVideo (\fPclass\fB ReverseVideo)"
-Specifies whether or not reverse video should be simulated.
-The default is
-``false.''
-.TP 8
-.B "reverseWrap (\fPclass\fB ReverseWrap)"
-Specifies whether or not reverse-wraparound should be enabled.
-This corresponds to \fIxterm\fP's private mode 45.
-The default is
-``false.''
-.TP 8
-.B "rightScrollBar (\fPclass\fB RightScrollBar)"
-Specifies whether or not the scrollbar should be displayed on the right
-rather than the left.
-The default is ``false.''
-.TP 8
-.B "saveLines (\fPclass\fB SaveLines)"
-Specifies the number of lines to save beyond the top of the screen when a
-scrollbar is turned on.
-The default is 64.
-.TP 8
-.B "scrollBar (\fPclass\fB ScrollBar)"
-Specifies whether or not the scrollbar should be displayed.
-The default is
-``false.''
-.TP 8
-.B "scrollBarBorder (\fPclass\fB ScrollBarBorder)"
-Specifies the width of the scrollbar border.
-Note that this is drawn to overlap the border of the \fIxterm\fP window.
-Modifying the scrollbar's border affects only the line between the VT100
-widget and the scrollbar.
-The default value is 1.
-.TP 8
-.B "scrollKey (\fPclass\fB ScrollCond)"
-Specifies whether or not pressing a key should automatically cause the
-scrollbar to go to the bottom of the scrolling region.
-This corresponds to \fIxterm\fP's private mode 1011.
-The default is
-``false.''
-.TP 8
-.B "scrollLines (\fPclass\fB ScrollLines)"
-Specifies the number of lines that the \fIscroll-back\fP and
-\fIscroll-forw\fP actions should use as a default.
-The default value is 1.
-.TP 8
-.B "scrollTtyOutput (\fPclass\fB ScrollCond)"
-Specifies whether or not output to the terminal should automatically cause
-the scrollbar to go to the bottom of the scrolling region.
-The default is ``true.''
-.TP 8
-.B "shiftFonts (\fPclass\fB ShiftFonts)"
-Specifies whether to enable the actions
-\fBlarger-vt-font()\fP and
-\fBsmaller-vt-font()\fP, which are normally bound to
-the shifted KP_Add and KP_Subtract.
-The default is ``true.''
-.TP 8
-.B "showBlinkAsBold (\fPclass\fB ShowBlinkAsBold)"
-Tells \fIxterm\fP whether to display text with blink-attribute the same
-as bold.
-If \fIxterm\fP has not been configured to support blinking text,
-the default is ``true.'', which corresponds to older versions of \fIxterm\fP,
-otherwise the default is ``false.''
-.TP 8
-.B "showMissingGlyphs (\fPclass\fB ShowMissingGlyphs)"
-Tells \fIxterm\fP whether to display a box outlining places where
-a character has been used that the font does not represent.
-The default is ``false.''
-.TP 8
-.B "signalInhibit (\fPclass\fB SignalInhibit)"
-Specifies whether or not the entries in the ``Main Options'' menu for sending
-signals to \fIxterm\fP should be disallowed.
-The default is ``false.''
-.TP 8
-.B "tekGeometry (\fPclass\fB Geometry)"
-Specifies the preferred size and position of the Tektronix window.
-There is no default for this resource.
-.TP 8
-.B "tekInhibit (\fPclass\fB TekInhibit)"
-Specifies whether or not
-the escape sequence to enter
-Tektronix mode should be ignored.
-The default is
-``false.''
-.TP 8
-.B "tekSmall (\fPclass\fB TekSmall)"
-Specifies whether or not the Tektronix mode window should start in its smallest
-size if no explicit geometry is given.
-This is useful when running \fIxterm\fP
-on displays with small screens.
-The default is ``false.''
-.TP 8
-.B "tekStartup (\fPclass\fB TekStartup)"
-Specifies whether or not \fIxterm\fP should start up in Tektronix mode.
-The default is ``false.''
-.TP 8
-.B "tiXtraScroll (\fPclass\fB TiXtraScroll)"
-Specifies whether \fIxterm\fP should scroll to a new page when processing
-the \fIti\fP termcap entry, i.e., the private modes 47, 1047 or 1049.
-This is only in effect if \fBtiteInhibit\fP is ``true'',
-because the intent of this option is to provide a picture of the full-screen
-application's display on the scrollback without wiping out the text that
-would be shown before the application was initialized.
-The default for this resource is ``false.''
-.TP 8
-.B "titeInhibit (\fPclass\fB TiteInhibit)"
-Specifies whether or not \fIxterm\fP should remove \fIti\fP and \fIte\fP
-termcap entries (used to switch between alternate screens on startup of many
-screen-oriented programs) from the TERMCAP string.
-If set,
-\fIxterm\fP also ignores the escape sequence to switch to the
-alternate screen.
-\fIXterm\fP supports terminfo in a different way, supporting composite control
-sequences (also known as private modes) 1047, 1048 and 1049 which have the same
-effect as the original 47 control sequence.
-The default for this resource is ``false.''
-.TP 8
-.B "translations (\fPclass\fB Translations)"
-Specifies the key and button bindings for menus, selections, ``programmed
-strings,'' etc.
-The \fBtranslations\fP resource,
-which provides much of \fIxterm\fP's configurability,
-is a feature of the X Toolkit Intrinsics library (Xt).
-See the \fBACTIONS\fP section.
-.TP 8
-.B "trimSelection (\fPclass\fB TrimSelection)"
-If you set \fBhighlightSelection\fP,
-you can see the text which is selected, including any trailing spaces.
-Clearing the screen (or a line) resets it to a state containing no spaces.
-Some lines may contain trailing spaces when an application writes them to
-the screen.
-However, you may not wish to paste lines with trailing spaces.
-If this resource is true, \fIxterm\fP will trim trailing spaces from
-text which is selected.
-It does not affect spaces which result in a wrapped line, nor will it
-trim the trailing newline from your selection.
-The default is ``false.''
-.TP 8
-.B "underLine (\fPclass\fB UnderLine)"
-This specifies whether or not text with the underline attribute should be
-underlined.
-It may be desirable to disable underlining when color is being
-used for the underline attribute.
-The default is ``true.''
-.TP 8
-.B "utf8 (\fPclass\fB Utf8)"
-This specifies whether \fIxterm\fP will run in UTF-8 mode.
-If you set this resource, \fIxterm\fP also sets the \fBwideChars\fP resource as a side-effect.
-The resource is an integer, expected to range from 0 to 3:
-.RS
-.TP
-0
-UTF-8 mode is initially off.
-The command-line option \fB+u8\fP sets the resource to this value.
-Escape sequences for turning UTF-8 mode on/off are allowed.
-.TP
-1
-UTF-8 mode is initially on.
-Escape sequences for turning UTF-8 mode on/off are allowed.
-.TP
-2
-The command-line option \fB-u8\fP sets the resource to this value.
-Escape sequences for turning UTF-8 mode on/off are ignored.
-.TP
-3
-This is the default value of the resource.
-It is changed during initialization depending on
-whether the \fBlocale\fP resource was set, to 0 or 2.
-See the \fBlocale\fR resource for additional discussion of non-UTF-8 locales.
-.RE
-.IP
-If you want to set the value of \fButf8\fP, it should be in this range.
-Other nonzero values are treated the same as ``1'',
-i.e., UTF-8 mode is initially on, and
-escape sequences for turning UTF-8 mode on/off are allowed.
-.TP 8
-.B "utf8Fonts (\fPclass\fB Utf8Fonts)"
-See the discussion of the \fBlocale\fP resource.
-.TP 8
-.B "veryBoldColors (\fPclass\fB VeryBoldColors)"
-Specifies whether to combine video attributes with colors specified by
-\fBcolorBD\fR, \fBcolorBL\fR, \fBcolorRV\fR and \fBcolorUL\fR.
-The resource value is the sum of values for each attribute:
-.RS 10
-.nf
-1 for reverse,
-2 for underline,
-4 for bold and
-8 for blink.
-.fi
-.RE
-.IP
-The default is ``0.''
-.TP 8
-.B "visualBell (\fPclass\fB VisualBell)"
-Specifies whether or not a visible bell (i.e., flashing) should be used instead
-of an audible bell when Control-G is received.
-The default is ``false.''
-.TP 8
-.B "visualBellDelay (\fPclass\fB VisualBellDelay)"
-Number of milliseconds to delay when displaying a visual bell.
-Default is 100.
-If set to zero, no visual bell is displayed.
-This is useful for very slow displays, e.g., an LCD display on a laptop.
-.TP 8
-.B "vt100Graphics (\fPclass\fB VT100Graphics)"
-This specifies whether \fIxterm\fP will interpret VT100 graphic character
-escape sequences while in UTF-8 mode.
-The default is ``true'', to provide support for various legacy applications.
-.TP 8
-.B "wideBoldFont (\fPclass\fB WideBoldFont)"
-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.
-.TP 8
-.B "wideChars (\fPclass\fB WideChars)"
-Specifies if \fIxterm\fP should respond to control sequences that
-process 16-bit characters.
-The default is ``false.''
-.TP 8
-.B "wideFont (\fPclass\fB WideFont)"
-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.
-.TP 8
-.B "ximFont (\fPclass\fB XimFont)"
-This option specifies the font to be used for displaying the preedit string
-in the "OverTheSpot" input method.
-.IP
-In "OverTheSpot" preedit type, the preedit (preconversion)
-string is displayed at the position of the cursor.
-It is the XIM server's responsibility to display the preedit string.
-The XIM client must inform the XIM server of the cursor position.
-For best results, the preedit string must be displayed with a proper font.
-Therefore, \fIxterm\fP informs the XIM server of the proper font.
-The font is be supplied by a "fontset", whose default value is "*".
-This matches every font, the X library automatically chooses fonts with
-proper charsets.
-The \fBximFont\fP resource is provided to override this default font setting.
-.
-.PP
-The following resources are specified
-as part of the \fItek4014\fP widget (class \fITek4014\fP).
-These are specified by patterns such as "\fBXTerm.tek4014.\fP\fINAME\fP":
-.TP 8
-.B "font2 (\fPclass\fB Font)"
-Specifies font number 2 to use in the Tektronix window.
-.TP 8
-.B "font3 (\fPclass\fB Font)"
-Specifies font number 3 to use in the Tektronix window.
-.TP 8
-.B "fontLarge (\fPclass\fB Font)"
-Specifies the large font to use in the Tektronix window.
-.TP 8
-.B "fontSmall (\fPclass\fB Font)"
-Specifies the small font to use in the Tektronix window.
-.TP 8
-.B "ginTerminator (\fPclass\fB GinTerminator)"
-Specifies what character(s) should follow a GIN report or status report.
-The possibilities are ``none,'' which sends no terminating characters,
-``CRonly,'' which sends CR, and ``CR&EOT,'' which sends both CR and EOT.
-The default is ``none.''
-.TP 8
-.B "height (\fPclass\fB Height)"
-Specifies the height of the Tektronix window in pixels.
-.TP 8
-.B "initialFont (\fPclass\fB InitialFont)"
-Specifies which of the four Tektronix fonts to use initially.
-Values are the same as for the \fIset-tek-text\fP action.
-The default is ``large.''
-.TP 8
-.B "width (\fPclass\fB Width)"
-Specifies the width of the Tektronix window in pixels.
-.
-.PP
-The resources that may be specified for the various menus are described in
-the documentation for the Athena \fBSimpleMenu\fP widget.
-The name and classes
-of the entries in each of the menus are listed below.
-Resources named "\fBline\fR\fIN\fR" where \fIN\fR is a number
-are separators with class \fBSmeLine\fR.
-.
-.PP
-The \fImainMenu\fP has the following entries:
-.TP 8
-.B "toolbar (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-toolbar(toggle)\fP action.
-.TP 8
-.B "securekbd (\fPclass\fB SmeBSB)"
-This entry invokes the \fBsecure()\fP action.
-.TP 8
-.B "allowsends (\fPclass\fB SmeBSB)"
-This entry invokes the \fBallow-send-events(toggle)\fP action.
-.TP 8
-.B "redraw (\fPclass\fB SmeBSB)"
-This entry invokes the \fBredraw()\fP action.
-.TP 8
-.B "logging (\fPclass\fB SmeBSB)"
-This entry invokes the \fBlogging(toggle)\fP action.
-.TP 8
-.B "print (\fPclass\fB SmeBSB)"
-This entry invokes the \fBprint()\fP action.
-.TP 8
-.B "print-redir (\fPclass\fB SmeBSB)"
-This entry invokes the \fBprint-redir()\fP action.
-.TP 8
-.B "8-bit-control (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-8-bit-control(toggle)\fP action.
-.TP 8
-.B "backarrow\ key (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-backarrow(toggle)\fP action.
-.TP 8
-.B "num-lock (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-num-lock(toggle)\fP action.
-.TP 8
-.B "alt-esc (\fPclass\fB SmeBSB)"
-This entry invokes the \fBalt-sends-escape(toggle)\fP action.
-.TP 8
-.B "meta-esc (\fPclass\fB SmeBSB)"
-This entry invokes the \fBmeta-sends-escape(toggle)\fP action.
-.TP 8
-.B "delete-is-del (\fPclass\fB SmeBSB)"
-This entry invokes the \fBdelete-is-del(toggle)\fP action.
-.TP 8
-.B "oldFunctionKeys (\fPclass\fB SmeBSB)"
-This entry invokes the \fBold-function-keys(toggle)\fP action.
-.TP 8
-.B "hpFunctionKeys (\fPclass\fB SmeBSB)"
-This entry invokes the \fBhp-function-keys(toggle)\fP action.
-.TP 8
-.B "scoFunctionKeys (\fPclass\fB SmeBSB)"
-This entry invokes the \fBsco-function-keys(toggle)\fP action.
-.TP 8
-.B "sunFunctionKeys (\fPclass\fB SmeBSB)"
-This entry invokes the \fBsun-function-keys(toggle)\fP action.
-.TP 8
-.B "sunKeyboard (\fPclass\fB SmeBSB)"
-This entry invokes the \fBsunKeyboard(toggle)\fP action.
-.TP 8
-.B "suspend (\fPclass\fB SmeBSB)"
-This entry invokes the \fBsend-signal(tstp)\fP action on systems that
-support job control.
-.TP 8
-.B "continue (\fPclass\fB SmeBSB)"
-This entry invokes the \fBsend-signal(cont)\fP action on systems that
-support job control.
-.TP 8
-.B "interrupt (\fPclass\fB SmeBSB)"
-This entry invokes the \fBsend-signal(int)\fP action.
-.TP 8
-.B "hangup (\fPclass\fB SmeBSB)"
-This entry invokes the \fBsend-signal(hup)\fP action.
-.TP 8
-.B "terminate (\fPclass\fB SmeBSB)"
-This entry invokes the \fBsend-signal(term)\fP action.
-.TP 8
-.B "kill (\fPclass\fB SmeBSB)"
-This entry invokes the \fBsend-signal(kill)\fP action.
-.TP 8
-.B "quit (\fPclass\fB SmeBSB)"
-This entry invokes the \fBquit()\fP action.
-.
-.PP
-The \fIvtMenu\fP has the following entries:
-.TP 8
-.B "scrollbar (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-scrollbar(toggle)\fP action.
-.TP 8
-.B "jumpscroll (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-jumpscroll(toggle)\fP action.
-.TP 8
-.B "reversevideo (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-reverse-video(toggle)\fP action.
-.TP 8
-.B "autowrap (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-autowrap(toggle)\fP action.
-.TP 8
-.B "reversewrap (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-reversewrap(toggle)\fP action.
-.TP 8
-.B "autolinefeed (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-autolinefeed(toggle)\fP action.
-.TP 8
-.B "appcursor (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-appcursor(toggle)\fP action.
-.TP 8
-.B "appkeypad (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-appkeypad(toggle)\fP action.
-.TP 8
-.B "scrollkey (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-scroll-on-key(toggle)\fP action.
-.TP 8
-.B "scrollttyoutput (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-scroll-on-tty-output(toggle)\fP action.
-.TP 8
-.B "allow132 (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-allow132(toggle)\fP action.
-.TP 8
-.B "cursesemul (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-cursesemul(toggle)\fP action.
-.TP 8
-.B "visualbell (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-visualbell(toggle)\fP action.
-.TP 8
-.B "poponbell (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-poponbell(toggle)\fP action.
-.TP 8
-.B "marginbell (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-marginbell(toggle)\fP action.
-.TP 8
-.B "cursorblink (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-cursorblink(toggle)\fP action.
-.TP 8
-.B "titeInhibit (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-titeInhibit(toggle)\fP action.
-.TP 8
-.B "activeicon (\fPclass\fB SmeBSB)"
-This entry toggles active icons on and off if this feature was
-compiled into \fIxterm\fP.
-It is enabled only if \fIxterm\fP
-was started with the command line option +ai or the \fBactiveIcon\fP
-resource is set to ``True.''
-.TP 8
-.B "softreset (\fPclass\fB SmeBSB)"
-This entry invokes the \fBsoft-reset()\fP action.
-.TP 8
-.B "hardreset (\fPclass\fB SmeBSB)"
-This entry invokes the \fBhard-reset()\fP action.
-.TP 8
-.B "clearsavedlines (\fPclass\fB SmeBSB)"
-This entry invokes the \fBclear-saved-lines()\fP action.
-.TP 8
-.B "tekshow (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-visibility(tek,toggle)\fP action.
-.TP 8
-.B "tekmode (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-terminal-type(tek)\fP action.
-.TP 8
-.B "vthide (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-visibility(vt,off)\fP action.
-.TP 8
-.B "altscreen (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-altscreen(toggle)\fP action.
-.
-.PP
-The \fIfontMenu\fP has the following entries:
-.TP 8
-.B "fontdefault (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-vt-font(d)\fP action.
-.TP 8
-.B "font1 (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-vt-font(1)\fP action.
-.TP 8
-.B "font2 (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-vt-font(2)\fP action.
-.TP 8
-.B "font3 (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-vt-font(3)\fP action.
-.TP 8
-.B "font4 (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-vt-font(4)\fP action.
-.TP 8
-.B "font5 (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-vt-font(5)\fP action.
-.TP 8
-.B "font6 (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-vt-font(6)\fP action.
-.TP 8
-.B "fontescape (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-vt-font(e)\fP action.
-.TP 8
-.B "fontsel (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-vt-font(s)\fP action.
-.TP 8
-.B "font-linedrawing (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-font-linedrawing(s)\fP action.
-.TP 8
-.B "font-doublesize (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-font-doublesize(s)\fP action.
-.TP 8
-.B "render-font (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-render-font(s)\fP action.
-.TP 8
-.B "utf8-mode (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-utf8-mode(s)\fP action.
-.
-.PP
-The \fItekMenu\fP has the following entries:
-.TP 8
-.B "tektextlarge (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-tek-text(l)\fP action.
-.TP 8
-.B "tektext2 (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-tek-text(2)\fP action.
-.TP 8
-.B "tektext3 (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-tek-text(3)\fP action.
-.TP 8
-.B "tektextsmall (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-tek-text(s)\fP action.
-.TP 8
-.B "tekpage (\fPclass\fB SmeBSB)"
-This entry invokes the \fBtek-page()\fP action.
-.TP 8
-.B "tekreset (\fPclass\fB SmeBSB)"
-This entry invokes the \fBtek-reset()\fP action.
-.TP 8
-.B "tekcopy (\fPclass\fB SmeBSB)"
-This entry invokes the \fBtek-copy()\fP action.
-.TP 8
-.B "vtshow (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-visibility(vt,toggle)\fP action.
-.TP 8
-.B "vtmode (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-terminal-type(vt)\fP action.
-.TP 8
-.B "tekhide (\fPclass\fB SmeBSB)"
-This entry invokes the \fBset-visibility(tek,toggle)\fP action.
-.
-.PP
-The following resources are useful when specified for the Athena Scrollbar
-widget:
-.TP 8
-.B "thickness (\fPclass\fB Thickness)"
-Specifies the width in pixels of the scrollbar.
-.TP 8
-.B "background (\fPclass\fB Background)"
-Specifies the color to use for the background of the scrollbar.
-.TP 8
-.B "foreground (\fPclass\fB Foreground)"
-Specifies the color to use for the foreground of the scrollbar.
-The ``thumb''
-of the scrollbar is a simple checkerboard pattern alternating pixels for
-foreground and background color.
-.
-.
-.SH "POINTER USAGE"
-.
-.PP
-Once the VT102 window is created,
-.I xterm
-allows you to select text and copy it within the same or other windows.
-.
-.PP
-The selection functions are invoked when the pointer buttons are used with no
-modifiers, and when they are used with the ``shift'' key.
-The assignment of the functions described below to keys and buttons may
-be changed through the resource database; see \fBACTIONS\fP below.
-.
-.PP
-Pointer button one (usually left) is used to save text into the cut buffer.
-Move the cursor to beginning of the text,
-and then hold the button down while moving the cursor to the end of the region
-and releasing the button.
-The selected text is highlighted and is saved in the global cut buffer
-and made the PRIMARY selection when the button is released.
-Double-clicking selects by words.
-Triple-clicking
-selects by lines.
-Quadruple-clicking goes back to characters, etc.
-Multiple-click is determined by the time from button up to
-button down, so you can change the selection unit in the middle of a selection.
-Logical words and lines selected by double- or triple-clicking may wrap
-across more than one screen line if lines were wrapped by \fIxterm\fP
-itself rather than by the application running in the window.
-If the key/button bindings specify that an X selection is to be made,
-\fIxterm\fP will leave the selected text highlighted for as long as it
-is the selection owner.
-.
-.PP
-Pointer button two (usually middle) `types' (pastes) the text from
-the PRIMARY selection, if any, otherwise from
-the cut buffer,
-inserting it as keyboard input.
-.
-.PP
-Pointer button three (usually right) extends the current selection.
-(Without loss of generality,
-you can swap ``right'' and ``left'' everywhere in the rest of this
-paragraph.) If pressed while closer to
-the right edge of the selection than the left, it extends/contracts the
-right edge of the selection.
-If you contract the selection past
-the left edge of the selection,
-.I xterm
-assumes you really meant the left edge, restores the original selection, then
-extends/contracts the left edge of the selection.
-Extension starts in the
-selection unit mode
-that the last selection or extension was performed in; you can multiple-click
-to cycle through them.
-.
-.PP
-By cutting and pasting pieces of text without trailing 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.
-Since cut buffers are globally shared among different applications,
-you may regard each as a `file' whose contents you know.
-The terminal emulator and other text programs should be treating it as if it
-were a text file, i.e., the text is delimited by new lines.
-.
-.PP
-The scroll region displays the position and amount of text currently showing
-in the window (highlighted) relative to the amount of text actually saved.
-As more text is saved (up to the maximum), the size of the highlighted area
-decreases.
-.
-.PP
-Clicking button one with the pointer in the scroll region moves the
-adjacent line to the top of the display window.
-.
-.PP
-Clicking button three moves the top line of the display window down to the
-pointer position.
-.
-.PP
-Clicking button two moves the display to a position in the saved text
-that corresponds to the pointer's position in the scrollbar.
-.
-.PP
-Unlike the VT102 window, the Tektronix window does not allow the copying of
-text.
-It does allow Tektronix GIN mode, and in this mode
-the cursor will change from an arrow to a cross.
-Pressing any key will send that key and the current coordinate of the
-cross cursor.
-Pressing button one, two, or three will return the letters `l', `m', and
-`r', respectively.
-If the `shift' key is pressed when a pointer button is pressed, the corresponding
-upper case letter is sent.
-To distinguish a pointer button from a key, the high bit of the character is
-set (but this is bit is normally stripped unless the terminal mode is RAW;
-see
-.IR tty (4)
-for details).
-.
-.
-.SH MENUS
-.
-.PP
-.I Xterm
-has four menus, named
-.IR mainMenu ,
-.IR vtMenu ,
-.IR fontMenu ,
-and
-.IR tekMenu .
-Each menu pops up under the correct combinations of key and button presses.
-Each menu is divided into sections, separated by a horizontal line.
-Some menu entries correspond to modes that can be altered.
-A check mark appears next to a mode that is currently active.
-Selecting one of these modes toggles its state.
-Other menu entries are commands;
-selecting one of these performs the indicated function.
-.PP
-All of the menu entries correspond to X actions.
-In the list below, the menu label is shown followed by the action's
-name in parenthesis.
-.
-.\" ************************************************************************
-.PP
-The \fIxterm\fP \fImainMenu\fP pops up
-when the ``control'' key and pointer button one are pressed in a window.
-This menu contains items that apply to both the VT102 and Tektronix windows.
-There are several sections:
-.TP
-Commands for managing X events:
-.RS
-.TP
-Toolbar
-Clicking on the "Toolbar" menu entry hides the toolbar if it is visible,
-and shows it if it is not.
-.TP
-Secure Keyboard (securekbd)
-The
-.B Secure Keyboard
-mode is helpful when typing in passwords or other sensitive data in an
-unsecure environment;
-see \fBSECURITY\fP below (but read the limitations carefully).
-.TP
-Allow SendEvents (allowsends )
-Specifies whether or not synthetic key and button events generated using
-the X protocol SendEvent request should be interpreted or discarded.
-This corresponds to the \fBallowSendEvents\fP resource.
-.TP
-Redraw Window (redraw)
-Forces the X display to repaint;
-useful in some environments.
-.RE
-.TP
-Commands for capturing output:
-.RS
-.TP
-Log to File (logging)
-Captures text sent to the screen in a logfile,
-as in the \fB-l\fP logging option.
-.TP
-Print Window (print)
-Sends the text of the current window to the program given in the
-\fBprinterCommand\fP resource.
-.TP
-Redirect to Printer (print-redir)
-This sets the \fBprinterControlMode\fR to 0 or 2.
-You can use this to turn the printer on as if an application had sent
-the appropriate control sequence.
-It is also useful for switching the printer
-off if an application turns it on without resetting the print control mode.
-.RE
-.TP
-Modes for setting keyboard style:
-.RS
-.TP
-8-Bit Controls (8-bit-control)
-Enabled for VT220 emulation, this controls whether \fIxterm\fP will send
-8-bit control sequences rather than using 7-bit (ASCII) controls,
-e.g., sending a byte in the range 128-159 rather than the escape character
-followed by a second byte.
-\fIXterm\fP always interprets both 8-bit and 7-bit control sequences
-(see the document \fIXterm Control Sequences\fP).
-This corresponds to the \fBeightBitControl\fP resource.
-.TP
-Backarrow Key (BS/DEL) (backarrow\ key)
-Modifies the behavior of the backarrow key, making it transmit
-either a backspace (8)
-or delete (127) character.
-This corresponds to the \fBbackarrowKey\fP resource.
-.TP
-Alt/NumLock Modifiers (num-lock)
-Controls the treatment of Alt- and NumLock-key modifiers.
-This corresponds to the \fBnumLock\fP resource.
-.TP
-Meta Sends Escape (meta-esc)
-Controls whether \fIMeta\fP keys are converted into a two-character
-sequence with the character itself preceded by ESC.
-This corresponds to the \fBmetaSendsEscape\fP resource.
-.TP
-Delete is DEL (delete-is-del)
-Controls whether the Delete key on the editing keypad should send DEL (127)
-or the VT220-style Remove escape sequence.
-This corresponds to the \fBdeleteIsDEL\fP resource.
-.TP
-Old Function-Keys (oldFunctionKeys)
-.TP
-HP Function-Keys (hpFunctionKeys)
-.TP
-SCO Function-Keys (scoFunctionKeys)
-.TP
-Sun Function-Keys (sunFunctionKeys)
-.TP
-VT220 Keyboard (sunKeyboard)
-These act as a radio-button, selecting one style for the keyboard layout.
-It corresponds to more than one resource setting:
-.BR "sunKeyboard" ","
-.BR "sunFunctionKeys" ","
-.BR "scoFunctionKeys" " and"
-.BR "hpFunctionKeys "."
-.RE
-.TP
-Commands for process signalling:
-.RS
-.TP
-Send STOP Signal (suspend)
-.TP
-Send CONT Signal (continue)
-.TP
-Send INT Signal (interrupt)
-.TP
-Send HUP Signal (hangup)
-.TP
-Send TERM Signal (terminate)
-.TP
-Send KILL Signal (kill)
-These send the SIGTSTP, SIGCONT, SIGINT, SIGHUP, SIGTERM and SIGKILL
-signals respectively, to the process group of the process running under
-.I xterm
-(usually the shell).
-The
-.B SIGCONT
-function is especially useful if the user has accidentally typed CTRL-Z,
-suspending the process.
-.TP
-Quit (quit)
-Stop processing X events except to support the \fB-hold\fP option,
-and then send a SIGHUP signal to the
-the process group of the process running under
-.I xterm
-(usually the shell).
-.RE
-.PP
-.
-.\" ************************************************************************
-.PP
-The
-.I vtMenu
-sets various modes in the VT102 emulation, and is popped up when the
-``control'' key and pointer button two are pressed in the VT102 window.
-.TP
-VT102/VT220 Modes:
-.RS
-.
-.TP
-Enable Scrollbar (scrollbar)
-Enable (or disable) the scrollbar.
-This corresponds to the
-.B -sb
-option and the
-.B scrollBar
-resource.
-.
-.TP
-Enable Jump Scroll (jumpscroll)
-Enable (or disable) jump scrolling.
-This corresponds to the
-.B -j
-option and the
-.B jumpScroll
-resource.
-.
-.TP
-Enable Reverse Video (reversevideo)
-Enable (or disable) reverse-video.
-This corresponds to the
-.B -rv
-option and the
-.B reverseVideo
-resource.
-.
-.TP
-Enable Auto Wraparound (autowrap)
-Enable (or disable) auto-wraparound.
-This corresponds to the
-.B -aw
-option and the
-.B autoWrap
-resource.
-.
-.TP
-Enable Reverse Wraparound (reversewrap)
-Enable (or disable) reverse wraparound.
-This corresponds to the
-.B -rw
-option and the
-.B reverseWrap
-resource.
-.
-.TP
-Enable Auto Linefeed (autolinefeed)
-Enable (or disable) auto-linefeed.
-This is the VT102 NEL function,
-which causes the emulator to emit a linefeed after each carriage return.
-There is no corresponding command-line option or resource setting.
-.
-.TP
-Enable Application Cursor Keys (appcursor)
-Enable (or disable) application cursor keys.
-This corresponds to the
-.B appcursorDefault
-resource.
-There is no corresponding command-line option.
-.
-.TP
-Enable Application Keypad (appkeypad)
-Enable (or disable) application keypad keys.
-This corresponds to the
-.B appkeypadDefault
-resource.
-There is no corresponding command-line option.
-.
-.TP
-Scroll to Bottom on Key Press (scrollkey)
-Enable (or disable) scrolling to the bottom of the scrolling region on a keypress.
-This corresponds to the
-.B -sk
-option and the
-.B scrollKey
-resource.
-.
-.TP
-Scroll to Bottom on Tty Output (scrollttyoutput)
-Enable (or disable) scrolling to the bottom of the scrolling region on output to the terminal..
-This corresponds to the
-.B -si
-option and the
-.B scrollTtyOutput
-resource.
-.
-.TP
-Allow 80/132 Column Switching (allow132)
-Enable (or disable) switching between 80 and 132 columns.
-This corresponds to the
-.B -132
-option and the
-.B c132
-resource.
-.
-.TP
-Enable Curses Emulation (cursesemul)
-Enable (or disable) a workaround for the so-called "curses bug".
-This corresponds to the
-.B -cu
-option and the
-.B curses
-resource.
-.
-.TP
-Enable Visual Bell (visualbell)
-Enable (or disable) visible bell (i.e., flashing) instead of an audible bell.
-This corresponds to the
-.B -vb
-option and the
-.B visualBell
-resource.
-.
-.TP
-Enable Pop on Bell (poponbell)
-Enable (or disable) raising of the window when Control-G is received.
-This corresponds to the
-.B -pop
-option and the
-.B popOnBell
-resource.
-.
-.TP
-Enable Margin Bell (marginbell)
-Enable (or disable) a bell when the user types near the right margin.
-This corresponds to the
-.B -mb
-option and the
-.B marginBell
-resource.
-.
-.TP
-Enable Blinking Cursor (cursorblink)
-Enable (or disable) the blinking-cursor feature.
-This corresponds to the
-.B -bc
-option and the
-.B cursorBlink
-resource.
-There is also an escape sequence
-(see the document \fIXterm Control Sequences\fP).
-The menu entry and the escape sequence states are XOR'd:
-if both are enabled, the cursor will not blink,
-if only one is enabled, the cursor will blink.
-.
-.TP
-Enable Alternate Screen Switching (titeInhibit)
-Enable (or disable) switching between the normal and alternate screens.
-This corresponds to the
-.B titeInhibit
-resource.
-There is no corresponding command-line option.
-.
-.TP
-Enable Active Icon (activeicon)
-Enable (or disable) the active-icon feature.
-This corresponds to the
-.B -ai
-option and the
-.B activeIcon
-resource.
-.RE
-.
-.TP
-VT102/VT220 Commands:
-.RS
-.TP
-Do Soft Reset (softreset)
-Reset scroll regions.
-This can be convenient when some program has left the scroll regions
-set incorrectly (often a problem when using VMS or TOPS-20).
-This corresponds to the VT220 DECSTR control sequence.
-.
-.TP
-Do Full Reset (hardreset)
-The full reset entry will clear the screen, reset tabs to every
-eight columns, and reset the terminal modes (such as wrap and smooth scroll)
-to their initial states just after
-.I xterm
-has finished processing the command line options.
-This corresponds to the VT102 RIS control sequence,
-with a few obvious differences.
-For example, your session is not disconnected as a real VT102 would do.
-.
-.TP
-Reset and Clear Saved Lines (clearsavedlines)
-Perform a full reset,
-and also clear the saved lines.
-.RE
-.
-.TP
-Commands for setting the current screen:
-.RS
-.
-.TP
-Show Tek Window (tekshow)
-When enabled,
-pops the Tektronix 4014 window up (makes it visible).
-When disabled,
-hides the Tektronix 4014 window.
-.
-.TP
-Switch to Tek Mode (tekmode)
-When enabled,
-pops the Tektronix 4014 window up if it is not already visible,
-and switches the input stream to that window.
-When disabled,
-hides the Tektronix 4014 window and
-switches input back to the VTxxx window.
-.
-.TP
-Hide VT Window (vthide)
-When enabled,
-hides the VTxxx window,
-shows the Tektronix 4014 window if
-it was not already visible
-and switches the input stream to that window.
-When disabled,
-shows the VTxxx window,
-and switches the input stream to that window.
-.
-.TP
-Show Alternate Screen (altscreen)
-When enabled,
-shows the alternate screen.
-When disabled,
-shows the normal screen.
-Note that the normal screen may have saved lines;
-the alternate screen does not.
-.RE
-.PP
-.
-.PP
-The \fIfontMenu\fP sets the font used in the VT102 window,
-or modifies the way the font is specified or displayed.
-There are three sections.
-.PP
-The first section allows you to select the font from a set of alternatives:
-.RS
-.TP
-Default (fontdefault)
-Set the font to the default, i.e., that given by the
-.B *VT100.font
-resource.
-.TP
-Unreadable (font1)
-Set the font to that given by the
-.B *VT100.font1
-resource.
-.TP
-Tiny (font2)
-Set the font to that given by the
-.B *VT100.font2
-resource.
-.TP
-Small (font3)
-Set the font to that given by the
-.B *VT100.font3
-resource.
-.TP
-Medium (font4)
-Set the font to that given by the
-.B *VT100.font4
-resource.
-.TP
-Large (font5)
-Set the font to that given by the
-.B *VT100.font5
-resource.
-.TP
-Huge (font6)
-Set the font to that given by the
-.B *VT100.font6
-resource.
-.TP
-Escape Sequence
-This allows you to set the font last specified by the Set
-Font escape sequence (see the document \fIXterm Control Sequences\fP).
-.TP
-Selection (fontsel)
-This allows you to set the font specified
-the current selection as a font name (if the PRIMARY selection is owned).
-.RE
-.PP
-The second section allows you to modify the way it is displayed:
-.RS
-.TP
-Line-Drawing Characters (font-linedrawing)
-When set, tells \fIxterm\fP to draw its own line-drawing characters.
-Otherwise it relies on the font containing these.
-.TP
-Doublesized Characters (font-doublesize)
-When set, \fIxterm\fP may ask the font server to produce scaled versions
-of the normal font, for VT102 double-size characters.
-.RE
-.PP
-The third section allows you to modify the way it is specified:
-.RS
-.TP
-TrueType Fonts (render-font)
-If the
-.B "renderFont
-and corresponding resources were set,
-this is a further control whether \fIxterm\fP will actually use the
-Xft library calls to obtain a font.
-.TP
-UTF-8 (utf8-mode)
-This controls whether \fIxterm\fP uses UTF-8 encoding of input/output.
-It is useful for temporarily switching \fIxterm\fP to display
-text from an application which does not follow the locale settings.
-.RE
-.
-.PP
-The
-.I tekMenu
-sets various modes in the Tektronix emulation, and is popped up when the
-``control'' key and pointer button two are pressed in the Tektronix window.
-The current font size is checked in the modes section of the menu.
-.RS
-.TP
-Large Characters (tektextlarge)
-.TP
-\&#2 Size Characters (tektext2)
-.TP
-\&#3 Size Characters (tektext3)
-.TP
-Small Characters (tektextsmall)
-.RE
-.PP
-Commands:
-.RS
-.TP
-PAGE (tekpage)
-Clear the Tektronix window.
-.TP
-RESET (tekreset)
-.TP
-COPY (tekcopy)
-.RE
-.PP
-Windows:
-.RS
-.TP
-Show VT Window (vtshow)
-.TP
-Switch to VT Mode (vtmode)
-.TP
-Hide Tek Window (tekhide)
-.RE
-.
-.
-.SH SECURITY
-.
-.PP
-X environments differ in their security consciousness.
-Most servers,
-run under \fIxdm\fP,
-are capable of using a ``magic cookie'' authorization
-scheme that can provide a reasonable level of security for many people.
-If your server is only using a host-based mechanism to control access to
-the server (see \fIxhost(1)\fP), then if you enable access for a host and
-other users are also permitted to run clients on that same host,
-it is possible that someone can run an application which uses the
-basic services of the X protocol to snoop on your activities,
-potentially capturing a transcript of everything you type at the keyboard.
-Any process which has access to your X display can manipulate it
-in ways that you might not anticipate,
-even redirecting your keyboard to itself
-and sending events to your application's windows.
-This is true even with the ``magic cookie'' authorization scheme.
-While the \fBallowSendEvents\fP provides some protection against
-rogue applications tampering with your programs,
-guarding against a snooper is harder.
-.
-.PP
-The possibility of an application spying on your keystrokes
-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 is provided by X.
-Given all of these caveats,
-a simple mechanism exists for protecting keyboard input in \fIxterm\fP.
-.
-.PP
-The \fIxterm\fP menu (see \fBMENUS\fP above) contains a \fBSecure Keyboard\fP
-entry which, when enabled,
-attempts to ensure that all keyboard input is directed
-\fIonly\fP to \fIxterm\fP (using the GrabKeyboard protocol request).
-When an application prompts you for a password
-(or other sensitive data), you can enable \fBSecure Keyboard\fP using the
-menu, type in the data, and then disable \fBSecure Keyboard\fP using
-the menu again.
-This ensures that you know which window is accepting your keystrokes.
-It cannot ensure that there are no processes which have access to your
-X display that might be observing the keystrokes as well.
-.
-.PP
-Only one X client at a time can grab the keyboard,
-so when you attempt to enable \fBSecure Keyboard\fP it may fail.
-In this case, the bell will sound.
-If the \fBSecure Keyboard\fP succeeds,
-the foreground and background colors will be exchanged (as if you
-selected the \fBReverse Video\fP entry in the \fBModes\fP menu);
-they will be exchanged again when you exit secure mode.
-If the colors
-do \fInot\fP switch, then
-you should be \fIvery\fP 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 \fIbefore\fP the
-prompt gets displayed, and to make sure that the prompt gets displayed
-correctly (in the new colors), 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.
-.
-.PP
-\fBSecure Keyboard\fP mode will be disabled automatically if your \fIxterm\fP
-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 \fBSecure Keyboard\fP mode.
-(This is a
-feature of the X protocol not easily overcome.) When this happens,
-the foreground and background colors will be switched back and the bell
-will sound in warning.
-.
-.
-.SH "CHARACTER CLASSES"
-Clicking the left mouse button twice in rapid succession will cause all
-characters of the same class (e.g., letters, white space, punctuation) to be
-selected.
-Since 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 \fBcharClass\fP (class \fICharClass\fP) resource.
-.
-.PP
-This resource is a
-series of comma-separated
-of \fIrange\fP:\fIvalue\fP pairs.
-The
-\fIrange\fP is either a single number or \fIlow\fP-\fIhigh\fP in the range of 0
-to 65535, corresponding to the code for the character or characters to be
-set.
-The \fIvalue\fP is arbitrary, although the default table uses the
-character number of the first character occurring in the set.
-When not in
-UTF-8 mode, only the first 256 bytes of this table will be used.
-.
-.PP
-The default table starts as follows -
-.DS
-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 ! " # $ % & ' */
-.\" " <- for emacs autocolor to work well :-)
- 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,
-/\(** x80 x81 x82 x83 IND NEL SSA ESA */
- 1, 1, 1, 1, 1, 1, 1, 1,
-/\(** HTS HTJ VTS PLD PLU RI SS2 SS3 */
- 1, 1, 1, 1, 1, 1, 1, 1,
-/\(** DCS PU1 PU2 STS CCH MW SPA EPA */
- 1, 1, 1, 1, 1, 1, 1, 1,
-/\(** x98 x99 x9A CSI ST OSC PM APC */
- 1, 1, 1, 1, 1, 1, 1, 1,
-/\(** - i c/ L ox Y- | So */
- 160, 161, 162, 163, 164, 165, 166, 167,
-/\(** .. c0 ip << _ R0 - */
- 168, 169, 170, 171, 172, 173, 174, 175,
-/\(** o +- 2 3 ' u q| . */
- 176, 177, 178, 179, 180, 181, 182, 183,
-/\(** , 1 2 >> 1/4 1/2 3/4 ? */
- 184, 185, 186, 187, 188, 189, 190, 191,
-/\(** A` A' A^ A~ A: Ao AE C, */
- 48, 48, 48, 48, 48, 48, 48, 48,
-/\(** E` E' E^ E: I` I' I^ I: */
- 48, 48, 48, 48, 48, 48, 48, 48,
-/\(** D- N~ O` O' O^ O~ O: X */
- 48, 48, 48, 48, 48, 48, 48, 215,
-/\(** O/ U` U' U^ U: Y' P B */
- 48, 48, 48, 48, 48, 48, 48, 48,
-/\(** a` a' a^ a~ a: ao ae c, */
- 48, 48, 48, 48, 48, 48, 48, 48,
-/\(** e` e' e^ e: i` i' i^ i: */
- 48, 48, 48, 48, 48, 48, 48, 48,
-/\(** d n~ o` o' o^ o~ o: -: */
- 48, 48, 48, 48, 48, 48, 48, 247,
-/\(** o/ u` u' u^ u: y' P y: */
- 48, 48, 48, 48, 48, 48, 48, 48};
-.DE
-For example, the string ``33:48,37:48,45-47:48,38:48'' indicates that the
-exclamation mark, percent sign, dash, period, slash, and ampersand characters
-should be treated the same way as characters and numbers.
-This is useful
-for cutting and pasting electronic mailing addresses and filenames.
-.
-.
-.SH ACTIONS
-It is possible to rebind keys (or sequences of keys) to arbitrary strings
-for input, by changing the \fBtranslations\fP resources
-for the vt100 or tek4014 widgets.
-Changing the \fBtranslations\fP resource
-for events other than key and button events is not expected,
-and will cause unpredictable behavior.
-The following
-actions are provided for use within the \fIvt100\fP or \fItek4014\fP
-\fBtranslations\fP resources:
-.TP 8
-.B "allow-send-events(\fIon/off/toggle\fP)"
-This action set or toggles the \fBallowSendEvents\fP resource and is also
-invoked by the \fBallowsends\fP entry in \fImainMenu\fP.
-.TP 8
-.B "alt-sends-escape()"
-This action toggles the state of the \fBeightBitInput\fP resource.
-.TP 8
-.B "bell([\fIpercent\fP])"
-This action rings the keyboard bell at the specified percentage
-above or below the base volume.
-.TP 8
-.B "clear-saved-lines()"
-This action does \fBhard-reset()\fP (see below) and also clears the history
-of lines saved off the top of the screen.
-It is also invoked from the \fBclearsavedlines\fP entry in \fIvtMenu\fP.
-The effect is identical to a hardware reset (RIS) control sequence.
-.TP 8
-.B "create-menu(\fIm/v/f/t\fP)"
-This action creates one of the menus used by \fIxterm\fP,
-if it has not been previously created.
-The parameter values are the menu names:
-\fImainMenu\fP, \fIvtMenu\fP, \fIfontMenu\fP, \fItekMenu\fP, respectively.
-.TP 8
-.B "dabbrev-expand()"
-Expands the word before cursor by searching in the preceding text on the
-screen and in the scrollback buffer for words starting with that
-abbreviation.
-Repeating \fBdabbrev-expand()\fP several times in sequence searches for an
-alternative expansion by looking farther back.
-Lack of more matches is signaled by a \fBbeep()\fP.
-Attempts to expand an empty word
-(i.e., when cursor is preceded by a space) yield successively all previous
-words.
-Consecutive identical expansions are ignored.
-The word here is defined as a sequence of non-whitespace characters.
-This feature partially emulates the behavior
-of `dynamic abbreviation' expansion in Emacs (bound there to M-/).
-Here is a resource setting for \fIxterm\fP which will do the same thing:
-.DS
-*VT100*translations: #override \\n\\\&
- Meta <KeyPress> /:dabbrev-expand()
-.DE
-.TP 8
-.B "deiconify()"
-Changes the window state back to normal, if it was iconified.
-.TP 8
-.B "delete-is-del()"
-This action toggles the state of the \fBdeleteIsDEL\fP resource.
-.TP 8
-.B "dired-button()"
-Handles a button event (other than press and release)
-by echoing the event's position
-(i.e., character line and column) in the following format:
-.sp
-.in +8
-^X ESC G <line+' '> <col+' '>
-.in -8
-.TP 8
-.B "iconify()"
-Iconifies the window.
-.TP 8
-.B "hard-reset()"
-This action resets the scrolling region, tabs, window size, and cursor keys
-and clears the screen.
-It is also invoked from the \fBhardreset\fP
-entry in \fIvtMenu\fP.
-.TP 8
-.B "ignore()"
-This action ignores the event but checks for special pointer position
-escape sequences.
-.TP 8
-.B "insert()"
-This action inserts the character or string associated with
-the key that was pressed.
-.TP 8
-.B "insert-eight-bit()"
-This action inserts an eight-bit (Meta) version of the character or string
-associated with the key that was pressed.
-This only applies to single-byte values.
-The exact action depends on the value of
-the \fBmetaSendsEscape\fP and
-the \fBeightBitInput\fP resources.
-The \fBmetaSendsEscape\fP resource is tested first.
-.IP
-The term "eight-bit" is misleading:
-\fIxterm\fP checks if the key's value is less than 128.
-If so, \fIxterm\fP adds 128 to the value, setting its eighth bit.
-Otherwise \fIxterm\fP sends an ESC byte before the key.
-In other applications' documentation, that is referred to as a "meta key".
-.TP 8
-.B "insert-selection(\fIsourcename\fP [, ...])"
-This action inserts the string found in the selection or cutbuffer indicated
-by \fIsourcename\fP.
-Sources are checked in the order given (case is
-significant) until one is found.
-Commonly-used selections include:
-\fIPRIMARY\fP, \fISECONDARY\fP, and \fICLIPBOARD\fP.
-Cut buffers are
-typically named \fICUT_BUFFER0\fP through \fICUT_BUFFER7\fP.
-.TP 8
-.B "insert-seven-bit()"
-This action is a synonym for \fBinsert()\fP
-The term "seven-bit" is misleading:
-it only implies that \fIxterm\fP does not try to add 128 to the key's value
-as in \fBinsert-eight-bit()\fP.
-.TP 8
-.B "interpret(\fIcontrol-sequence\fP)"
-Interpret the given control sequence locally, i.e., without passing it to
-the host.
-This works by inserting the control sequence at the front
-of the input buffer.
-Use "\\" to escape octal digits in the string.
-Xt does not allow you to put a null character (i.e., "\\000") in the string.
-.TP 8
-.B "keymap(\fIname\fP)"
-This action dynamically defines a new translation table whose resource
-name is \fIname\fP with the suffix \fIKeymap\fP (case is significant).
-The name \fINone\fP restores the original translation table.
-.TP 8
-.B "larger-vt-font()"
-Set the font to the next larger one, based on the font dimensions.
-See also \fBset-vt-font()\fP.
-.TP 8
-.B "load-vt-fonts(\fIname\fP[,\fIclass\fP])"
-Load fontnames from the given subresource name and class.
-That is, load the "*VT100.\fIname\fP.font", resource as "*VT100.font" etc.
-If no name is given, the original set of fontnames is restored.
-.IP
-Unlike \fBset-vt-font()\fR, this does not affect the escape- and select-fonts,
-since those are not based on resource values.
-It does affect the fonts loosely organized under the ``Default'' menu
-entry: \fBfont\fP, \fBboldFont\fP, \fBwideFont\fP and \fBwideBoldFont\fP.
-.TP 8
-.B "maximize()"
-Resizes the window to fill the screen.
-.TP 8
-.B "meta-sends-escape()"
-This action toggles the state of the \fBmetaSendsEscape\fP resource.
-.TP 8
-.B "popup-menu(\fImenuname\fP)"
-This action displays the specified popup menu.
-Valid names (case is
-significant) include: \fImainMenu\fP, \fIvtMenu\fP, \fIfontMenu\fP,
-and \fItekMenu\fP.
-.TP 8
-.B "print()"
-This action prints the window and is also invoked by the
-\fIprint\fP entry in \fImainMenu\fP.
-.TP 8
-.B "print-redir()"
-This action toggles the \fBprinterControlMode\fR between 0 and 2.
-The corresponding popup menu entry is useful for switching the printer
-off if you happen to change your mind after deciding to print random
-binary files on the terminal.
-.TP 8
-.B "quit()"
-This action sends a SIGHUP to the subprogram and exits.
-It is also invoked
-by the \fBquit\fP entry in \fImainMenu\fP.
-.TP 8
-.B "redraw()"
-This action redraws the window and is also invoked by the
-\fIredraw\fP entry in \fImainMenu\fP.
-.TP 8
-.B "restore()"
-Restores the window to the size before it was last maximized.
-.TP 8
-.B "scroll-back(\fIcount\fP [,\fIunits\fP [,\fImouse\fP] ])"
-This action scrolls the text window backward so that text that had previously
-scrolled off the top of the screen is now visible.
-.IP
-The \fIcount\fP argument
-indicates the number of \fIunits\fP (which may be \fIpage\fP, \fIhalfpage\fP,
-\fIpixel\fP, or \fIline\fP) by which to scroll.
-.IP
-An adjustment can be specified for these values by appending a "+" or "-"
-sign followed by a number,
-e.g., \fIpage-2\fP to specify 2 lines less than a page.
-.IP
-If the third parameter \fImouse\fP is given, the action is ignored when
-mouse reporting is enabled.
-.TP 8
-.B "scroll-forw(\fIcount\fP [,\fIunits\fP [,\fImouse\fP] ])"
-This action is similar to \fBscroll-back\fP except that it scrolls
-in the other direction.
-.TP 8
-.B "secure()"
-This action toggles the \fISecure Keyboard\fP mode described in the
-section named \fBSECURITY\fP, and is invoked from the \fBsecurekbd\fP
-entry in \fImainMenu\fP.
-.TP 8
-.B "select-cursor-end(\fIdestname\fP [, ...])"
-This action is similar to \fBselect-end\fP except that it should be used
-with \fBselect-cursor-start\fP.
-.TP 8
-.B "select-cursor-start()"
-This action is similar to \fBselect-start\fP except that it begins the
-selection at the current text cursor position.
-.TP 8
-.B "select-end(\fIdestname\fP [, ...])"
-This action puts the currently selected text into all of the selections or
-cutbuffers specified by \fIdestname\fP.
-.TP 8
-.B "select-extend()"
-This action tracks the pointer and extends the selection.
-It should only be bound to Motion events.
-.TP 8
-.B "select-set()"
-This action stores text that corresponds to the current selection,
-without affecting the selection mode.
-.TP 8
-.B "select-start()"
-This action begins text selection at the current pointer location.
-See
-the section on \fBPOINTER USAGE\fP for information on making selections.
-.TP 8
-.B "send-signal(\fIsigname\fP)"
-This action sends the signal named by \fIsigname\fP
-to the \fIxterm\fP subprocess (the shell or program specified with
-the \fI-e\fP command line option) and is also invoked by the
-.BR suspend ,
-.BR continue ,
-.BR interrupt ,
-.BR hangup ,
-.BR terminate ,
-and
-.BR kill
-entries in \fImainMenu\fP.
-Allowable signal names are (case is
-not significant):
-\fItstp\fP (if supported by the operating system), \fIsuspend\fP (same
-as \fItstp\fP), \fIcont\fP
-(if supported by the operating system), \fIint\fP, \fIhup\fP, \fIterm\fP,
-\fIquit\fP,
-\fIalrm\fP, \fIalarm\fP (same as \fIalrm\fP) and \fIkill\fP.
-.TP 8
-.B "set-allow132(\fIon/off/toggle\fP)"
-This action toggles the \fBc132\fP resource and is also invoked from the
-\fBallow132\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-altscreen(\fIon/off/toggle\fP)"
-This action toggles between the alternate and current screens.
-.TP 8
-.B "set-appcursor(\fIon/off/toggle\fP)"
-This action toggles the handling Application Cursor Key mode
-and is also invoked by the \fBappcursor\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-appkeypad(\fIon/off/toggle\fP)"
-This action toggles the handling of Application Keypad mode and is also
-invoked by the \fBappkeypad\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-autolinefeed(\fIon/off/toggle\fP)"
-This action toggles automatic insertion of linefeeds and is also invoked by
-the \fBautolinefeed\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-autowrap(\fIon/off/toggle\fP)"
-This action toggles automatic wrapping of long lines and is also invoked by
-the \fBautowrap\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-backarrow(\fIon/off/toggle\fP)"
-This action toggles the \fBbackarrowKey\fP resource and is also invoked from the
-\fBbackarrow key\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-cursorblink(\fIon/off/toggle\fP)"
-This action toggles the \fBcursorBlink\fP resource and is also invoked from the
-\fBcursorblink\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-cursesemul(\fIon/off/toggle\fP)"
-This action toggles the \fBcurses\fP resource and is also invoked from the
-\fBcursesemul\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-font-doublesize(\fIon/off/toggle\fP)"
-This action toggles the \fBfontDoublesize\fP resource and is also invoked by
-the \fBfont-doublesize\fP entry in \fIfontMenu\fP.
-.TP 8
-.B "set-hp-function-keys(\fIon/off/toggle\fP)"
-This action toggles the \fBhpFunctionKeys\fP resource and is also invoked by
-the \fBhpFunctionKeys\fP entry in \fImainMenu\fP.
-.TP 8
-.B "set-jumpscroll(\fIon/off/toggle\fP)"
-This action toggles the \fBjumpscroll\fP resource and is also invoked by the
-\fBjumpscroll\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-font-linedrawing(\fIon/off/toggle\fP)"
-This action toggles the \fIxterm\fR's state regarding whether the current font
-has line-drawing characters and whether it should draw them directly.
-It is also invoked by the \fBfont-linedrawing\fP entry in \fIfontMenu\fP.
-.TP 8
-.B "set-logging()"
-This action toggles the state of the logging option.
-.TP 8
-.B "set-old-function-keys(\fIon/off/toggle\fP)"
-This action toggles the state of legacy function keys and is also invoked by
-the \fBoldFunctionKeys\fP entry in \fImainMenu\fP.
-.TP 8
-.B "set-marginbell(\fIon/off/toggle\fP)"
-This action toggles the \fBmarginBell\fP resource and is also invoked from
-the \fBmarginbell\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-num-lock()"
-This action toggles the state of the \fBnumLock\fP resource.
-.TP 8
-.B "set-pop-on-bell(\fIon/off/toggle\fP)"
-This action toggles the \fBpopOnBell\fP resource and is also invoked
-by the \fBpoponbell\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-render-font(\fIon/off/toggle\fP)"
-This action toggles the \fBrenderFont\fP resource and is also invoked by
-the \fBrender-font\fP entry in \fIfontMenu\fP.
-.TP 8
-.B "set-reverse-video(\fIon/off/toggle\fP)"
-This action toggles the \fBreverseVideo\fP resource and is also invoked by
-the \fBreversevideo\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-reversewrap(\fIon/off/toggle\fP)"
-This action toggles the \fBreverseWrap\fP resource and is also invoked by
-the \fBreversewrap\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-scroll-on-key(\fIon/off/toggle\fP)"
-This action toggles the \fBscrollKey\fP resource and is also invoked from
-the \fBscrollkey\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-scroll-on-tty-output(\fIon/off/toggle\fP)"
-This action toggles the \fBscrollTtyOutput\fP resource and is also invoked
-from the \fBscrollttyoutput\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-scrollbar(\fIon/off/toggle\fP)"
-This action toggles the \fBscrollbar\fP resource and is also invoked by
-the \fBscrollbar\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-sco-function-keys(\fIon/off/toggle\fP)"
-This action toggles the \fBscoFunctionKeys\fP resource and is also invoked by
-the \fBscoFunctionKeys\fP entry in \fImainMenu\fP.
-.TP 8
-.B "set-sun-function-keys(\fIon/off/toggle\fP)"
-This action toggles the \fBsunFunctionKeys\fP resource and is also invoked by
-the \fBsunFunctionKeys\fP entry in \fImainMenu\fP.
-.TP 8
-.B "set-sun-keyboard(\fIon/off/toggle\fP)"
-This action toggles the \fBsunKeyboard\fP resource and is also invoked by
-the \fBsunKeyboard\fP entry in \fImainMenu\fP.
-.TP 8
-.B "set-tek-text(\fIlarge/2/3/small\fP)"
-This action sets font used in the Tektronix window to the value of the
-resources \fBtektextlarge\fP, \fBtektext2\fP, \fBtektext3\fP, and
-\fBtektextsmall\fP according to the argument.
-It is also by the entries
-of the same names as the resources in \fItekMenu\fP.
-.TP 8
-.B "set-terminal-type(\fItype\fP)"
-This action directs output to either the \fIvt\fP or \fItek\fP windows,
-according to the \fItype\fP string.
-It is also invoked by the
-\fBtekmode\fP entry in \fIvtMenu\fP and the \fBvtmode\fP entry in
-\fItekMenu\fP.
-.TP 8
-.B "set-titeInhibit(\fIon/off/toggle\fP)"
-This action toggles the \fBtiteInhibit\fP resource,
-which controls switching between the alternate and current screens.
-.TP 8
-.\" should toggle "toolBar" resource (see note).
-.B "set-toolbar(\fIon/off/toggle\fP)"
-This action toggles the toolbar feature and is also invoked by
-the \fBtoolbar\fP entry in \fImainMenu\fP.
-.TP 8
-.B "set-utf8-mode(\fIon/off/toggle\fP)"
-This action toggles the \fButf8\fP resource and is also invoked by
-the \fButf8-mode\fP entry in \fIfontMenu\fP.
-.TP 8
-.B "set-visibility(\fIvt/tek\fP,\fIon/off/toggle\fP)"
-This action controls whether or not the \fIvt\fP or \fItek\fP windows are
-visible.
-It is also invoked from the \fBtekshow\fP and \fBvthide\fP entries
-in \fIvtMenu\fP and the \fBvtshow\fP and \fBtekhide\fP entries in
-\fItekMenu\fP.
-.TP 8
-.B "set-visual-bell(\fIon/off/toggle\fP)"
-This action toggles the \fBvisualBell\fP resource and is also invoked
-by the \fBvisualbell\fP entry in \fIvtMenu\fP.
-.TP 8
-.B "set-vt-font(\fId/1/2/3/4/5/6/e/s\fP [,\fInormalfont\fP [, \fIboldfont\fP]])"
-This action sets the font or fonts currently being used in the VT102 window.
-The first argument is a single character that specifies the font to be
-used:
-.RS 8
-.HP
-\fId\fP or \fID\fP indicate the default font (the font initially
-used when
-\fIxterm\fP was started),
-.HP
-\fI1\fP through \fI6\fP indicate the fonts
-specified by the \fIfont1\fP through \fIfont6\fP resources,
-.HP
-\fIe\fP or \fIE\fP
-indicate the normal and bold fonts that have been set through escape codes
-(or specified as the second and third action arguments, respectively), and
-.HP
-\fIs\fP or \fIS\fP indicate the font selection (as made by programs such as
-\fIxfontsel(1)\fP) indicated by the second action argument.
-.RE
-.IP
-If \fIxterm\fR is configured to support wide characters, an
-additional two optional parameters are recognized for the \fIe\fP argument:
-wide font and wide bold font.
-.TP 8
-.B "smaller-vt-font()"
-Set the font to the next smaller one, based on the font dimensions.
-See also \fBset-vt-font()\fP.
-.TP 8
-.B "soft-reset()"
-This action resets the scrolling region and is also invoked from the
-\fBsoftreset\fP entry in \fIvtMenu\fP.
-The effect is identical to a soft reset (DECSTR) control sequence.
-.TP 8
-.B "start-extend()"
-This action is similar to \fBselect-start\fP except that the
-selection is extended to the current pointer location.
-.TP 8
-.B "start-cursor-extend()"
-This action is similar to \fBselect-extend\fP except that the
-selection is extended to the current text cursor position.
-.TP 8
-.B "string(\fIstring\fP)"
-This action inserts the specified text string as if it had been typed.
-Quotation is necessary if the string contains whitespace or
-non-alphanumeric characters.
-If the string argument begins with the
-characters ``0x'', it is interpreted
-as a hex character constant.
-.TP 8
-.B "tek-copy()"
-This action copies the escape codes used to generate the current window
-contents to a file in the current directory beginning with the name COPY.
-It is also invoked from the \fItekcopy\fP entry in \fItekMenu\fP.
-.TP 8
-.B "tek-page()"
-This action clears the Tektronix window and is also invoked by the
-\fBtekpage\fP entry in \fItekMenu\fP.
-.TP 8
-.B "tek-reset()"
-This action resets the Tektronix window and is also invoked by the
-\fItekreset\fP entry in \fItekMenu\fP.
-.TP 8
-.B "vi-button()"
-Handles a button event (other than press and release)
-by echoing a control sequence computed from the event's line number
-in the screen relative to the current line:
-.sp
-.in +8
-ESC ^P
-.in -8
-or
-.in +8
-ESC ^N
-.in -8
-.sp
-according to whether the event is before, or after the current line,
-respectively.
-The ^N (or ^P) is repeated once for each line that the event differs
-from the current line.
-The control sequence is omitted altogether if the button event is on the
-current line.
-.TP 8
-.B "visual-bell()"
-This action flashes the window quickly.
-.
-.PP
-The Tektronix window also has the following action:
-.TP 8
-.B "gin-press(\fIl/L/m/M/r/R\fP)"
-This action sends the indicated graphics input code.
-.
-.PP
-The default bindings in the VT102 window are:
-.DS
-.ta 2.5i
- Shift <KeyPress> Prior:scroll-back(1,halfpage) \\n\\\&
- Shift <KeyPress> Next:scroll-forw(1,halfpage) \\n\\\&
- Shift <KeyPress> Select:select-cursor-start() \\\&
- select-cursor-end(PRIMARY, CUT_BUFFER0) \\n\\\&
- Shift <KeyPress> Insert:insert-selection(PRIMARY, CUT_BUFFER0) \\n\\\&
- Shift~Ctrl <KeyPress> KP_Add:larger-vt-font() \\n\\\&
- Shift Ctrl <KeyPress> KP_Add:smaller-vt-font() \\n\\\&
- Shift <KeyPress> KP_Subtract:smaller-vt-font() \\n\\\&
- ~Meta <KeyPress>:insert-seven-bit() \\n\\\&
- Meta <KeyPress>:insert-eight-bit() \\n\\\&
- !Ctrl <Btn1Down>:popup-menu(mainMenu) \\n\\\&
- !Lock Ctrl <Btn1Down>:popup-menu(mainMenu) \\n\\\&
- !Lock Ctrl @Num_Lock <Btn1Down>:popup-menu(mainMenu) \\n\\\&
- ! @Num_Lock Ctrl <Btn1Down>:popup-menu(mainMenu) \\n\\\&
- ~Meta <Btn1Down>:select-start() \\n\\\&
- ~Meta <Btn1Motion>:select-extend() \\n\\\&
- !Ctrl <Btn2Down>:popup-menu(vtMenu) \\n\\\&
- !Lock Ctrl <Btn2Down>:popup-menu(vtMenu) \\n\\\&
- !Lock Ctrl @Num_Lock <Btn2Down>:popup-menu(vtMenu) \\n\\\&
- ! @Num_Lock Ctrl <Btn2Down>:popup-menu(vtMenu) \\n\\\&
- ~Ctrl ~Meta <Btn2Down>:ignore() \\n\\\&
- Meta <Btn2Down>:clear-saved-lines() \\n\\\&
- ~Ctrl ~Meta <Btn2Up>:insert-selection(PRIMARY, CUT_BUFFER0) \\n\\\&
- !Ctrl <Btn3Down>:popup-menu(fontMenu) \\n\\\&
- !Lock Ctrl <Btn3Down>:popup-menu(fontMenu) \\n\\\&
- !Lock Ctrl @Num_Lock <Btn3Down>:popup-menu(fontMenu) \\n\\\&
- ! @Num_Lock Ctrl <Btn3Down>:popup-menu(fontMenu) \\n\\\&
- ~Ctrl ~Meta <Btn3Down>:start-extend() \\n\\\&
- ~Meta <Btn3Motion>:select-extend() \\n\\\&
- Ctrl <Btn4Down>:scroll-back(1,halfpage,m) \\n\\\&
- Lock Ctrl <Btn4Down>:scroll-back(1,halfpage,m) \\n\\\&
- Lock @Num_Lock Ctrl <Btn4Down>:scroll-back(1,halfpage,m) \\n\\\&
- @Num_Lock Ctrl <Btn4Down>:scroll-back(1,halfpage,m) \\n\\\&
- <Btn4Down>:scroll-back(5,line,m) \\n\\\&
- Ctrl <Btn5Down>:scroll-forw(1,halfpage,m) \\n\\\&
- Lock Ctrl <Btn5Down>:scroll-forw(1,halfpage,m) \\n\\\&
- Lock @Num_Lock Ctrl <Btn5Down>:scroll-forw(1,halfpage,m) \\n\\\&
- @Num_Lock Ctrl <Btn5Down>:scroll-forw(1,halfpage,m) \\n\\\&
- <Btn5Down>:scroll-forw(5,line,m) \\n\\\&
- <BtnUp>:select-end(PRIMARY, CUT_BUFFER0) \\n\\\&
- <BtnDown>:ignore()
-.DE
-.PP
-The default bindings in the Tektronix window are:
-.DS
-.ta 2.5i
- ~Meta<KeyPress>: insert-seven-bit() \\n\\\&
- Meta<KeyPress>: insert-eight-bit() \\n\\\&
- !Ctrl <Btn1Down>: popup-menu(mainMenu) \\n\\\&
- !Lock Ctrl <Btn1Down>: popup-menu(mainMenu) \\n\\\&
-!Lock Ctrl @Num_Lock <Btn1Down>: popup-menu(mainMenu) \\n\\\&
- !Ctrl @Num_Lock <Btn1Down>: popup-menu(mainMenu) \\n\\\&
- !Ctrl <Btn2Down>: popup-menu(tekMenu) \\n\\\&
- !Lock Ctrl <Btn2Down>: popup-menu(tekMenu) \\n\\\&
-!Lock Ctrl @Num_Lock <Btn2Down>: popup-menu(tekMenu) \\n\\\&
- !Ctrl @Num_Lock <Btn2Down>: popup-menu(tekMenu) \\n\\\&
- Shift ~Meta<Btn1Down>: gin-press(L) \\n\\\&
- ~Meta<Btn1Down>: gin-press(l) \\n\\\&
- Shift ~Meta<Btn2Down>: gin-press(M) \\n\\\&
- ~Meta<Btn2Down>: gin-press(m) \\n\\\&
- Shift ~Meta<Btn3Down>: gin-press(R) \\n\\\&
- ~Meta<Btn3Down>: gin-press(r)
-.DE
-.PP
-Here is an example which uses shifted select/paste to copy to the clipboard,
-and unshifted select/paste for the primary selection.
-In each case, a (different) cut buffer is
-also a target or source of the select/paste operation.
-It is important to remember however,
-that cut buffers store data in ISO-8859-1 encoding,
-while selections can store data in a variety of formats and encodings.
-While \fIxterm\fP owns the selection, it highlights it.
-When it loses the selection, it removes the corresponding highlight.
-But you can still paste from the corresponding cut buffer.
-.DS
-.ta .5i 1.5i
-*VT100*translations: #override \\n\\\&
- ~Shift~Ctrl<Btn2Up>: insert-selection(PRIMARY, CUT_BUFFER0) \\n\\\&
- Shift~Ctrl<Btn2Up>: insert-selection(CLIPBOARD, CUT_BUFFER1) \\n\\\&
- ~Shift<BtnUp>: select-end(PRIMARY, CUT_BUFFER0) \\n\\\&
- Shift<BtnUp>: select-end(CLIPBOARD, CUT_BUFFER1)
-.DE
-.PP
-Below is a sample how of the \fBkeymap()\fP action is used to add special
-keys for entering commonly-typed works:
-.DS
-.ta .5i 1.5i
-*VT100.Translations: #override <Key>F13: keymap(dbx)
-*VT100.dbxKeymap.translations: \\\&
- <Key>F14: keymap(None) \\n\\\&
- <Key>F17: string("next") string(0x0d) \\n\\\&
- <Key>F18: string("step") string(0x0d) \\n\\\&
- <Key>F19: string("continue") string(0x0d) \\n\\\&
- <Key>F20: string("print ") insert-selection(PRIMARY, CUT_BUFFER0)
-.DE
-.SH "CONTROL SEQUENCES AND KEYBOARD"
-The \fIXterm Control Sequences\fP document lists the control sequences which
-an application can send \fIxterm\fP to make it perform various operations.
-Most of these operations are standardized, from either the DEC or Tektronix
-terminals, or from more widely used standards such as ISO 6429.
-.
-.
-.SH ENVIRONMENT
-.I Xterm
-sets several environment variables:
-.TP 5
-DISPLAY
-is the display name,
-pointing to the X server (see \fBDISPLAY NAMES\fP in X(__miscmansuffix__)).
-.TP 5
-TERM
-is set according to the termcap (or terminfo) entry which it is using as
-a reference.
-.TP 5
-WINDOWID
-is set to the X window id number of the \fIxterm\fP window.
-.TP 5
-XTERM_SHELL
-is set to the pathname of the program which is invoked.
-Usually that is a shell program, e.g., \fB/bin/sh\fP.
-Since it is not necessarily a shell program however,
-it is distinct from ``SHELL''.
-.TP 5
-XTERM_VERSION
-is set to the string displayed by the \fB-version\fP option.
-That is normally an identifier for the X Window libraries used to
-build \fIxterm\fP, followed by
-\fIxterm\fP's patch number in parenthesis.
-The patch number is also part of the response to a Secondary Device Attributes
-(DA) control sequence (see \fIXterm Control Sequences\fP).
-.
-.PP
-Depending on your system configuration, \fIxterm\fP may also set the
-following:
-.TP 5
-COLUMNS
-the width of the \fIxterm\fP in characters (cf: "stty columns").
-.TP 5
-HOME
-when \fIxterm\fP is configured to update utmp.
-.TP 5
-LINES
-the height of the \fIxterm\fP in characters (cf: "stty rows").
-.TP 5
-LOGNAME
-when \fIxterm\fP is configured to update utmp.
-.TP 5
-SHELL
-when \fIxterm\fP is configured to update utmp.
-It is also set if you provide the shell name as the optional parameter.
-.TP 5
-TERMCAP
-the contents of the termcap entry corresponding to $TERM,
-with lines and columns values substituted
-for the actual size window you have created.
-.TP 5
-TERMINFO
-may be defined to a nonstandard location in the configure script.
-.\"
-.
-.
-.SH FILES
-The actual pathnames given may differ on your system.
-.TP 5
-\fI/etc/utmp\fP
-the system logfile, which records user logins.
-.TP 5
-\fI/etc/wtmp\fP
-the system logfile, which records user logins and logouts.
-.TP 5
-.I __apploaddir__/XTerm
-the \fIxterm\fP default application resources.
-.TP 5
-.I __apploaddir__/XTerm-color
-the \fIxterm\fP color application resources.
-If your display supports color, use this
-.in +10
-*customization: -color
-.in -10
-in your .Xdefaults file to
-automatically turn on color in \fIxterm\fP and similar applications.
-.
-.
-.SH ERROR MESSAGES
-Most of the fatal error messages from \fIxterm\fP use the following format:
-.RS
-xterm: Error \fIXXX\fP, errno \fIYYY\fP: \fIZZZ\fP
-.RE
-The \fIXXX\fP codes (which are used by \fIxterm\fP as its exit-code)
-are listed below, with a brief explanation.
-.TP 5
-1
-is used for miscellaneous errors, usually accompanied by a specific message,
-.TP
-11
-ERROR_FIONBIO
-.br
-main: ioctl() failed on FIONBIO
-.TP
-12
-ERROR_F_GETFL
-.br
-main: ioctl() failed on F_GETFL
-.TP
-13
-ERROR_F_SETFL
-.br
-main: ioctl() failed on F_SETFL
-.TP
-14
-ERROR_OPDEVTTY
-.br
-spawn: open() failed on /dev/tty
-.TP
-15
-ERROR_TIOCGETP
-.br
-spawn: ioctl() failed on TIOCGETP
-.TP
-17
-ERROR_PTSNAME
-.br
-spawn: ptsname() failed
-.TP
-18
-ERROR_OPPTSNAME
-.br
-spawn: open() failed on ptsname
-.TP
-19
-ERROR_PTEM
-.br
-spawn: ioctl() failed on I_PUSH/"ptem"
-.TP
-20
-ERROR_CONSEM
-.br
-spawn: ioctl() failed on I_PUSH/"consem"
-.TP
-21
-ERROR_LDTERM
-.br
-spawn: ioctl() failed on I_PUSH/"ldterm"
-.TP
-22
-ERROR_TTCOMPAT
-.br
-spawn: ioctl() failed on I_PUSH/"ttcompat"
-.TP
-23
-ERROR_TIOCSETP
-.br
-spawn: ioctl() failed on TIOCSETP
-.TP
-24
-ERROR_TIOCSETC
-.br
-spawn: ioctl() failed on TIOCSETC
-.TP
-25
-ERROR_TIOCSETD
-.br
-spawn: ioctl() failed on TIOCSETD
-.TP
-26
-ERROR_TIOCSLTC
-.br
-spawn: ioctl() failed on TIOCSLTC
-.TP
-27
-ERROR_TIOCLSET
-.br
-spawn: ioctl() failed on TIOCLSET
-.TP
-28
-ERROR_INIGROUPS
-.br
-spawn: initgroups() failed
-.TP
-29
-ERROR_FORK
-.br
-spawn: fork() failed
-.TP
-30
-ERROR_EXEC
-.br
-spawn: exec() failed
-.TP
-32
-ERROR_PTYS
-.br
-get_pty: not enough ptys
-.TP
-34
-ERROR_PTY_EXEC
-.br
-waiting for initial map
-.TP
-35
-ERROR_SETUID
-.br
-spawn: setuid() failed
-.TP
-36
-ERROR_INIT
-.br
-spawn: can't initialize window
-.TP
-46
-ERROR_TIOCKSET
-.br
-spawn: ioctl() failed on TIOCKSET
-.TP
-47
-ERROR_TIOCKSETC
-.br
-spawn: ioctl() failed on TIOCKSETC
-.TP
-48
-ERROR_SPREALLOC
-.br
-spawn: realloc of ttydev failed
-.TP
-49
-ERROR_LUMALLOC
-.br
-luit: command-line malloc failed
-.TP
-50
-ERROR_SELECT
-.br
-in_put: select() failed
-.TP
-54
-ERROR_VINIT
-.br
-VTInit: can't initialize window
-.TP
-57
-ERROR_KMMALLOC1
-.br
-HandleKeymapChange: malloc failed
-.TP
-60
-ERROR_TSELECT
-.br
-Tinput: select() failed
-.TP
-64
-ERROR_TINIT
-.br
-TekInit: can't initialize window
-.TP
-71
-ERROR_BMALLOC2
-.br
-SaltTextAway: malloc() failed
-.TP
-80
-ERROR_LOGEXEC
-.br
-StartLog: exec() failed
-.TP
-83
-ERROR_XERROR
-.br
-xerror: XError event
-.TP
-84
-ERROR_XIOERROR
-.br
-xioerror: X I/O error
-.TP
-90
-ERROR_SCALLOC
-.br
-Alloc: calloc() failed on base
-.TP
-91
-ERROR_SCALLOC2
-.br
-Alloc: calloc() failed on rows
-.TP
-92
-ERROR_SREALLOC
-.br
-ScreenResize: realloc() failed on alt base
-.TP
-96
-ERROR_RESIZE
-.br
-ScreenResize: malloc() or realloc() failed
-.TP
-102
-ERROR_SAVE_PTR
-.br
-ScrnPointers: malloc/realloc() failed
-.TP
-110
-ERROR_SBRALLOC
-.br
-ScrollBarOn: realloc() failed on base
-.TP
-111
-ERROR_SBRALLOC2
-.br
-ScrollBarOn: realloc() failed on rows
-.TP
-121
-ERROR_MMALLOC
-.br
-my_memmove: malloc/realloc failed
-.
-.
-.SH BUGS
-.
-.PP
-Large pastes do not work on some systems.
-This is not a bug in
-\fIxterm\fP; it is a bug in the pseudo terminal driver of those
-systems.
-\fIxterm\fP feeds large pastes to the pty only as fast as the pty
-will accept data, but some pty drivers do not return enough information
-to know if the write has succeeded.
-.
-.PP
-Many of the options are not resettable after
-.I xterm
-starts.
-.
-.PP
-This program still needs to be rewritten.
-It should be split into very
-modular sections, with the various emulators being completely separate
-widgets that do not know about each other.
-Ideally, you'd like to be able to
-pick and choose emulator widgets and stick them into a single control widget.
-.
-.PP
-There needs to be a dialog box to allow entry of the Tek COPY file name.
-.
-.
-.SH "SEE ALSO"
-resize(1), luit(1), X(__miscmansuffix__), pty(4), tty(4)
-.br
-\fIXterm Control Sequences\fP
-(this is the file ctlseqs.ms).
-.sp
-http://invisible-island.net/xterm/xterm.html
-.
-.
-.SH AUTHORS
-Far too many people, including:
-.sp
-Loretta Guarino Reid (DEC-UEG-WSL),
-Joel McCormack (DEC-UEG-WSL), Terry Weissman (DEC-UEG-WSL),
-Edward Moy (Berkeley), Ralph R. Swick (MIT-Athena),
-Mark Vandevoorde (MIT-Athena), Bob McNamara (DEC-MAD),
-Jim Gettys (MIT-Athena), Bob Scheifler (MIT X Consortium), Doug Mink (SAO),
-Steve Pitschke (Stellar), Ron Newman (MIT-Athena), Jim Fulton (MIT X
-Consortium), Dave Serisky (HP), Jonathan Kamens (MIT-Athena),
-Jason Bacon,
-Stephen P. Wall,
-David Wexelblat, and
-Thomas Dickey (XFree86 Project).