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