![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to xterm.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / new / X / xterm|
Return to xterm.1 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / new / X / xterm |
1.1 ! root 1: .TH XTERM 1 "1 Nov 1986" "X Version 10" ! 2: .SH NAME ! 3: xterm \- X window system terminal emulator ! 4: .SH SYNOPSIS ! 5: .B xterm ! 6: [ option ] ... ! 7: .SH DESCRIPTION ! 8: .I Xterm ! 9: is the ! 10: .I X ! 11: window system terminal emulator. ! 12: It attempts to emulate a DEC VT102 terminal ! 13: to provide a standard terminal type for programs not aware of the window ! 14: system directly. ! 15: Under 4.3BSD, Ultrix 1.2 and other systems with the capability, ! 16: .I xterm ! 17: supports the terminal resizing facilities built into the system. ! 18: .PP ! 19: In addition, ! 20: .I xterm ! 21: emulates the Tektronix 4015 in a separate window. ! 22: To maintain the correct aspect ratio (height/width), Tektronix graphics will ! 23: be restricted to the ! 24: largest box with a 4015's aspect ratio that will fit in the window. ! 25: This box is located in the upper left area of the window. ! 26: .PP ! 27: Both windows may be displayed at the same time, though only one window and ! 28: mode is active at a time. ! 29: Input will be displayed in the active window even if the mouse is in the other ! 30: window. ! 31: Switching between the active modes is possible under manual (menu) and program ! 32: (escape sequence) control. ! 33: .PP ! 34: .I Xterm ! 35: understands the following options. ! 36: If the option begins with a ! 37: .RB ` + ' ! 38: instead of a ! 39: .RB ` \- ', ! 40: the option is restored to its default value. ! 41: These options override those set in the ``.Xdefaults'' file (see the ! 42: .B "X DEFAULTS" ! 43: section). ! 44: .TP 12 ! 45: .B \-132 ! 46: Normally, the VT102 DECCOLM escape sequence that switches between 80 and ! 47: 132 column mode is ignored. ! 48: This option causes the DECCOLM escape sequence to be recognized, and the ! 49: .I xterm ! 50: window will resize appropriately. ! 51: .TP ! 52: .B \-C ! 53: When ! 54: .I xterm ! 55: is run on a Sun, this option causes messages normally destined for the ! 56: console device, to be displayed in the ! 57: .I xterm ! 58: window. ! 59: .TP ! 60: .B \-L ! 61: indicates that ! 62: .I xterm ! 63: is being called by ! 64: .IR init (8), ! 65: and should presume that its file descriptors ! 66: are already open on a slave pseudo-tty, and that ! 67: .IR getty (8) ! 68: should be ! 69: run rather than the user's shell. ! 70: This option should only be used by ! 71: .IR init (8) ! 72: .TP ! 73: .B \-ai ! 74: This option causes the icon to be a miniature representation of the window, ! 75: rather than the standard icon. ! 76: .TP ! 77: .B \-ar ! 78: This option turns on the auto-raise mode of ! 79: .IR xterm , ! 80: which automatically raises the window when the mouse cursor enters the ! 81: window. ! 82: .TP ! 83: .BI \-b " border" ! 84: .I Xterm ! 85: maintains an inner border (distance between characters and the window's ! 86: border) of one pixel. ! 87: The ! 88: .B \-b ! 89: option allows you to set the size of this border to ! 90: .I border. ! 91: .TP ! 92: .BI \-bd " color" ! 93: On color displays, determines the color of the (highlighted) border. ! 94: .TP ! 95: .BI \-bg " color" ! 96: On color displays, determines the color of the background. ! 97: .TP ! 98: .BI \-bw " borderwidth" ! 99: Allows you to specify the width of the window border in pixels. ! 100: .TP ! 101: .BI \-cr " color" ! 102: On color displays, determines the (highlighted) color of the text cursor; ! 103: default is the text (foreground) color. ! 104: .TP ! 105: .B \-cu ! 106: Several programs that use the ! 107: .IR curses (3x) ! 108: cursor motion package have some difficulties with VT102-compatible terminals. ! 109: The bug fixed with this option occurs with ! 110: .IR more (1) ! 111: on a file containing a line that is exactly the width of the window and ! 112: which is followed by line beginning with a tab. ! 113: Normally, the leading tabs disappear, but this option causes them to be ! 114: displayed correctly. ! 115: .TP ! 116: .B \-dw ! 117: When the ! 118: .I xterm ! 119: icon is deiconified, this option warps the mouse to the center of the window. ! 120: .TP ! 121: .BI \-e " command arguments" ! 122: The specified ! 123: .I command ! 124: will be executed in the window, rather than ! 125: starting a shell. ! 126: The command and the optional arguments must appear last on the ! 127: .I xterm ! 128: command line. ! 129: .TP ! 130: .BI \-fb " font" ! 131: The specified ! 132: .I font ! 133: will be used instead of the default bold font (which is ``vtbold''). ! 134: This font must be the same height and width as the normal font. ! 135: If only one of the normal or bold fonts is specified, it will be used as the ! 136: normal font and the bold font will be produced by overstriking this font. ! 137: .TP ! 138: .BI \-fg " color" ! 139: On color displays, determines the color of the text (foreground). ! 140: .TP ! 141: .BI \-fi " font" ! 142: Specifies the default font to be used for the miniature icon windows. ! 143: The usual value for the icon font is ``nil2''. ! 144: .TP ! 145: .BI \-fn " font" ! 146: The specified ! 147: .I font ! 148: will be used instead of the default font (which is ``vtsingle''). ! 149: Any fixed width font may be used. ! 150: .TP ! 151: .BI \-ft " font" ! 152: The specified ! 153: .I font ! 154: will be used in the title bar instead of the default font (which is ! 155: ``vtsingle''). ! 156: .TP ! 157: .B \-i ! 158: This option causes ! 159: .I xterm ! 160: to startup displaying the icon rather than the normal window. ! 161: .TP ! 162: .BI \-ib " file" ! 163: The ! 164: .IR file , ! 165: which is assumed to be in ! 166: .IR bitmap (1) ! 167: format, is read and the resulting bitmap is used in the icon when ! 168: in VT102 mode. ! 169: If only one bitmap file is specified, it is used for both modes. ! 170: If both the bitmap file names are null, no bitmap is used. ! 171: .TP ! 172: .BI \-it " file" ! 173: The ! 174: .IR file , ! 175: which is assumed to be in ! 176: .IR bitmap (1) ! 177: format, is read and the resulting bitmap is used in the icon when ! 178: in Tektronix mode. ! 179: If only one bitmap file is specified, it is used for both modes. ! 180: If both the bitmap file names are null, no bitmap is used. ! 181: .TP ! 182: .B \-j ! 183: .I Xterm ! 184: will `jump scroll'; when ! 185: .I xterm ! 186: falls behind scrolling ! 187: the screen, it will move multiple lines up at once. ! 188: The VT100 escape sequences for smooth scroll can be used to enable/disable ! 189: this feature from a program, ! 190: or the `Mode Menu' can be used to set it interactively. ! 191: .\"TP ! 192: .\"B \-k ! 193: .TP ! 194: .B \-l ! 195: Logging is turned on; all input from the pseudo tty is appended to the ! 196: logfile. ! 197: .TP ! 198: .BI \-lf " file" ! 199: This ! 200: .I file ! 201: specifies the file in which the log is written to, rather than the default ! 202: ``\fBXtermLog.\fIXXXXX\fR'' where ! 203: .I XXXXX ! 204: is the process id of ! 205: .I xterm ! 206: (the file is created in the directory ! 207: .I xterm ! 208: is started in, or the home directory for a login ! 209: .IR xterm ). ! 210: If ! 211: .I file ! 212: begins with a ``|'' then the rest of the string is assumed to be a command ! 213: to be executed by the shell, and a pipe is opened to the process. ! 214: .TP ! 215: .B \-ls ! 216: This option causes the shell run under ! 217: .I xterm ! 218: to be a login shell (the user's .login file is read and the initial directory ! 219: will be the home directory). ! 220: .TP ! 221: .B \-mb ! 222: This option turns on the right margin bell. ! 223: .TP ! 224: .BI \-ms " color" ! 225: On color displays, determines the color of the mouse cursor; default is the ! 226: text cursor color. ! 227: .TP ! 228: .BI \-n " windowname" ! 229: Allows you to set the name of the window for use by a window manager. ! 230: This name is displayed in the title bar, also. ! 231: .TP ! 232: .BI \-nb " number" ! 233: This ! 234: .I number ! 235: is used as the right margin distance in which the margin bell will ring ! 236: (the default is 10). ! 237: .TP ! 238: .BI \-po " number" ! 239: Normally, in page scroll mode, a ``page'' is defined to be the number of ! 240: lines in the scrolling region minus the page overlap, which is one by default. ! 241: .I Number ! 242: specifies a new page overlap. ! 243: .TP ! 244: .B \-ps ! 245: Page scroll mode is turned on. ! 246: After a ``page'' of lines is displayed, ! 247: .I xterm ! 248: will stop displaying any more lines and the text cursor will disappear. ! 249: Typing a carriage return will allow one more line to be scrolled (the ! 250: return is discarded). ! 251: Pressing the space bar (or any other printable character) allows another ! 252: page to be scrolled (the character is discarded). ! 253: Typing a control character allows another page to be scrolled, but the ! 254: control character is sent (e.g., the interrupt character). ! 255: .TP ! 256: .B \-r ! 257: The screen will be displayed with white characters on a black background, ! 258: rather than the default black on white. ! 259: This becomes the normal video mode, which is reversed by turning on the ! 260: reverse video mode. ! 261: .TP ! 262: .B \-rv ! 263: Same as ! 264: .BR \-r . ! 265: .TP ! 266: .B \-rw ! 267: This options turns on reverse-wraparound mode, that allows the cursor to ! 268: wraparound from the leftmost column to the rightmost column of the previous ! 269: line. ! 270: This is very useful in the shell to allow erasure backwards across the ! 271: previous line. ! 272: .TP ! 273: .B \-s ! 274: When this option is specified, xterm no longer scrolls synchronously ! 275: with the display. ! 276: .I Xterm ! 277: no longer attempts to keep the screen completely up to date while ! 278: scrolling, but can then run faster when network latencies are very high. ! 279: This is typically useful when using ! 280: .I xterm ! 281: across a very large internet or many hops. ! 282: .TP ! 283: .B \-sb ! 284: This option causes the scrollbar to be displayed during startup, with the ! 285: saving of lines scrolled off the top of the window being turned on. ! 286: .TP ! 287: .B \-si ! 288: When using the scrollbar to review previous lines of text, this option ! 289: causes the window to be repositioned automatically at the ! 290: bottom of the scroll region when input has arrived. ! 291: .TP ! 292: .B \-sk ! 293: When using the scrollbar to review pass lines of text, this option ! 294: causes the window to be repositioned automatically in the normal postion at the ! 295: bottom of the scroll region when a key is pressed. ! 296: .TP ! 297: .BI \-sl " number" ! 298: The ! 299: .I number ! 300: specifies the maximum number of lines to save that are scrolled off the top ! 301: of the window. ! 302: The default is 64 lines. ! 303: .TP ! 304: .B \-sn ! 305: By default, the status line is in revere-video (relative to the rest of the ! 306: window). ! 307: This option causes the status line to be in normal video (the status line ! 308: is still enclosed in a box). ! 309: .TP ! 310: .B \-st ! 311: This option causes the status line to be displayed on startup. ! 312: .TP ! 313: .B \-t ! 314: This option causes the initial ! 315: .I xterm ! 316: window to be the Tektronix window, rather than the normal VT102 window. ! 317: .TP ! 318: .B \-tb ! 319: This option causes the title bar to be displayed on startup. ! 320: .TP ! 321: .B \-ti ! 322: Normally in the icon, the window name is to the right of the bitmap. ! 323: This option causes the text to be under the icon. ! 324: .TP ! 325: .B \-vb ! 326: This option turns on the visual bell mode, which flashes the window on ! 327: receipt of a CTRL-G. ! 328: .TP ! 329: .B \-w ! 330: Same as ! 331: .BR \-bw . ! 332: .TP ! 333: .BI = geometry ! 334: .I Xterm ! 335: will take a normal X geometry specification for the VT102 window. ! 336: This takes the form of ``\fB=\fIwidth\fBx\fIheight\fB+\fIxoff\fB+\fIyoff\fR''. ! 337: See ! 338: .IR X (1) ! 339: for details of this specification. ! 340: .TP ! 341: .BI % geometry ! 342: This geometry specification applies to the Tektronix window. ! 343: .TP ! 344: .BI # geometry ! 345: This geometry specification applies to the icon position (the width and ! 346: height information are optional and otherwise ignored). ! 347: .TP ! 348: .IB host : display ! 349: Normally, ! 350: .I xterm ! 351: gets the host and display number to use from the environment ! 352: variable ``DISPLAY''. ! 353: One can, however specify them explicitly. ! 354: The ! 355: .I host ! 356: specifies which machine to create the window on, and ! 357: the ! 358: .I display ! 359: argument specifies the display number. ! 360: For example, ! 361: ``orpheus:1'' creates a shell window on display one on the machine ! 362: orpheus. ! 363: .SH "X DEFAULTS" ! 364: .I Xterm ! 365: allows you to preset defaults in a customization file in your home ! 366: directory, called ! 367: .BR .Xdefaults . ! 368: The format of the file is ``programname.keyword:string''. ! 369: See ! 370: .IR X (1) ! 371: for more details. ! 372: .I Xterm ! 373: obeys the convention for `MakeWindow' defaults. ! 374: Keywords recognized by ! 375: .I xterm ! 376: are listed below. ! 377: .TP 15 ! 378: .B ActiveIcon ! 379: If ``on'', ! 380: .I xterm ! 381: window icons(s) are miniature windows rather than static bitmaps. ! 382: .TP ! 383: .B AllowIconInput ! 384: If ``on'', then keyboard input is permitted when ! 385: .I xterm ! 386: windows are in their iconified state and the icon is a miniature window. ! 387: Keyboard input is always disabled when static bitmap icons are used. ! 388: .TP ! 389: .B AutoRaise ! 390: If ``on'', ! 391: .I xterm ! 392: window(s) are automatically raised when the mouse enters them. ! 393: .TP ! 394: .B Background ! 395: Set the background color. ! 396: .TP ! 397: .B BodyFont ! 398: Set the default font. ! 399: .TP ! 400: .B BoldFont ! 401: Specify a default bold font. ! 402: .TP ! 403: .B Border ! 404: Set the border color. ! 405: .TP ! 406: .B BorderWidth ! 407: Set the border width of the window. ! 408: .TP ! 409: .B C132 ! 410: If ``on'', allow the DECCOLM escape sequence to switch between 80 and 132 ! 411: column mode. ! 412: .TP ! 413: .B Curses ! 414: If ``on'', enable the ! 415: .IR curses (3x) ! 416: fix. ! 417: .TP ! 418: .B Cursor ! 419: Set the text cursor color. ! 420: .TP ! 421: .B DeiconifyWarp ! 422: If ``on'', warp the mouse to the center of the window after deiconification. ! 423: .TP ! 424: .B Foreground ! 425: Set the text color. ! 426: .TP ! 427: .B IconBitmap ! 428: Specifies the ! 429: .IR bitmap (1) ! 430: file to be used as the bitmap for VT102 mode icon. ! 431: .TP ! 432: .B IconFont ! 433: Specify the default font for miniature window icons. The usual value is ! 434: ``nil2''. ! 435: .TP ! 436: .B IconStartup ! 437: If ``on'', initially display the icon rather than the normal window. ! 438: .TP ! 439: .B InternalBorder ! 440: Set the space between the text and window border. ! 441: This is called padding above. ! 442: .TP ! 443: .B JumpScroll ! 444: If ``on'', jump scroll is enabled. ! 445: .\"TP ! 446: .\"B KeyBoard ! 447: .TP ! 448: .B LogFile ! 449: Specifies the log file or command to pipe to when logging is activated. ! 450: .TP ! 451: .B Logging ! 452: If ``on'', turn logging on initially. ! 453: .TP ! 454: .B LogInhibit ! 455: If ``on'', totally inhibit logging from being turned on. ! 456: .TP ! 457: .B LoginShell ! 458: If ``on'', make the shell executed a login shell. ! 459: .TP ! 460: .B MarginBell ! 461: If ``on'', turn on the margin bell. ! 462: .TP ! 463: .B MenuBorder ! 464: specifies the border width for the menus. The default is 2. ! 465: .TP ! 466: .B MenuPad ! 467: specifies the extra padding above and below the menu title. The default is 3. ! 468: .TP ! 469: .B MenuFont ! 470: specifies the font to be used within the menus. The default is the same ! 471: font used for the titlebar. ! 472: .TP ! 473: .B Mouse ! 474: Set the mouse cursor color. ! 475: .TP ! 476: .B NMarginBell ! 477: Set the margin bell right margin distance. ! 478: .TP ! 479: .B PageOverlap ! 480: Set the page overlap in page scroll mode. ! 481: .TP ! 482: .B PageScroll ! 483: If ``on'', turn on page scroll mode. ! 484: .TP ! 485: .B ReverseVideo ! 486: If ``on'', reverse the definition of foreground and background color. ! 487: .TP ! 488: .B ReverseWrap ! 489: If ``on'', turn on the reverse wraparound mode. ! 490: .TP ! 491: .B SaveLines ! 492: Set the number of lines to save when scrolled of the top of the window. ! 493: .TP ! 494: .B ScrollBar ! 495: If ``on'', show the scrollbar initially. ! 496: .TP ! 497: .B ScrollInput ! 498: If ``on'', reposition the scroll region at the bottom if ! 499: new input has arrived. ! 500: .TP ! 501: .B ScrollKey ! 502: If ``on'', reposition the scroll region at the bottom if ! 503: a key is pressed. ! 504: .TP ! 505: .B SignalInhibit ! 506: If ``on'', totally inhibit the sending of signals from the ! 507: .B xterm ! 508: menu. ! 509: .TP ! 510: .B StatusLine ! 511: If ``on'', show the status line on startup. ! 512: .TP ! 513: .B StatusNormal ! 514: If ``on'', make the status line normal video. ! 515: .TP ! 516: .B TekIconBitmap ! 517: Specifies the ! 518: .IR bitmap (1) ! 519: file to be used as the bitmap for Tektronix mode icon. ! 520: .TP ! 521: .B TekInhibit ! 522: If ``on'', totally inhibit going into Tektronix mode. ! 523: .TP ! 524: .B TextUnderIcon ! 525: If ``on'', place the icon text under the bitmap icon. ! 526: .TP ! 527: .B TitleBar ! 528: If ``on'', show the title bar on startup. ! 529: .TP ! 530: .B TitleFont ! 531: Set the font of the title bar text. ! 532: .TP ! 533: .B VisualBell ! 534: If ``on'', turn on visual bell mode at startup. ! 535: .SH EMULATIONS ! 536: The VT102 emulation is fairly complete, but does not support the blinking ! 537: character attribute nor the double-wide and double-size character sets. ! 538: .IR Termcap (5) ! 539: entries that work with ! 540: .I xterm ! 541: include ``xterms'', ``xterm'', ``vt102'', ``vt100'' and ``ansi'', and ! 542: .I xterm ! 543: automatically searches the termcap file in this order for these entries and then ! 544: sets the ``TERM'' and the ``TERMCAP'' environment variables. ! 545: .PP ! 546: Many of the special ! 547: .I xterm ! 548: features (like the scrollbar and logging) may be modified under program control ! 549: through a set of escape sequences different from the standard VT102 escape ! 550: sequences. ! 551: Also, many of the Sun tty escape sequences for resizing and moving ! 552: the window are also understood. ! 553: (See the ! 554: .I ``Xterm Control Sequences'' ! 555: document.) ! 556: .PP ! 557: The Tektronix 4015 emulation is also fairly good. ! 558: Four different font sizes and five different lines types are supported. ! 559: The Tektronix text and graphics commands are recorded internally by ! 560: .I xterm ! 561: and may be written to a file by sending the COPY escape sequence (or through ! 562: the ! 563: .B Tektronix ! 564: menu; see below). ! 565: The name of the file will be ! 566: ``\fBCOPY\fIyy\fB\-\fIMM\fB\-\fIdd\fB.\fIhh\fB:\fImm\fB:\fIss\fR'', where ! 567: .IR yy , ! 568: .IR MM , ! 569: .IR dd , ! 570: .IR hh , ! 571: .I mm ! 572: and ! 573: .I ss ! 574: are the year, month, day, hour, minute and second when the COPY was performed ! 575: (the file is created in the directory ! 576: .I xterm ! 577: is started in, or the home directory for a login ! 578: .IR xterm ). ! 579: .SH "MOUSE USAGE" ! 580: .PP ! 581: When using the mouse to create the VT102 window, a cursor and ! 582: a rubber banding box will outline where the window will be created on ! 583: the display. ! 584: If the left button is pressed, a HEIGHTxWIDTH (default 24x80) ! 585: size window will be created at the position where the button is released. ! 586: If the right button is pressed, a window the height of the display and ! 587: WIDTH (default 80) characters wide will be created. ! 588: If the center button is pressed and held down, the upper left hand corner ! 589: of the window is defined at this position. ! 590: An outline of the minimum size window is shown, and a popup window in ! 591: the upper left hand corner of the display will show the size in characters ! 592: of the window. ! 593: Moving the mouse (while still holding the button down) will enlarge the ! 594: window and the sizes in the pop up window will update accordingly. ! 595: Releasing the button will define the lower right hand corner ! 596: of the window. ! 597: .PP ! 598: Once the VT102 window is created, ! 599: .I xterm ! 600: allows you to save text and restore it within the same or other windows. ! 601: The button functions are enabled when holding down the ``shift'' key. ! 602: The left hand button takes the text from the cursor (at button release) ! 603: through the end of line (including the new line), saves it in the global cut ! 604: buffer, and immediately `retypes' the line, inserting it as keyboard input. ! 605: This provides a history mechanism. ! 606: The selected text is highlighted while the button is pressed. ! 607: Moving off the initial line will cancel the selection. ! 608: If there is no text beyond the initial cursor point, ! 609: .I xterm ! 610: will sound the bell, indicating an error. ! 611: .PP ! 612: The shifted center button is used to save text into the cut buffer. ! 613: Move the cursor to beginning of the text, ! 614: and then hold the button down while moving the cursor to the end of the region ! 615: and releasing the button. ! 616: The selected text is highlighted and is saved in the global cut buffer when ! 617: the button is released. ! 618: .PP ! 619: The shifted right hand button `types' (pastes) the text from the cut buffer, ! 620: inserting it as keyboard input. ! 621: By cutting and pasting pieces of text without trailing new lines, ! 622: you can take text from several places in different windows and form a command ! 623: to the shell, for example, or take output from a program and insert it into ! 624: your favorite editor. ! 625: Since the cut buffer is globally shared among different applications, ! 626: you should regard it as a `file' whose contents you know. ! 627: The terminal emulator and other text programs should be treating it as if it ! 628: were a text file, i.e. the text is delimited by new lines. ! 629: .PP ! 630: The scrollbar is composed of three parts, the scroll button at the top, the ! 631: recorder button in the middle and the scroll region at the bottom. ! 632: Pressing the middle button in any part of the scrollbar will display the ! 633: scrollbar menu; see the ! 634: .B MENUS ! 635: section below. ! 636: .PP ! 637: The scroll region displays the position and amount of text currently showing ! 638: in the window (highlighted) relative to the amount of text actually saved. ! 639: As more text is saved (up to the maximum), the size of the highlighted area ! 640: decreases. ! 641: Clicking the mouse with the left of right button in the scroll region will ! 642: position the top of the display window at the mouse position. ! 643: .PP ! 644: The recorder button shows the state of saving lines scrolled off the top ! 645: of the window. ! 646: Tape running reel to reel indicates on, while the tape hanging indicates off. ! 647: Clicking the left or right button in the recorder button toggles the state of ! 648: recording. ! 649: .PP ! 650: The scroll button causes the window to scroll up and down within the saved text. ! 651: The left button moves the window position up (the text scrolls downward), while ! 652: the right button moves the window position down (the text scrolls upward). ! 653: The amount of scrolling is modified by the ``shift'' and ``control'' keys. ! 654: Without either, the window scrolls a single line at a time. ! 655: Continuing to hold the button down will causes the text to continuously ! 656: scroll a line at a time. ! 657: .PP ! 658: The ``shift'' key causes the text to scroll a window full at a time (actually ! 659: it is one line less than a full window). ! 660: And the ``control'' key causes the text to be positioned at the extremes, ! 661: top or bottom. ! 662: .PP ! 663: When using the mouse to create the Tektronix window, a cursor and ! 664: a rubber banding box will outline where the window will be created on ! 665: the display. ! 666: If the left button is pressed, a default size window (750 pixels wide by ! 667: 565 pixel high) is created at the origin. ! 668: If the right button is pressed, a default size window is created ! 669: at the mouse position. ! 670: If the center button is pressed and held down, the upper left hand corner ! 671: of the window is defined at this position. ! 672: An outline of the minimum size window is shown, and a popup window in ! 673: the upper left hand corner of the display will appear, indicating Tektronix ! 674: mode. ! 675: Moving the mouse (while still holding the button down) will enlarge the ! 676: window. ! 677: Releasing the button will define the lower right hand corner ! 678: of the window. ! 679: .PP ! 680: Unlike the VT102 window, the Tektronix window dows not allow the copying of ! 681: text. ! 682: It does allow Tektronix GIN mode, and in this mode ! 683: the cursor will change from an arrow to a cross. ! 684: Pressing any key will send that key and the current coordinate of the ! 685: cross cursor. ! 686: Pressing the left, middle or right button will return the letters `l', `m', and ! 687: `r', respectively. ! 688: If the `shift' key is pressed when a mouse buton is pressed, the corresponding ! 689: upper case letter is sent. ! 690: To distinquish a mouse button from a key, the high bit of the character is ! 691: set (but this is bit is normally stripped unless the terminal mode is RAW; ! 692: see ! 693: .IR tty (4) ! 694: for details). ! 695: .SH MENUS ! 696: .I Xterm ! 697: has five different menus, named ! 698: .BR xterm , ! 699: .BR Modes , ! 700: .BR Tektronix , ! 701: .B Scrollbar ! 702: and ! 703: .BR Windows . ! 704: Each menu pops up under the correct combinations of key and button presses. ! 705: Most menus are divided into two section, separated by a horizontal line. ! 706: The top portion contains various modes that can be altered. ! 707: A check mark appears next to a mode that is currently active. ! 708: Selecting one of these modes toggles its state. ! 709: The bottom portion of the menu are command entries; selecting one of these ! 710: performs the indicated function. ! 711: .PP ! 712: The ! 713: .B xterm ! 714: menu pops up when the ``control'' key and the left button is pressed in a ! 715: window. ! 716: The menu title gives the version number of ! 717: .IR xterm . ! 718: The modes section contains items that apply to both the VT102 and Tektronix ! 719: windows. ! 720: Notable entries in the command section of the menu are the ! 721: .BR Continue , ! 722: .BR Suspend , ! 723: .BR Interrupt , ! 724: .BR Hangup , ! 725: .B Terminate ! 726: and ! 727: .B Kill ! 728: which sends the SIGCONT, SIGTSTP, SIGINT, SIGHUP, SIGTERM and ! 729: SIGKILL signals, respectively, to the process group of the process running ! 730: under ! 731: .I xterm ! 732: (usually the shell). ! 733: The ! 734: .B Continue ! 735: function is especially useful if the user has accidentally typed CTRL-Z, ! 736: suspending the process. ! 737: .PP ! 738: The ! 739: .B Modes ! 740: menu sets various modes in the VT102 emulation, and is popped up with the ! 741: ``control'' and middle button combination in the VT102 window. ! 742: In the command section of this menu, the soft reset entry will reset ! 743: scroll regions. ! 744: This can be convenient when some program has left the scroll regions ! 745: set incorrectly (often a problem when using VMS or TOPS-20). ! 746: The full reset entry will clear the screen, reset tabs to every ! 747: eight columns, and reset the terminal modes (such as wrap and smooth scroll) ! 748: to there initial states just after ! 749: .I xterm ! 750: has finish processing the command line options. ! 751: The ! 752: .B Tektronix ! 753: menu sets various modes in the Tektronix emulation, and is popped up with the ! 754: ``control'' and middle button combination in the Tektronix window. ! 755: The current font size is checked in the modes section of the menu. ! 756: The ! 757: .B PAGE ! 758: entry in the command section clears the Tektronix window. ! 759: .PP ! 760: The ! 761: .B Scrollbar ! 762: menu is popped up when the middle button is pressed within the scrollbar. ! 763: This menu allows several modes particular to the scrollbar to be set. ! 764: .PP ! 765: The ! 766: .B Windows ! 767: menu is not normally compiled into ! 768: .I xterm ! 769: as it duplicates functions that properly belong to window managers. It ! 770: may, however, be enabled at the discretion of your system builder. ! 771: .PP ! 772: If enabled, the ! 773: .B Windows ! 774: menu is a special menu that is popped up when the ``control'' key and ! 775: right button are pressed. ! 776: Listed in order of bottommost to topmost are the visible windows on the ! 777: display that are named. ! 778: The checked entry is the current window. ! 779: By selecting an entry, the corresponding window is raised to the top. ! 780: This is very useful when a particular window of interest ! 781: is obscured by many other windows. ! 782: .SH "OTHER FEATURES" ! 783: .I Xterm ! 784: automatically highlights the window border, text cursor and titlebar when the ! 785: mouse enters the window (selected) and unhighlights them when the mouse ! 786: leaves the window (unselected). ! 787: If the window is the focus window, then the window is highlighted no matter ! 788: where the mouse is. ! 789: .PP ! 790: The titlebar displays the name of the window in the center and on both ! 791: sides stripes appear when the window is selected (highlighted). ! 792: If both windows are showing, only the active window's titlebar is highlighted. ! 793: If the left, middle or right button is pressed in the stripped section of ! 794: the titlebar, the corresponding menu is popped up, without the need to ! 795: hold down the ``control'' key. ! 796: Pressing the mouse button in the center title of the titlebar causes ! 797: the window to automatically iconify. ! 798: Pressing a button in the icon deiconifies it. ! 799: In addition, if input comes in while ! 800: .I xterm ! 801: is iconified and the icon is a static bitmap, ! 802: a box is drawn around the icon title. ! 803: .PP ! 804: In VT102 mode, there are escape sequences to activate and deactivate ! 805: an alternate screen buffer, which is the same size as the display area ! 806: of the window. ! 807: When activated, the current screen is saved and replace with the alternate ! 808: screen. ! 809: Saving of lines scrolled off the top of the window and page scroll mode ! 810: are disabled, until the normal screen is restored. ! 811: The ! 812: .IR termcap (5) ! 813: entry for ! 814: .I xterm ! 815: allows the visual editor ! 816: .IR vi (1) ! 817: to switch to the alternate screen for editing, and restore the screen ! 818: on exit. ! 819: .PP ! 820: In either VT102 or Tektronix mode, there are escape sequences to change the ! 821: title in the title bar (which will also change the name of the windows and ! 822: icons) and to specify a new log file name. ! 823: .PP ! 824: By default, a miniature version of the VT102 or Tektronix window is ! 825: displayed when ! 826: .I xterm ! 827: is iconified. The choice of which miniature to display is made when ! 828: the full window(s) are iconified; if the Tek window is chosen in the ! 829: iconify operation, then the icon will be a miniature Tek window and if ! 830: the VT102 window is chosen, the icon will be a miniature VT102 window. ! 831: This choice is independent of the current mode (Tektronix/VT102). ! 832: .PP ! 833: As an option, the miniature window may be disabled and a bitmap of a ! 834: small VT102 window with titlebar and scrollbar can be ! 835: displayed in the icon when in VT102 mode, and a bitmap of a Tektronix ! 836: window with titlebar is displayed in Tektronix mode. ! 837: these bitmaps may be user-defined (see options above). ! 838: .SH ENVIRONMENT ! 839: .I Xterm ! 840: sets the environment variables ``TERM'' and ``TERMCAP'' properly for the ! 841: size window you have created. ! 842: It also uses and sets the environment ! 843: variable ``DISPLAY'' to specify which bit map display terminal to use. ! 844: The environment variable ``WINDOWID'' is set to the X window id number ! 845: of the ! 846: .I xterm ! 847: window. ! 848: .SH "SEE ALSO" ! 849: resize(1), X(1), pty(4), tty(4) ! 850: .br ! 851: .I ``Xterm Control Sequences'' ! 852: .SH BUGS ! 853: There is currently no way for a ! 854: .I xterm ! 855: window not to highlight itself when the mouse cursor enter it ! 856: while another window is the keyboard focus. ! 857: There needs to be a dialog box to allow entry of log file name ! 858: and the COPY file name. ! 859: Many of the options are not resettable after ! 860: .I xterm ! 861: starts. ! 862: .SH AUTHORS ! 863: Edward Moy (Berkeley), Ralph R. Swick (MIT-Athena), ! 864: Mark Vandevoorde (MIT-Athena), Bob McNamara (DEC-MAD), ! 865: Jim Gettys (MIT-Athena), Bob Scheifler (MIT-LCS), Doug Mink (SAO). ! 866: .sp ! 867: VMS and TOPS-20 are trademarks of Digital Equipment Corporation. ! 868: .sp ! 869: Copyright (c) 1984, 1985, 1986 by Massachusetts Institute of Technology. ! 870: .br ! 871: See ! 872: .IR X (1) ! 873: for a full copyright notice.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.