-help

This causes xterm to print out a verbose message describing its options.

- 132

Normally, the VT102 DECCOLM escape sequence that switches between 80 and 132 column mode is ignored. This option causes the DECCOLM escape sequence to be recognized, and the xterm window will resize appropriately.

- ah

This option indicates that xterm should always highlight the text cursor. By default, xterm will display a hollow text cursor whenever the focus is lost or the pointer leaves the window.

+ ah

This option indicates that xterm should do text cursor highlighting based on focus.

- b number

This option specifies the size of the inner border (the distance between the outer edge of the characters and the window border) in pixels. The default is 2.

- cb

Set the vt100 resource cutToBeginningOfLine to FALSE.

+ cb

Set the vt100 resource cutToBeginningOfLlne to TRUE.

- cc characterclassrange:value[,...]

This sets classes indicated by the given ranges for using in selecting by words. See the section specifying character classes.

%geom

This option specifies the preferred size and position of the Tektronix window. It is shorthand for specifying the "*tekGeometry" resource.

# geom

This option specifies the preferred position of the icon window. It is shorthand for specifying the "*iconGeometry" resource.

- T string

This option specifies the title for xterm's windows. It is equivalent to - title.

- n string

This option specifies the icon name for xterm's windows. It is shorthand for specifying the "*iconName" resource. Note that this is not the same as the toolkit option - name (see below). The default icon name is the application name.

- r

This option indicates that reverse video should be simulated by swapping the foreground and background colors. It is equivalent to - rv.

- w number

This option specifies the width in pixels of the border surrounding the window. It is equivalent to - borderwidth or - bw.

- bg color

This option specifies the color to use for the background of the window. The default is "white. "

- bd color

This option specifies the color to use for the border of the window. The default is "black."

- bw number

This option specifies the width in pixels of the border surrounding the window.

- fg color

This option specifies the color to use for displaying text. The default is "black."

iconGeometry (class IconGeometry)

Specifies the preferred size and position of the application when iconified. It is not necessarily obeyed by all window managers.

iconName (class IconName)

Specifies the icon name. The default is the application name.

termName (class TermName)

Specifies the terminal type name to be set in the TERM environment variable.

title (class Title)

Specifies a string that may be used by the window manager when displaying this application.

allowSendEvents (class 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.

alwaysHighlight (class AlwaysHighlight)

Specifies whether or not xterm should always display a highlighted text cursor. By default, a hollow text cursor is displayed whenever the pointer moves out of the window or the window loses the input focus.

appcursorDefault (class A ppcursorDefault)

If "true," the cursor keys are initially in application mode. The default is "false."

appkeypadDefault (class AppkeypadDefault)

If "true," the keypad keys are initially in application mode. The default is "false."

autoWrap (class AutoWrap)

Specifies whether or not auto-wraparound should be enabled. The default is "true."

bellSuppressTime (class 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.

boldFont (class BoldFont)

Specifies the name of the bold font to use instead of overstriking.

c132 (class C132)

Specifies whether or not the VT102 DECCOLM escape sequence should be honored. The default is "false."

cutNewline (class 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."

cutToBeginningOfLine (class 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."

charClass (class CharClass)

Specifies comma-separated lists of character class bindings of the form [low- ]high: value. These are used in determining which sets of characters should be treated the same when doing cut and paste. See the section on specifying character classes.

width (class Width)

Specifies the width of the Tektronix window in pixels.

height (class Height)

Specifies the height of the Tektronix window in pixels.

fontLarge (class Font)

Specifies the large font to use in the Tektronix window.

font2 (class Font)

Specifies font number 2 to use in the Tektronix window.

font3 (class Font)

Specifies font number 3 to use in the Tektronix window.

fontSmall (class Font)

Specifies the small font to use in the Tektronix window.

initialFont (class InitialFont)

Specifies which of the four Tektronix fonts to use initially. Values are the same as for the settek-text action. The default is "large."

ginTerminator (class 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."

The mainMenu has the following entries:

securekbd (class SmeBSB)

This entry invokes the secure( ) action.

allowsends (class SmeBSB)

This entry invokes the allow-send-events(toggle) action.

redraw (class SmeBSB)

This entry invokes the redraw( ) action.

line1 (class SmeLine)

This is a separator.

suspend (class SmeBSB)

This entry invokes the send-signal(tstp) action on systems that support job control.

continue (class SmeBSB)

This entry invokes the send-signal(cont) action on systems that support job control.

Interrupt (class SmeBSB)

This entry invokes the send-signal(int) action.

hangup (class SmeBSB)

This entry invokes the send-signal(hup) action.

terminate (class SmeBSB)

This entry invokes the send-signal(term) action.

kill (class SmeBSB)

This entry invokes the send-signal(kill) action.

Iine2 (class SmeLine)

This is a separator.

quit (class SmeBSB)

This entry invokes the quit( ) action.

scrollbar (class SmeBSB)

This entry invokes the set-scrollbar(toggle) action.

jumpscroll (class SmeBSB)

This entry invokes the set-jumpscroll(toggle) action.

reversevideo (class SmeBSB)

This entry invokes the set-reverse-video(toggle) action.

autowrap (class SmeBSB)

This entry invokes the set-autowrap(toggle) action.

fontdefault (class SmeBSB)

This entry invokes the set-vt-font(d) action.

font1 (class SmeBSB)

This entry invokes the set-vt-font(1) action.

font2 (class SmeBSB)

This entry invokes the set-vt-font(2) action.

font3 (class SmeBSB)

This entry invokes the set-vt-font(3) action.

font4 (class SmeBSB)

This entry invokes the set-vt-font(4) action.

font5 (class SmeBSB)

This entry invokes the set-vt-font(5) action.

font6 (class SmeBSB)

This entry invokes the set-vt-font(6) action.

fontescape (class SmeBSB)

This entry invokes the set-vt-font(e) action.

fontsel (class SmeBSB)

This entry invokes the set-vt-font(s) action.

tektextlarge (class SmeBSB)

This entry invokes the set-tek-text(1) action.

tektext2 (class SmeBSB)

This entry invokes the set-tek-text(2) action.

tektext3 (class SmeBSB)

This entry invokes the set-tek-text(3) action.

tektextsmall (class SmeBSB)

This entry invokes the set-tek-text(s) action.

line1(class SmeLine)

This is a separator.

tekpage (class SmeBSB)

This entry invokes the tek-page( ) action.

tekreset (class SmeBSB)

This entry invokes the tek-reset( ) action.

tekcopy (class SmeBSB)

This entry invokes the tek-copy( ) action.

line2 (class SmeLine)

This is a separator.

vtshow (class SmeBSB)

This entry invokes the set-visibility(vt,toggle) action.

vtmode (class SmeBSB)

This entry invokes the set-terminal-type(vt) action.

tekhide (class SmeBSB)

This entry invokes the set-visibility(tek,toggle) action.

thickness (class Thickness)

Specifies the width in pixels of the scrollbar.

background (class Background)

Specifies the color to use for the background of the scrollbar.

foreground (class 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.

            static int charClass[128] = {

            /*  NUL SOH STX ETX EOT ENQ ACK BEL */ 

                32,  1,  1,  1,  1,  1,  1,  1,

            /*  BS HT NL VT NP CR SO SI */

                1,  32,  1,  1,  1,  1,  1,  1,

            /*  DLE DC1 DC2 DC3 DC4 NAK SYN ETB */

                1,  1,  1,  1,  1,  1,  1,  1,

            /*  CAN EM SUB ESC FS GS RS US */

                1,  1,  1,  1,  1,  1,  1,  1,

            /*  SP  !  "  #  $  %  &  ' */

                32, 33, 34, 35, 36, 37, 38, 39,

            /*  (  )  *  +  ,  -  . /  */

                40, 41, 42, 43, 44, 45, 46, 47,

            /*  0   1   2   3   4   5   6   7 */

                48, 48, 48, 48, 48, 48, 48, 48,

            /*  8 9 : ; < = > ? */

                48, 48, 58, 59, 60, 61, 62, 63,

            /*  @  A  B  C  D  E  F  G  */

                64, 48, 48, 48, 48, 48, 48, 48,

            /*  H  I  J  K  L  M  N  O  */

                48, 48, 48, 48, 48, 48, 48, 48,

            /*  P  Q  R  S  T  U  V  W  */

                48, 48, 48, 48, 48, 48, 48, 48,

            /*  X  Y  Z  [    ]  ^  _  */

                48, 48, 48, 91, 92, 93, 94, 48,

            /*  '  a  b  c  d  e  f  g  */

                96, 48, 48, 48, 48, 48, 48, 48,

            /*  h  i  j  k  I  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}; 

bell([percent])

This action rings the keyboard bell at the specified percentage above or below the base volume .

ignore( )

This action ignores the event but checks for special pointer position escape sequences.

insert( )

This action inserts the character or string associated with the key that was pressed.

insert-seven-bit( )

This action is a synonym for insert( )

insert-eight-bit( )

This action inserts an eight-bit (Meta) version of the character or string associated with the key that was pressed. The exact action depends on the value of the eightBitInput resource.

insert-selection(source name [, . . . ])

This action inserts the string found in the selection or cut buffer indicated by source name. Sources are checked in the order given (case is significant) until one is found. Commonly-used selections include: PRIMARY, SECONDARY, and CLIPBOARD. Cut buffers are typically named CUT_BUFFER0 through CUT_BUFFER7.

keymap(name)

This action dynamically defines a new translation table whose resource name is name with the suffix Keymap (case is significant). The name None restores the original translation table.

popup-menu(menuname)

This action displays the specified popup menu. Valid names (case is significant) include: mainMenu, vtMenu, fontMenu, and tekMenu.

secure( )

This action toggles the Secure Keyboard mode described in the section named SECURITY, and is invoked from the securekbd entry in mainMenu.

select-start( )

This action begins text selection at the current pointer location. See the section on POINTER USAGE for information on making selections.

select-extend( )

This action tracks the pointer and extends the selection. It should only be bound to Motion events.

select-end(destname [, ...])

This action puts the currently selected text into all of the selections or cut buffers specified by destname .

Shift < KeyPress> Prior:	scroll-back(l,halfpage) n
Shift < KeyPress> Next:	scroll-forw(l,halfpage) n
Shift < KeyPress> Select:	select-cursor-start( ) select-cursor-end(PRIMARY,CUT_BUFFER0) n
Shift < keyPress> Insert:	insert-selection(PRIMARY, CUT_BUFFER0) n
~Meta< KeyPress>:	insert-seven-bit( ) n
Meta< KeyPress>:	insert-eight-bit( ) n
!Ctrl < BtnDown>:	popup-menu(mainMenu) n
!Lock Ctrl < Btn1Down>:	popup-menu(mainMenu) n
~Meta < Btn1Down>:	select-start( ) n
~Meta < Btn1Motion>:	select-extend( ) n
!Ctrl < Btn2Down>:	popup-menu(vtMenu) n
!Lock Ctrl < Btn2Down>:	popup-menu(vtMenu) n
~Ctrl ~Meta < Btn2Down>:	ignore( ) n
~Ctrl ~Meta < Btn2Up>:	insert-selection(PRIMARY, CUT_BUFPER0) n
!Ctrl < Btn3Down>:	popup-menu(fontMenu) n
!Lock Ctrl < Btn3Down>:	popup-menu(fontMenu) n
~Ctrl ~Meta < Btn3Down>:	start-extend( ) n
~Meta < Btn3Motion>:	select-extend( ) n
< BtnUp>:	select-end(PRIMARY, CUT_BUFFER0) n
< BtnDown>:	bell(0)

The default bindings in the Tektronix window are:

~Meta< KeyPress>:	insert-seven-bit( ) n
Meta< KeyPress>:	insert-eight-bit( ) n
!Ctrl < BtnlDown>:	popup-menu(mainMenu) n
!Lock Ctrl < BtnlDown>:	popup-menu(mainMenu) n
!Ctrl < Btn2Down>:	popup-menu(tekMenu) n
!lock Ctrl < Btn2Down>:	popup-menu(tekMenu) n
Shift ~Meta< BtnlDown>:	gin-press(L) n
~Meta< BtnlDown>:	gin-press(l) n
Shift ~Meta< Btn2Down>:	gin-press(M) n
~Meta< Btn2Down>:	gin-press(m) n
Shift ~Meta< Btn3Down>:	gin-press(R) n
~Meta< Btn3Down>:	gin-press(r)

*VT100.Translations: # override < Key> F13: keymap(dbx)

*VT100.dbxKeymap.translations:

< Key> F14:	keymap(None) n
< Key> F17:	string("next") string(00d) n
< Key> F18:	string("step") string(00d) n
< Key> Fl9:	string("continue") string(00d) n
< Key> F20:	string("print ") insert-selection(PRIMARY,CUT_BUFFERO)

- bg color

If a bitmap image (or a single plane of an image) is displayed, this option can be used to specify the color to display for the "0" bits in the image.

- display display

This option allows you to specify the server to connect to; see X(1).

- fg color

If a bitmap image (or a single plane of an image) is displayed, this option can be used to specify the color to display for the "1" bits in the image.

- geometry geom

This option allows you to specify the size and position of the window. Typically you will only want to specify the position, and let the size default to the actual size of the image.

- help

Print out a short description of the allowable options.

- in file

This option allows the user to explicitly specify the input file on the command line. If no input file is given, the standard input is assumed.

- new

This option forces creation of a new colormap for displaying the image. If the image characteristics happen to match those of the display, this can get the image on the screen faster, but at the cost of using a new colormap (which on most displays will ease other windows to go technicolor) .

- noclick

Clicking any button in the window will terminate the application, unless this option is specified.
Termination can always be achieved by typing 'q', 'Q', or ctrl-c.

- plane number

You can select a single bit plane of the image to display with this option. Planes are numbered with zero being the least significant bit. This option can be used to figure out which plane to pass to xpr(1) for printing.

- raw

This option forces the image to be displayed with whatever color values happen to currently exist on the screen. This option is mostly useful when undumping an image back onto the same screen that the image originally came from, while the original windows are still on the screen, and results in getting the image on the screen faster.

- rv

If a bitmap image (or a single plane of an image) is displayed, this option forces the foreground and background colors to be swapped. This may be needed when displaying a bitmap image which has the color sense of pixel values "0" and "1" reversed from what they are on your display.

- std maptype

This option causes the image to be displayed using the specified Standard Colormap. The property name is obtained by converting the type to upper case, prepending "RGB_", and appending "_MAP". Typical types are "best", "default", and "gray". See xstdomap(1) for one way of creating Standard Corollas.

- vis vis-type-or-id

This option allows you to specify a particular visual or visual class. The default is to pick the "best" one. A particular class can be specified: "StaticGray", "GrayScale", "StaticColor", "PseudoColor", "DirectColor", or "TrueColor". Or "Match" can be specified, meaning use the same class as the source image. Alternatively, an exact visual id (specific to the server) can be specified, either as a hexadecimal number (prefixed with "0x") or as a decimal number. Finally, "default" can be specified, meaning to use the same class as the colormap of the root window. Case is not significant in any of these strings.