From f4092abdf94af6a99aff944d6264bc1284e8bdd4 Mon Sep 17 00:00:00 2001 From: Reinhard Tartler Date: Mon, 10 Oct 2011 17:43:39 +0200 Subject: Imported nx-X11-3.1.0-1.tar.gz Summary: Imported nx-X11-3.1.0-1.tar.gz Keywords: Imported nx-X11-3.1.0-1.tar.gz into Git repository --- nx-X11/programs/xterm/xterm.man | 4418 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 4418 insertions(+) create mode 100644 nx-X11/programs/xterm/xterm.man (limited to 'nx-X11/programs/xterm/xterm.man') diff --git a/nx-X11/programs/xterm/xterm.man b/nx-X11/programs/xterm/xterm.man new file mode 100644 index 000000000..36fa64df0 --- /dev/null +++ b/nx-X11/programs/xterm/xterm.man @@ -0,0 +1,4418 @@ +.\" $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 /: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 +.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 Prior:scroll-back(1,halfpage) \\n\\\& + Shift Next:scroll-forw(1,halfpage) \\n\\\& + Shift Select:select-cursor-start() \\\& + select-cursor-end(PRIMARY, CUT_BUFFER0) \\n\\\& + Shift Insert:insert-selection(PRIMARY, CUT_BUFFER0) \\n\\\& + Shift~Ctrl KP_Add:larger-vt-font() \\n\\\& + Shift Ctrl KP_Add:smaller-vt-font() \\n\\\& + Shift KP_Subtract:smaller-vt-font() \\n\\\& + ~Meta :insert-seven-bit() \\n\\\& + Meta :insert-eight-bit() \\n\\\& + !Ctrl :popup-menu(mainMenu) \\n\\\& + !Lock Ctrl :popup-menu(mainMenu) \\n\\\& + !Lock Ctrl @Num_Lock :popup-menu(mainMenu) \\n\\\& + ! @Num_Lock Ctrl :popup-menu(mainMenu) \\n\\\& + ~Meta :select-start() \\n\\\& + ~Meta :select-extend() \\n\\\& + !Ctrl :popup-menu(vtMenu) \\n\\\& + !Lock Ctrl :popup-menu(vtMenu) \\n\\\& + !Lock Ctrl @Num_Lock :popup-menu(vtMenu) \\n\\\& + ! @Num_Lock Ctrl :popup-menu(vtMenu) \\n\\\& + ~Ctrl ~Meta :ignore() \\n\\\& + Meta :clear-saved-lines() \\n\\\& + ~Ctrl ~Meta :insert-selection(PRIMARY, CUT_BUFFER0) \\n\\\& + !Ctrl :popup-menu(fontMenu) \\n\\\& + !Lock Ctrl :popup-menu(fontMenu) \\n\\\& + !Lock Ctrl @Num_Lock :popup-menu(fontMenu) \\n\\\& + ! @Num_Lock Ctrl :popup-menu(fontMenu) \\n\\\& + ~Ctrl ~Meta :start-extend() \\n\\\& + ~Meta :select-extend() \\n\\\& + Ctrl :scroll-back(1,halfpage,m) \\n\\\& + Lock Ctrl :scroll-back(1,halfpage,m) \\n\\\& + Lock @Num_Lock Ctrl :scroll-back(1,halfpage,m) \\n\\\& + @Num_Lock Ctrl :scroll-back(1,halfpage,m) \\n\\\& + :scroll-back(5,line,m) \\n\\\& + Ctrl :scroll-forw(1,halfpage,m) \\n\\\& + Lock Ctrl :scroll-forw(1,halfpage,m) \\n\\\& + Lock @Num_Lock Ctrl :scroll-forw(1,halfpage,m) \\n\\\& + @Num_Lock Ctrl :scroll-forw(1,halfpage,m) \\n\\\& + :scroll-forw(5,line,m) \\n\\\& + :select-end(PRIMARY, CUT_BUFFER0) \\n\\\& + :ignore() +.DE +.PP +The default bindings in the Tektronix window are: +.DS +.ta 2.5i + ~Meta: insert-seven-bit() \\n\\\& + Meta: insert-eight-bit() \\n\\\& + !Ctrl : popup-menu(mainMenu) \\n\\\& + !Lock Ctrl : popup-menu(mainMenu) \\n\\\& +!Lock Ctrl @Num_Lock : popup-menu(mainMenu) \\n\\\& + !Ctrl @Num_Lock : popup-menu(mainMenu) \\n\\\& + !Ctrl : popup-menu(tekMenu) \\n\\\& + !Lock Ctrl : popup-menu(tekMenu) \\n\\\& +!Lock Ctrl @Num_Lock : popup-menu(tekMenu) \\n\\\& + !Ctrl @Num_Lock : popup-menu(tekMenu) \\n\\\& + Shift ~Meta: gin-press(L) \\n\\\& + ~Meta: gin-press(l) \\n\\\& + Shift ~Meta: gin-press(M) \\n\\\& + ~Meta: gin-press(m) \\n\\\& + Shift ~Meta: gin-press(R) \\n\\\& + ~Meta: 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: insert-selection(PRIMARY, CUT_BUFFER0) \\n\\\& + Shift~Ctrl: insert-selection(CLIPBOARD, CUT_BUFFER1) \\n\\\& + ~Shift: select-end(PRIMARY, CUT_BUFFER0) \\n\\\& + Shift: 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 F13: keymap(dbx) +*VT100.dbxKeymap.translations: \\\& + F14: keymap(None) \\n\\\& + F17: string("next") string(0x0d) \\n\\\& + F18: string("step") string(0x0d) \\n\\\& + F19: string("continue") string(0x0d) \\n\\\& + 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). -- cgit v1.2.3