![[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 / man / man1|
Return to xterm.1 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / new / X / man / man1 |
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 \-ar ! 74: This option turns on the auto-raise mode of ! 75: .IR xterm , ! 76: which automatically raises the window when the mouse cursor enters the ! 77: window. ! 78: .TP ! 79: .BI \-b " border" ! 80: .I Xterm ! 81: maintains an inner border (distance between characters and the window's ! 82: border) of one pixel. ! 83: The ! 84: .B \-b ! 85: option allows you to set the size of this border to ! 86: .I border. ! 87: .TP ! 88: .BI \-bd " color" ! 89: On color displays, determines the color of the (highlighted) border. ! 90: .TP ! 91: .BI \-bg " color" ! 92: On color displays, determines the color of the background. ! 93: .TP ! 94: .B \-bi ! 95: This option forces the icon to be a static bitmap rather than the default ! 96: miniature window. ! 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 initially 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, the window is ! 289: normally repositioned automatically at the ! 290: bottom of the scroll region when input has arrived. This option disables ! 291: repositioning on input. ! 292: .TP ! 293: .B \-sk ! 294: When using the scrollbar to review pass lines of text, this option ! 295: causes the window to be repositioned automatically in the normal postion at the ! 296: bottom of the scroll region when a key is pressed. ! 297: .TP ! 298: .BI \-sl " number" ! 299: The ! 300: .I number ! 301: specifies the maximum number of lines to save that are scrolled off the top ! 302: of the window. ! 303: The default is 64 lines. ! 304: .TP ! 305: .B \-sn ! 306: By default, the status line is in revere-video (relative to the rest of the ! 307: window). ! 308: This option causes the status line to be in normal video (the status line ! 309: is still enclosed in a box). ! 310: .TP ! 311: .B \-st ! 312: This option causes the status line to be displayed on startup. ! 313: .TP ! 314: .B \-t ! 315: This option causes the initial ! 316: .I xterm ! 317: window to be the Tektronix window, rather than the normal VT102 window. ! 318: .TP ! 319: .B \-tb ! 320: This option disables the title bar from being displayed on startup. ! 321: .TP ! 322: .B \-ti ! 323: Normally in the icon, the window name is to the right of the bitmap. ! 324: This option causes the text to be under the icon. ! 325: .TP ! 326: .B \-vb ! 327: This option turns on the visual bell mode, which flashes the window on ! 328: receipt of a CTRL-G. ! 329: .TP ! 330: .B \-w ! 331: Same as ! 332: .BR \-bw . ! 333: .TP ! 334: .BI = geometry ! 335: .I Xterm ! 336: will take a normal X geometry specification for the VT102 window. ! 337: This takes the form of ``\fB=\fIwidth\fBx\fIheight\fB+\fIxoff\fB+\fIyoff\fR''. ! 338: See ! 339: .IR X (1) ! 340: for details of this specification. ! 341: .TP ! 342: .BI % geometry ! 343: This geometry specification applies to the Tektronix window. ! 344: .TP ! 345: .BI # geometry ! 346: This geometry specification applies to the icon position (the width and ! 347: height information are optional and otherwise ignored). ! 348: .TP ! 349: .IB host : display ! 350: Normally, ! 351: .I xterm ! 352: gets the host and display number to use from the environment ! 353: variable ``DISPLAY''. ! 354: One can, however specify them explicitly. ! 355: The ! 356: .I host ! 357: specifies which machine to create the window on, and ! 358: the ! 359: .I display ! 360: argument specifies the display number. ! 361: For example, ! 362: ``orpheus:1'' creates a shell window on display one on the machine ! 363: orpheus. ! 364: .SH "X DEFAULTS" ! 365: .I Xterm ! 366: allows you to preset defaults in a customization file in your home ! 367: directory, called ! 368: .BR .Xdefaults . ! 369: The format of the file is ``programname.keyword:string''. ! 370: See ! 371: .IR X (1) ! 372: for more details. ! 373: .I Xterm ! 374: obeys the convention for `MakeWindow' defaults. ! 375: Keywords recognized by ! 376: .I xterm ! 377: are listed below. ! 378: .TP 15 ! 379: .B ActiveIcon ! 380: If ``off'', ! 381: .I xterm ! 382: window icons(s) are static bitmaps rather than miniature windows. ! 383: .TP ! 384: .B AllowIconInput ! 385: If ``on'', then keyboard input is permitted when ! 386: .I xterm ! 387: windows are in their iconified state and the icon is a miniature window. ! 388: Keyboard input is always disabled when static bitmap icons are used. ! 389: .TP ! 390: .B AutoRaise ! 391: If ``on'', ! 392: .I xterm ! 393: window(s) are automatically raised when the mouse enters them. ! 394: .TP ! 395: .B Background ! 396: Set the background color. ! 397: .TP ! 398: .B BodyFont ! 399: Set the default font. ! 400: .TP ! 401: .B BoldFont ! 402: Specify a default bold font. ! 403: .TP ! 404: .B Border ! 405: Set the border color. ! 406: .TP ! 407: .B BorderWidth ! 408: Set the border width of the window. ! 409: .TP ! 410: .B C132 ! 411: If ``on'', allow the DECCOLM escape sequence to switch between 80 and 132 ! 412: column mode. ! 413: .TP ! 414: .B Curses ! 415: If ``on'', enable the ! 416: .IR curses (3x) ! 417: fix. ! 418: .TP ! 419: .B Cursor ! 420: Set the text cursor color. ! 421: .TP ! 422: .B DeiconifyWarp ! 423: If ``on'', warp the mouse to the center of the window after deiconification. ! 424: .TP ! 425: .B Foreground ! 426: Set the text color. ! 427: .TP ! 428: .B IconBitmap ! 429: Specifies the ! 430: .IR bitmap (1) ! 431: file to be used as the bitmap for VT102 mode icon. ! 432: .TP ! 433: .B IconFont ! 434: Specify the default font for miniature window icons. The usual value is ! 435: ``nil2''. ! 436: .TP ! 437: .B IconStartup ! 438: If ``on'', initially display the icon rather than the normal window. ! 439: .TP ! 440: .B InternalBorder ! 441: Set the space between the text and window border. ! 442: This is called padding above. ! 443: .TP ! 444: .B JumpScroll ! 445: If ``on'', jump scroll is enabled. ! 446: .\"TP ! 447: .\"B KeyBoard ! 448: .TP ! 449: .B LogFile ! 450: Specifies the log file or command to pipe to when logging is activated. ! 451: .TP ! 452: .B Logging ! 453: If ``on'', turn logging on initially. ! 454: .TP ! 455: .B LogInhibit ! 456: If ``on'', totally inhibit logging from being turned on. ! 457: .TP ! 458: .B LoginShell ! 459: If ``on'', make the shell executed a login shell. ! 460: .TP ! 461: .B MarginBell ! 462: If ``on'', turn on the margin bell. ! 463: .TP ! 464: .B MenuBorder ! 465: specifies the border width for the menus. The default is 2. ! 466: .TP ! 467: .B MenuPad ! 468: specifies the extra padding above and below the menu title. The default is 3. ! 469: .TP ! 470: .B MenuFont ! 471: specifies the font to be used within the menus. The default is the same ! 472: font used for the titlebar. ! 473: .TP ! 474: .B Mouse ! 475: Set the mouse cursor color. ! 476: .TP ! 477: .B NMarginBell ! 478: Set the margin bell right margin distance. ! 479: .TP ! 480: .B PageOverlap ! 481: Set the page overlap in page scroll mode. ! 482: .TP ! 483: .B PageScroll ! 484: If ``on'', turn on page scroll mode. ! 485: .TP ! 486: .B ReverseVideo ! 487: If ``on'', reverse the definition of foreground and background color. ! 488: .TP ! 489: .B ReverseWrap ! 490: If ``on'', turn on the reverse wraparound mode. ! 491: .TP ! 492: .B SaveLines ! 493: Set the number of lines to save when scrolled of the top of the window. ! 494: .TP ! 495: .B ScrollBar ! 496: If ``on'', show the scrollbar initially. ! 497: .TP ! 498: .B ScrollInput ! 499: If ``off'', disable repositioning the scroll region at the bottom if ! 500: new input has arrived. ! 501: .TP ! 502: .B ScrollKey ! 503: If ``on'', reposition the scroll region at the bottom if ! 504: a key is pressed. ! 505: .TP ! 506: .B SignalInhibit ! 507: If ``on'', totally inhibit the sending of signals from the ! 508: .B xterm ! 509: menu. ! 510: .TP ! 511: .B StatusLine ! 512: If ``on'', show the status line on startup. ! 513: .TP ! 514: .B StatusNormal ! 515: If ``on'', make the status line normal video. ! 516: .TP ! 517: .B TekIconBitmap ! 518: Specifies the ! 519: .IR bitmap (1) ! 520: file to be used as the bitmap for Tektronix mode icon. ! 521: .TP ! 522: .B TekInhibit ! 523: If ``on'', totally inhibit going into Tektronix mode. ! 524: .TP ! 525: .B TextUnderIcon ! 526: If ``on'', place the icon text under the bitmap icon. ! 527: .TP ! 528: .B TitleBar ! 529: If ``off'', don't show the title bar on startup. ! 530: .TP ! 531: .B TitleFont ! 532: Set the font of the title bar text. ! 533: .TP ! 534: .B VisualBell ! 535: If ``on'', turn on visual bell mode at startup. ! 536: .SH EMULATIONS ! 537: The VT102 emulation is fairly complete, but does not support the blinking ! 538: character attribute nor the double-wide and double-size character sets. ! 539: .IR Termcap (5) ! 540: entries that work with ! 541: .I xterm ! 542: include ``xterms'', ``xterm'', ``vt102'', ``vt100'' and ``ansi'', and ! 543: .I xterm ! 544: automatically searches the termcap file in this order for these entries and then ! 545: sets the ``TERM'' and the ``TERMCAP'' environment variables. ! 546: .PP ! 547: Many of the special ! 548: .I xterm ! 549: features (like the scrollbar and logging) may be modified under program control ! 550: through a set of escape sequences different from the standard VT102 escape ! 551: sequences. ! 552: Also, many of the Sun tty escape sequences for resizing and moving ! 553: the window are also understood. ! 554: (See the ! 555: .I ``Xterm Control Sequences'' ! 556: document.) ! 557: .PP ! 558: The Tektronix 4015 emulation is also fairly good. ! 559: Four different font sizes and five different lines types are supported. ! 560: The Tektronix text and graphics commands are recorded internally by ! 561: .I xterm ! 562: and may be written to a file by sending the COPY escape sequence (or through ! 563: the ! 564: .B Tektronix ! 565: menu; see below). ! 566: The name of the file will be ! 567: ``\fBCOPY\fIyy\fB\-\fIMM\fB\-\fIdd\fB.\fIhh\fB:\fImm\fB:\fIss\fR'', where ! 568: .IR yy , ! 569: .IR MM , ! 570: .IR dd , ! 571: .IR hh , ! 572: .I mm ! 573: and ! 574: .I ss ! 575: are the year, month, day, hour, minute and second when the COPY was performed ! 576: (the file is created in the directory ! 577: .I xterm ! 578: is started in, or the home directory for a login ! 579: .IR xterm ). ! 580: .SH "MOUSE USAGE" ! 581: .PP ! 582: When using the mouse to create the VT102 window, a cursor and ! 583: a rubber banding box will outline where the window will be created on ! 584: the display. ! 585: If the left button is pressed, a HEIGHTxWIDTH (default 24x80) ! 586: size window will be created at the position where the button is released. ! 587: If the right button is pressed, a window the height of the display and ! 588: WIDTH (default 80) characters wide will be created. ! 589: If the center button is pressed and held down, the upper left hand corner ! 590: of the window is defined at this position. ! 591: An outline of the minimum size window is shown, and a popup window in ! 592: the upper left hand corner of the display will show the size in characters ! 593: of the window. ! 594: Moving the mouse (while still holding the button down) will enlarge the ! 595: window and the sizes in the pop up window will update accordingly. ! 596: Releasing the button will define the lower right hand corner ! 597: of the window. ! 598: .PP ! 599: Once the VT102 window is created, ! 600: .I xterm ! 601: allows you to save text and restore it within the same or other windows. ! 602: The button functions are enabled when holding down the ``shift'' key. ! 603: The left hand button takes the text from the cursor (at button release) ! 604: through the end of line (including the new line), saves it in the global cut ! 605: buffer, and immediately `retypes' the line, inserting it as keyboard input. ! 606: This provides a history mechanism. ! 607: The selected text is highlighted while the button is pressed. ! 608: Moving off the initial line will cancel the selection. ! 609: If there is no text beyond the initial cursor point, ! 610: .I xterm ! 611: will sound the bell, indicating an error. ! 612: .PP ! 613: The shifted center button is used to save text into the cut buffer. ! 614: Move the cursor to beginning of the text, ! 615: and then hold the button down while moving the cursor to the end of the region ! 616: and releasing the button. ! 617: The selected text is highlighted and is saved in the global cut buffer when ! 618: the button is released. ! 619: .PP ! 620: The shifted right hand button `types' (pastes) the text from the cut buffer, ! 621: inserting it as keyboard input. ! 622: By cutting and pasting pieces of text without trailing new lines, ! 623: you can take text from several places in different windows and form a command ! 624: to the shell, for example, or take output from a program and insert it into ! 625: your favorite editor. ! 626: Since the cut buffer is globally shared among different applications, ! 627: you should regard it as a `file' whose contents you know. ! 628: The terminal emulator and other text programs should be treating it as if it ! 629: were a text file, i.e. the text is delimited by new lines. ! 630: .PP ! 631: The scrollbar is composed of three parts, the scroll button at the top, the ! 632: recorder button in the middle and the scroll region at the bottom. ! 633: Pressing the middle button in any part of the scrollbar will display the ! 634: scrollbar menu; see the ! 635: .B MENUS ! 636: section below. ! 637: .PP ! 638: The scroll region displays the position and amount of text currently showing ! 639: in the window (highlighted) relative to the amount of text actually saved. ! 640: As more text is saved (up to the maximum), the size of the highlighted area ! 641: decreases. ! 642: Clicking the mouse with the left of right button in the scroll region will ! 643: position the top of the display window at the mouse position. ! 644: .PP ! 645: The recorder button shows the state of saving lines scrolled off the top ! 646: of the window. ! 647: Tape running reel to reel indicates on, while the tape hanging indicates off. ! 648: Clicking the left or right button in the recorder button toggles the state of ! 649: recording. ! 650: .PP ! 651: The scroll button causes the window to scroll up and down within the saved text. ! 652: The left button moves the window position up (the text scrolls downward), while ! 653: the right button moves the window position down (the text scrolls upward). ! 654: The amount of scrolling is modified by the ``shift'' and ``control'' keys. ! 655: Without either, the window scrolls a single line at a time. ! 656: Continuing to hold the button down will causes the text to continuously ! 657: scroll a line at a time. ! 658: .PP ! 659: The ``shift'' key causes the text to scroll a window full at a time (actually ! 660: it is one line less than a full window). ! 661: And the ``control'' key causes the text to be positioned at the extremes, ! 662: top or bottom. ! 663: .PP ! 664: When using the mouse to create the Tektronix window, a cursor and ! 665: a rubber banding box will outline where the window will be created on ! 666: the display. ! 667: If the left button is pressed, a default size window (750 pixels wide by ! 668: 565 pixel high) is created at the origin. ! 669: If the right button is pressed, a default size window is created ! 670: at the mouse position. ! 671: If the center button is pressed and held down, the upper left hand corner ! 672: of the window is defined at this position. ! 673: An outline of the minimum size window is shown, and a popup window in ! 674: the upper left hand corner of the display will appear, indicating Tektronix ! 675: mode. ! 676: Moving the mouse (while still holding the button down) will enlarge the ! 677: window. ! 678: Releasing the button will define the lower right hand corner ! 679: of the window. ! 680: .PP ! 681: Unlike the VT102 window, the Tektronix window dows not allow the copying of ! 682: text. ! 683: It does allow Tektronix GIN mode, and in this mode ! 684: the cursor will change from an arrow to a cross. ! 685: Pressing any key will send that key and the current coordinate of the ! 686: cross cursor. ! 687: Pressing the left, middle or right button will return the letters `l', `m', and ! 688: `r', respectively. ! 689: If the `shift' key is pressed when a mouse buton is pressed, the corresponding ! 690: upper case letter is sent. ! 691: To distinquish a mouse button from a key, the high bit of the character is ! 692: set (but this is bit is normally stripped unless the terminal mode is RAW; ! 693: see ! 694: .IR tty (4) ! 695: for details). ! 696: .SH MENUS ! 697: .I Xterm ! 698: has five different menus, named ! 699: .BR xterm , ! 700: .BR Modes , ! 701: .BR Tektronix , ! 702: .B Scrollbar ! 703: and ! 704: .BR Windows . ! 705: Each menu pops up under the correct combinations of key and button presses. ! 706: Most menus are divided into two section, separated by a horizontal line. ! 707: The top portion contains various modes that can be altered. ! 708: A check mark appears next to a mode that is currently active. ! 709: Selecting one of these modes toggles its state. ! 710: The bottom portion of the menu are command entries; selecting one of these ! 711: performs the indicated function. ! 712: .PP ! 713: The ! 714: .B xterm ! 715: menu pops up when the ``control'' key and the left button is pressed in a ! 716: window. ! 717: The menu title gives the version number of ! 718: .IR xterm . ! 719: The modes section contains items that apply to both the VT102 and Tektronix ! 720: windows. ! 721: Notable entries in the command section of the menu are the ! 722: .BR Continue , ! 723: .BR Suspend , ! 724: .BR Interrupt , ! 725: .BR Hangup , ! 726: .B Terminate ! 727: and ! 728: .B Kill ! 729: which sends the SIGCONT, SIGTSTP, SIGINT, SIGHUP, SIGTERM and ! 730: SIGKILL signals, respectively, to the process group of the process running ! 731: under ! 732: .I xterm ! 733: (usually the shell). ! 734: The ! 735: .B Continue ! 736: function is especially useful if the user has accidentally typed CTRL-Z, ! 737: suspending the process. ! 738: .PP ! 739: The ! 740: .B Modes ! 741: menu sets various modes in the VT102 emulation, and is popped up with the ! 742: ``control'' and middle button combination in the VT102 window. ! 743: In the command section of this menu, the soft reset entry will reset ! 744: scroll regions. ! 745: This can be convenient when some program has left the scroll regions ! 746: set incorrectly (often a problem when using VMS or TOPS-20). ! 747: The full reset entry will clear the screen, reset tabs to every ! 748: eight columns, and reset the terminal modes (such as wrap and smooth scroll) ! 749: to there initial states just after ! 750: .I xterm ! 751: has finish processing the command line options. ! 752: The ! 753: .B Tektronix ! 754: menu sets various modes in the Tektronix emulation, and is popped up with the ! 755: ``control'' and middle button combination in the Tektronix window. ! 756: The current font size is checked in the modes section of the menu. ! 757: The ! 758: .B PAGE ! 759: entry in the command section clears the Tektronix window. ! 760: .PP ! 761: The ! 762: .B Scrollbar ! 763: menu is popped up when the middle button is pressed within the scrollbar. ! 764: This menu allows several modes particular to the scrollbar to be set. ! 765: .PP ! 766: The ! 767: .B Windows ! 768: menu is not normally compiled into ! 769: .I xterm ! 770: as it duplicates functions that properly belong to window managers. It ! 771: may, however, be enabled at the discretion of your system builder. ! 772: .PP ! 773: If enabled, the ! 774: .B Windows ! 775: menu is a special menu that is popped up when the ``control'' key and ! 776: right button are pressed. ! 777: Listed in order of bottommost to topmost are the visible windows on the ! 778: display that are named. ! 779: The checked entry is the current window. ! 780: By selecting an entry, the corresponding window is raised to the top. ! 781: This is very useful when a particular window of interest ! 782: is obscured by many other windows. ! 783: .SH "OTHER FEATURES" ! 784: .I Xterm ! 785: automatically highlights the window border, text cursor and titlebar when the ! 786: mouse enters the window (selected) and unhighlights them when the mouse ! 787: leaves the window (unselected). ! 788: If the window is the focus window, then the window is highlighted no matter ! 789: where the mouse is. ! 790: .PP ! 791: The titlebar displays the name of the window in the center and on both ! 792: sides stripes appear when the window is selected (highlighted). ! 793: If both windows are showing, only the active window's titlebar is highlighted. ! 794: If the left, middle or right button is pressed in the stripped section of ! 795: the titlebar, the corresponding menu is popped up, without the need to ! 796: hold down the ``control'' key. ! 797: Pressing the mouse button in the center title of the titlebar causes ! 798: the window to automatically iconify. ! 799: Pressing a button in the icon deiconifies it. ! 800: In addition, if input comes in while ! 801: .I xterm ! 802: is iconified and the icon is a static bitmap, ! 803: a box is drawn around the icon title. ! 804: .PP ! 805: In VT102 mode, there are escape sequences to activate and deactivate ! 806: an alternate screen buffer, which is the same size as the display area ! 807: of the window. ! 808: When activated, the current screen is saved and replace with the alternate ! 809: screen. ! 810: Saving of lines scrolled off the top of the window and page scroll mode ! 811: are disabled, until the normal screen is restored. ! 812: The ! 813: .IR termcap (5) ! 814: entry for ! 815: .I xterm ! 816: allows the visual editor ! 817: .IR vi (1) ! 818: to switch to the alternate screen for editing, and restore the screen ! 819: on exit. ! 820: .PP ! 821: In either VT102 or Tektronix mode, there are escape sequences to change the ! 822: title in the title bar (which will also change the name of the windows and ! 823: icons) and to specify a new log file name. ! 824: .PP ! 825: By default, a miniature version of the VT102 or Tektronix window is ! 826: displayed when ! 827: .I xterm ! 828: is iconified. The choice of which miniature to display is made when ! 829: the full window(s) are iconified; if the Tek window is chosen in the ! 830: iconify operation, then the icon will be a miniature Tek window and if ! 831: the VT102 window is chosen, the icon will be a miniature VT102 window. ! 832: This choice is independent of the current mode (Tektronix/VT102). ! 833: .PP ! 834: As an option, the miniature window may be disabled and a bitmap of a ! 835: small VT102 window with titlebar and scrollbar can be ! 836: displayed in the icon when in VT102 mode, and a bitmap of a Tektronix ! 837: window with titlebar is displayed in Tektronix mode. ! 838: these bitmaps may be user-defined (see options above). ! 839: .SH ENVIRONMENT ! 840: .I Xterm ! 841: sets the environment variables ``TERM'' and ``TERMCAP'' properly for the ! 842: size window you have created. ! 843: It also uses and sets the environment ! 844: variable ``DISPLAY'' to specify which bit map display terminal to use. ! 845: The environment variable ``WINDOWID'' is set to the X window id number ! 846: of the ! 847: .I xterm ! 848: window. ! 849: .SH "SEE ALSO" ! 850: resize(1), X(1), pty(4), tty(4) ! 851: .br ! 852: .I ``Xterm Control Sequences'' ! 853: .SH BUGS ! 854: There is currently no way for a ! 855: .I xterm ! 856: window not to highlight itself when the mouse cursor enter it ! 857: while another window is the keyboard focus. ! 858: There needs to be a dialog box to allow entry of log file name ! 859: and the COPY file name. ! 860: Many of the options are not resettable after ! 861: .I xterm ! 862: starts. ! 863: .SH AUTHORS ! 864: Edward Moy (Berkeley), Ralph R. Swick (MIT-Athena), ! 865: Mark Vandevoorde (MIT-Athena), Bob McNamara (DEC-MAD), ! 866: Jim Gettys (MIT-Athena), Bob Scheifler (MIT-LCS), Doug Mink (SAO). ! 867: .sp ! 868: VMS and TOPS-20 are trademarks of Digital Equipment Corporation. ! 869: .sp ! 870: Copyright (c) 1984, 1985, 1986 by Massachusetts Institute of Technology. ! 871: .br ! 872: See ! 873: .IR X (1) ! 874: for a full copyright notice.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.