diff options
Diffstat (limited to 'nx-X11/programs/xterm/xterm.man')
| -rw-r--r-- | nx-X11/programs/xterm/xterm.man | 4418 |
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 -\ Size Characters (tektext2) -.TP -\ 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). |