Sun Nov 21 06:20:30 2010 UTC ()
merge cornflakes for xterm 266


(mrg)
diff -r1.5 -r1.6 xsrc/external/mit/xterm/dist/misc.c
diff -r1.5 -r1.6 xsrc/external/mit/xterm/dist/ptyx.h
diff -r1.5 -r1.6 xsrc/external/mit/xterm/dist/xterm.man

cvs diff -r1.5 -r1.6 xsrc/external/mit/xterm/dist/misc.c (expand / switch to unified diff)

--- xsrc/external/mit/xterm/dist/misc.c 2010/06/30 04:49:44 1.5
+++ xsrc/external/mit/xterm/dist/misc.c 2010/11/21 06:20:30 1.6
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1/* $XTermId: misc.c,v 1.503 2010/06/20 21:33:49 tom Exp $ */ 1/* $XTermId: misc.c,v 1.510 2010/10/11 08:33:33 tom Exp $ */
2 2
3/* 3/*
4 * Copyright 1999-2009,2010 by Thomas E. Dickey 4 * Copyright 1999-2009,2010 by Thomas E. Dickey
5 * 5 *
6 * All Rights Reserved 6 * All Rights Reserved
7 * 7 *
8 * Permission is hereby granted, free of charge, to any person obtaining a 8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the 9 * copy of this software and associated documentation files (the
10 * "Software"), to deal in the Software without restriction, including 10 * "Software"), to deal in the Software without restriction, including
11 * without limitation the rights to use, copy, modify, merge, publish, 11 * without limitation the rights to use, copy, modify, merge, publish,
12 * distribute, sublicense, and/or sell copies of the Software, and to 12 * distribute, sublicense, and/or sell copies of the Software, and to
13 * permit persons to whom the Software is furnished to do so, subject to 13 * permit persons to whom the Software is furnished to do so, subject to
14 * the following conditions: 14 * the following conditions:
@@ -415,58 +415,59 @@ xevents(void) @@ -415,58 +415,59 @@ xevents(void)
415 */ 415 */
416 if (OUR_EVENT(event, EnterNotify)) { 416 if (OUR_EVENT(event, EnterNotify)) {
417 DoSpecialEnterNotify(xw, &event.xcrossing); 417 DoSpecialEnterNotify(xw, &event.xcrossing);
418 } else if (OUR_EVENT(event, LeaveNotify)) { 418 } else if (OUR_EVENT(event, LeaveNotify)) {
419 DoSpecialLeaveNotify(xw, &event.xcrossing); 419 DoSpecialLeaveNotify(xw, &event.xcrossing);
420 } else if ((screen->send_mouse_pos == ANY_EVENT_MOUSE 420 } else if ((screen->send_mouse_pos == ANY_EVENT_MOUSE
421#if OPT_DEC_LOCATOR 421#if OPT_DEC_LOCATOR
422 || screen->send_mouse_pos == DEC_LOCATOR 422 || screen->send_mouse_pos == DEC_LOCATOR
423#endif /* OPT_DEC_LOCATOR */ 423#endif /* OPT_DEC_LOCATOR */
424 ) 424 )
425 && event.xany.type == MotionNotify 425 && event.xany.type == MotionNotify
426 && event.xcrossing.window == XtWindow(xw)) { 426 && event.xcrossing.window == XtWindow(xw)) {
427 SendMousePosition(xw, &event); 427 SendMousePosition(xw, &event);
 428 xtermShowPointer(xw, True);
428 continue; 429 continue;
429 } 430 }
430 431
 432 /*
 433 * If the event is interesting (and not a keyboard event), turn the
 434 * mouse pointer back on.
 435 */
 436 if (screen->hide_pointer) {
 437 switch (event.xany.type) {
 438 case KeyPress:
 439 case KeyRelease:
 440 case ButtonPress:
 441 case ButtonRelease:
 442 /* also these... */
 443 case Expose:
 444 case NoExpose:
 445 case PropertyNotify:
 446 case ClientMessage:
 447 break;
 448 default:
 449 xtermShowPointer(xw, True);
 450 break;
 451 }
 452 }
 453
431 if (!event.xany.send_event || 454 if (!event.xany.send_event ||
432 screen->allowSendEvents || 455 screen->allowSendEvents ||
433 ((event.xany.type != KeyPress) && 456 ((event.xany.type != KeyPress) &&
434 (event.xany.type != KeyRelease) && 457 (event.xany.type != KeyRelease) &&
435 (event.xany.type != ButtonPress) && 458 (event.xany.type != ButtonPress) &&
436 (event.xany.type != ButtonRelease))) { 459 (event.xany.type != ButtonRelease))) {
437 460
438 /* 
439 * If the event is interesting (and not a keyboard event), turn the 
440 * mouse pointer back on. 
441 */ 
442 if (screen->hide_pointer) { 
443 switch (event.xany.type) { 
444 case KeyPress: 
445 case KeyRelease: 
446 case ButtonPress: 
447 case ButtonRelease: 
448 /* also these... */ 
449 case Expose: 
450 case NoExpose: 
451 case PropertyNotify: 
452 case ClientMessage: 
453 break; 
454 default: 
455 xtermShowPointer(xw, True); 
456 break; 
457 } 
458 } 
459 
460 XtDispatchEvent(&event); 461 XtDispatchEvent(&event);
461 } 462 }
462 } while (XtAppPending(app_con) & XtIMXEvent); 463 } while (XtAppPending(app_con) & XtIMXEvent);
463} 464}
464 465
465static Cursor 466static Cursor
466make_hidden_cursor(XtermWidget xw) 467make_hidden_cursor(XtermWidget xw)
467{ 468{
468 TScreen *screen = TScreenOf(xw); 469 TScreen *screen = TScreenOf(xw);
469 Cursor c; 470 Cursor c;
470 Display *dpy = screen->display; 471 Display *dpy = screen->display;
471 XFontStruct *fn; 472 XFontStruct *fn;
472 473
@@ -2541,27 +2542,27 @@ ResetColorsRequest(XtermWidget xw, @@ -2541,27 +2542,27 @@ ResetColorsRequest(XtermWidget xw,
2541 } 2542 }
2542#endif 2543#endif
2543 return result; 2544 return result;
2544} 2545}
2545 2546
2546#if OPT_SHIFT_FONTS 2547#if OPT_SHIFT_FONTS
2547/* 2548/*
2548 * Initially, 'source' points to '#' or '?'. 2549 * Initially, 'source' points to '#' or '?'.
2549 * 2550 *
2550 * Look for an optional sign and optional number. If those are found, lookup 2551 * Look for an optional sign and optional number. If those are found, lookup
2551 * the corresponding menu font entry. 2552 * the corresponding menu font entry.
2552 */ 2553 */
2553static int 2554static int
2554ParseShiftedFont(XtermWidget xw, char *source, char **target) 2555ParseShiftedFont(XtermWidget xw, String source, String * target)
2555{ 2556{
2556 TScreen *screen = TScreenOf(xw); 2557 TScreen *screen = TScreenOf(xw);
2557 int num = screen->menu_font_number; 2558 int num = screen->menu_font_number;
2558 int rel = 0; 2559 int rel = 0;
2559 2560
2560 if (*++source == '+') { 2561 if (*++source == '+') {
2561 rel = 1; 2562 rel = 1;
2562 source++; 2563 source++;
2563 } else if (*source == '-') { 2564 } else if (*source == '-') {
2564 rel = -1; 2565 rel = -1;
2565 source++; 2566 source++;
2566 } 2567 }
2567 2568
@@ -2576,33 +2577,33 @@ ParseShiftedFont(XtermWidget xw, char *s @@ -2576,33 +2577,33 @@ ParseShiftedFont(XtermWidget xw, char *s
2576 } 2577 }
2577 2578
2578 if (rel != 0) { 2579 if (rel != 0) {
2579 num = lookupRelativeFontSize(xw, 2580 num = lookupRelativeFontSize(xw,
2580 screen->menu_font_number, rel); 2581 screen->menu_font_number, rel);
2581 2582
2582 } 2583 }
2583 TRACE(("ParseShiftedFont(%s) ->%d (%s)\n", *target, num, source)); 2584 TRACE(("ParseShiftedFont(%s) ->%d (%s)\n", *target, num, source));
2584 *target = source; 2585 *target = source;
2585 return num; 2586 return num;
2586} 2587}
2587 2588
2588static void 2589static void
2589QueryFontRequest(XtermWidget xw, char *buf, int final) 2590QueryFontRequest(XtermWidget xw, String buf, int final)
2590{ 2591{
2591 if (AllowFontOps(xw, efGetFont)) { 2592 if (AllowFontOps(xw, efGetFont)) {
2592 TScreen *screen = TScreenOf(xw); 2593 TScreen *screen = TScreenOf(xw);
2593 Bool success = True; 2594 Bool success = True;
2594 int num; 2595 int num;
2595 char *base = buf + 1; 2596 String base = buf + 1;
2596 const char *name = 0; 2597 const char *name = 0;
2597 char temp[10]; 2598 char temp[10];
2598 2599
2599 num = ParseShiftedFont(xw, buf, &buf); 2600 num = ParseShiftedFont(xw, buf, &buf);
2600 if (num < 0 2601 if (num < 0
2601 || num > fontMenu_lastBuiltin) { 2602 || num > fontMenu_lastBuiltin) {
2602 Bell(xw, XkbBI_MinorError, 0); 2603 Bell(xw, XkbBI_MinorError, 0);
2603 success = False; 2604 success = False;
2604 } else { 2605 } else {
2605#if OPT_RENDERFONT 2606#if OPT_RENDERFONT
2606 if (UsingRenderFont(xw)) { 2607 if (UsingRenderFont(xw)) {
2607 name = getFaceName(xw, False); 2608 name = getFaceName(xw, False);
2608 } else 2609 } else
@@ -2626,27 +2627,27 @@ QueryFontRequest(XtermWidget xw, char *b @@ -2626,27 +2627,27 @@ QueryFontRequest(XtermWidget xw, char *b
2626 if (*name != '\0') 2627 if (*name != '\0')
2627 unparseputc(xw, ' '); 2628 unparseputc(xw, ' ');
2628 } 2629 }
2629 } 2630 }
2630 unparseputs(xw, name); 2631 unparseputs(xw, name);
2631 } 2632 }
2632 2633
2633 unparseputc1(xw, final); 2634 unparseputc1(xw, final);
2634 unparse_end(xw); 2635 unparse_end(xw);
2635 } 2636 }
2636} 2637}
2637 2638
2638static void 2639static void
2639ChangeFontRequest(XtermWidget xw, char *buf) 2640ChangeFontRequest(XtermWidget xw, String buf)
2640{ 2641{
2641 if (AllowFontOps(xw, efSetFont)) { 2642 if (AllowFontOps(xw, efSetFont)) {
2642 TScreen *screen = TScreenOf(xw); 2643 TScreen *screen = TScreenOf(xw);
2643 Bool success = True; 2644 Bool success = True;
2644 int num; 2645 int num;
2645 VTFontNames fonts; 2646 VTFontNames fonts;
2646 char *name; 2647 char *name;
2647 2648
2648 /* 2649 /*
2649 * If the font specification is a "#", followed by an optional sign and 2650 * If the font specification is a "#", followed by an optional sign and
2650 * optional number, lookup the corresponding menu font entry. 2651 * optional number, lookup the corresponding menu font entry.
2651 * 2652 *
2652 * Further, if the "#", etc., is followed by a font name, use that 2653 * Further, if the "#", etc., is followed by a font name, use that
@@ -3376,26 +3377,334 @@ do_dcs(XtermWidget xw, Char * dcsbuf, si @@ -3376,26 +3377,334 @@ do_dcs(XtermWidget xw, Char * dcsbuf, si
3376 reset_decudk(); 3377 reset_decudk();
3377 parse_decudk(cp); 3378 parse_decudk(cp);
3378 break; 3379 break;
3379 case '{': /* DECDLD (no '}' case though) */ 3380 case '{': /* DECDLD (no '}' case though) */
3380 parse_decdld(&params, cp); 3381 parse_decdld(&params, cp);
3381 break; 3382 break;
3382 } 3383 }
3383 } 3384 }
3384 break; 3385 break;
3385 } 3386 }
3386 unparse_end(xw); 3387 unparse_end(xw);
3387} 3388}
3388 3389
 3390#if OPT_DEC_RECTOPS
 3391enum {
 3392 mdUnknown = 0,
 3393 mdMaybeSet = 1,
 3394 mdMaybeReset = 2,
 3395 mdAlwaysSet = 3,
 3396 mdAlwaysReset = 4
 3397};
 3398
 3399#define MdBool(bool) ((bool) ? mdMaybeSet : mdMaybeReset)
 3400#define MdFlag(mode,flag) MdBool(xw->keyboard.flags & MODE_KAM)
 3401
 3402/*
 3403 * Reply is the same format as the query, with pair of mode/value:
 3404 * 0 - not recognized
 3405 * 1 - set
 3406 * 2 - reset
 3407 * 3 - permanently set
 3408 * 4 - permanently reset
 3409 * Only one mode can be reported at a time.
 3410 */
 3411void
 3412do_rpm(XtermWidget xw, int nparams, int *params)
 3413{
 3414 ANSI reply;
 3415 int result = 0;
 3416 int count = 0;
 3417
 3418 TRACE(("do_rpm %d:%d\n", nparams, params[0]));
 3419 memset(&reply, 0, sizeof(reply));
 3420 if (nparams >= 1) {
 3421 switch (params[0]) {
 3422 case 1: /* GATM */
 3423 result = mdAlwaysReset;
 3424 break;
 3425 case 2:
 3426 result = MdFlag(xw->keyboard.flags, MODE_KAM);
 3427 break;
 3428 case 3: /* CRM */
 3429 result = mdMaybeReset;
 3430 break;
 3431 case 4:
 3432 result = MdFlag(xw->flags, INSERT);
 3433 break;
 3434 case 5: /* SRTM */
 3435 case 7: /* VEM */
 3436 case 10: /* HEM */
 3437 case 11: /* PUM */
 3438 result = mdAlwaysReset;
 3439 break;
 3440 case 12:
 3441 result = MdFlag(xw->keyboard.flags, MODE_SRM);
 3442 break;
 3443 case 13: /* FEAM */
 3444 case 14: /* FETM */
 3445 case 15: /* MATM */
 3446 case 16: /* TTM */
 3447 case 17: /* SATM */
 3448 case 18: /* TSM */
 3449 case 19: /* EBM */
 3450 result = mdAlwaysReset;
 3451 break;
 3452 case 20:
 3453 result = MdFlag(xw->flags, LINEFEED);
 3454 break;
 3455 }
 3456 reply.a_param[count++] = (ParmType) params[0];
 3457 reply.a_param[count++] = (ParmType) result;
 3458 }
 3459 reply.a_type = ANSI_CSI;
 3460 reply.a_nparam = (ParmType) count;
 3461 reply.a_inters = '$';
 3462 reply.a_final = 'y';
 3463 unparseseq(xw, &reply);
 3464}
 3465
 3466void
 3467do_decrpm(XtermWidget xw, int nparams, int *params)
 3468{
 3469 ANSI reply;
 3470 int result = 0;
 3471 int count = 0;
 3472
 3473 TRACE(("do_decrpm %d:%d\n", nparams, params[0]));
 3474 memset(&reply, 0, sizeof(reply));
 3475 if (nparams >= 1) {
 3476 TScreen *screen = TScreenOf(xw);
 3477
 3478 switch (params[0]) {
 3479 case 1: /* DECCKM */
 3480 result = MdFlag(xw->keyboard.flags, MODE_DECCKM);
 3481 break;
 3482 case 2: /* DECANM - ANSI/VT52 mode */
 3483#if OPT_VT52_MODE
 3484 result = MdBool(screen->terminal_id >= 100);
 3485#else
 3486 result = mdMaybeSet;
 3487#endif
 3488 break;
 3489 case 3: /* DECCOLM */
 3490 result = MdFlag(xw->flags, IN132COLUMNS);
 3491 break;
 3492 case 4: /* DECSCLM (slow scroll) */
 3493 result = MdFlag(xw->flags, SMOOTHSCROLL);
 3494 break;
 3495 case 5: /* DECSCNM */
 3496 result = MdFlag(xw->flags, REVERSE_VIDEO);
 3497 break;
 3498 case 6: /* DECOM */
 3499 result = MdFlag(xw->flags, ORIGIN);
 3500 break;
 3501 case 7: /* DECAWM */
 3502 result = MdFlag(xw->flags, WRAPAROUND);
 3503 break;
 3504 case 8: /* DECARM */
 3505 result = mdAlwaysReset;
 3506 break;
 3507 case SET_X10_MOUSE: /* X10 mouse */
 3508 result = MdBool(screen->send_mouse_pos == X10_MOUSE);
 3509 break;
 3510#if OPT_TOOLBAR
 3511 case 10: /* rxvt */
 3512 result = MdBool(resource.toolBar);
 3513 break;
 3514#endif
 3515#if OPT_BLINK_CURS
 3516 case 12: /* att610: Start/stop blinking cursor */
 3517 result = MdBool(screen->cursor_blink_res);
 3518 break;
 3519#endif
 3520 case 18: /* DECPFF: print form feed */
 3521 result = MdBool(screen->printer_formfeed);
 3522 break;
 3523 case 19: /* DECPEX: print extent */
 3524 result = MdBool(screen->printer_extent);
 3525 break;
 3526 case 25: /* DECTCEM: Show/hide cursor (VT200) */
 3527 result = MdBool(screen->cursor_set);
 3528 break;
 3529 case 30: /* rxvt */
 3530 result = MdBool(screen->fullVwin.sb_info.width != OFF);
 3531 break;
 3532#if OPT_SHIFT_FONTS
 3533 case 35: /* rxvt */
 3534 result = MdBool(xw->misc.shift_fonts);
 3535 break;
 3536#endif
 3537#if OPT_TEK4014
 3538 case 38: /* DECTEK */
 3539 result = MdBool(TEK4014_ACTIVE(xw));
 3540 break;
 3541#endif
 3542 case 40: /* 132 column mode */
 3543 result = MdBool(screen->c132);
 3544 break;
 3545 case 41: /* curses hack */
 3546 result = MdBool(screen->curses);
 3547 break;
 3548 case 42: /* DECNRCM national charset (VT220) */
 3549 result = MdFlag(xw->flags, NATIONAL);
 3550 break;
 3551 case 44: /* margin bell */
 3552 result = MdBool(screen->marginbell);
 3553 break;
 3554 case 45: /* reverse wraparound */
 3555 result = MdFlag(xw->flags, REVERSEWRAP);
 3556 break;
 3557#ifdef ALLOWLOGGING
 3558 case 46: /* logging */
 3559#ifdef ALLOWLOGFILEONOFF
 3560 result = MdBool(screen->logging);
 3561#endif /* ALLOWLOGFILEONOFF */
 3562 break;
 3563#endif
 3564 case 1049: /* alternate buffer & cursor */
 3565 /* FALLTHRU */
 3566 case 1047:
 3567 /* FALLTHRU */
 3568 case 47: /* alternate buffer */
 3569 result = MdBool(screen->whichBuf);
 3570 break;
 3571 case 66: /* DECNKM */
 3572 result = MdFlag(xw->keyboard.flags, MODE_DECKPAM);
 3573 break;
 3574 case 67: /* DECBKM */
 3575 result = MdFlag(xw->keyboard.flags, MODE_DECBKM);
 3576 break;
 3577 case SET_VT200_MOUSE: /* xterm bogus sequence */
 3578 result = MdBool(screen->send_mouse_pos == VT200_MOUSE);
 3579 break;
 3580 case SET_VT200_HIGHLIGHT_MOUSE: /* xterm sequence w/hilite tracking */
 3581 result = MdBool(screen->send_mouse_pos == VT200_HIGHLIGHT_MOUSE);
 3582 break;
 3583 case SET_BTN_EVENT_MOUSE:
 3584 result = MdBool(screen->send_mouse_pos == BTN_EVENT_MOUSE);
 3585 break;
 3586 case SET_ANY_EVENT_MOUSE:
 3587 result = MdBool(screen->send_mouse_pos == ANY_EVENT_MOUSE);
 3588 break;
 3589#if OPT_FOCUS_EVENT
 3590 case SET_FOCUS_EVENT_MOUSE:
 3591 result = MdBool(screen->send_focus_pos);
 3592 break;
 3593#endif
 3594 case SET_EXT_MODE_MOUSE:
 3595 result = MdBool(screen->ext_mode_mouse);
 3596 break;
 3597 case 1010: /* rxvt */
 3598 result = MdBool(screen->scrollttyoutput);
 3599 break;
 3600 case 1011: /* rxvt */
 3601 result = MdBool(screen->scrollkey);
 3602 break;
 3603 case 1034:
 3604 result = MdBool(screen->input_eight_bits);
 3605 break;
 3606#if OPT_NUM_LOCK
 3607 case 1035:
 3608 result = MdBool(xw->misc.real_NumLock);
 3609 break;
 3610 case 1036:
 3611 result = MdBool(screen->meta_sends_esc);
 3612 break;
 3613#endif
 3614 case 1037:
 3615 result = MdBool(screen->delete_is_del);
 3616 break;
 3617#if OPT_NUM_LOCK
 3618 case 1039:
 3619 result = MdBool(screen->alt_sends_esc);
 3620 break;
 3621#endif
 3622 case 1040:
 3623 result = MdBool(screen->keepSelection);
 3624 break;
 3625 case 1041:
 3626 result = MdBool(screen->selectToClipboard);
 3627 break;
 3628 case 1042:
 3629 result = MdBool(screen->bellIsUrgent);
 3630 break;
 3631 case 1043:
 3632 result = MdBool(screen->poponbell);
 3633 break;
 3634 case 1048:
 3635 result = MdBool(screen->sc[screen->whichBuf].saved);
 3636 break;
 3637#if OPT_TCAP_FKEYS
 3638 case 1050:
 3639 result = MdBool(xw->keyboard.type == keyboardIsTermcap);
 3640 break;
 3641#endif
 3642#if OPT_SUN_FUNC_KEYS
 3643 case 1051:
 3644 result = MdBool(xw->keyboard.type == keyboardIsSun);
 3645 break;
 3646#endif
 3647#if OPT_HP_FUNC_KEYS
 3648 case 1052:
 3649 result = MdBool(xw->keyboard.type == keyboardIsHP);
 3650 break;
 3651#endif
 3652#if OPT_SCO_FUNC_KEYS
 3653 case 1053:
 3654 result = MdBool(xw->keyboard.type == keyboardIsSCO);
 3655 break;
 3656#endif
 3657 case 1060:
 3658 result = MdBool(xw->keyboard.type == keyboardIsLegacy);
 3659 break;
 3660#if OPT_SUNPC_KBD
 3661 case 1061:
 3662 result = MdBool(xw->keyboard.type == keyboardIsVT220);
 3663 break;
 3664#endif
 3665#if OPT_READLINE
 3666 case SET_BUTTON1_MOVE_POINT:
 3667 result = MdBool(screen->click1_moves);
 3668 break;
 3669 case SET_BUTTON2_MOVE_POINT:
 3670 result = MdBool(screen->paste_moves);
 3671 break;
 3672 case SET_DBUTTON3_DELETE:
 3673 result = MdBool(screen->dclick3_deletes);
 3674 break;
 3675 case SET_PASTE_IN_BRACKET:
 3676 result = MdBool(screen->paste_brackets);
 3677 break;
 3678 case SET_PASTE_QUOTE:
 3679 result = MdBool(screen->paste_quotes);
 3680 break;
 3681 case SET_PASTE_LITERAL_NL:
 3682 result = MdBool(screen->paste_literal_nl);
 3683 break;
 3684#endif /* OPT_READLINE */
 3685 }
 3686 reply.a_param[count++] = (ParmType) params[0];
 3687 reply.a_param[count++] = (ParmType) result;
 3688 }
 3689 reply.a_type = ANSI_CSI;
 3690 reply.a_pintro = '?';
 3691 reply.a_nparam = (ParmType) count;
 3692 reply.a_inters = '$';
 3693 reply.a_final = 'y';
 3694 unparseseq(xw, &reply);
 3695}
 3696#endif /* OPT_DEC_RECTOPS */
 3697
3389char * 3698char *
3390udk_lookup(int keycode, int *len) 3699udk_lookup(int keycode, int *len)
3391{ 3700{
3392 if (keycode >= 0 && keycode < MAX_UDK) { 3701 if (keycode >= 0 && keycode < MAX_UDK) {
3393 *len = user_keys[keycode].len; 3702 *len = user_keys[keycode].len;
3394 return user_keys[keycode].str; 3703 return user_keys[keycode].str;
3395 } 3704 }
3396 return 0; 3705 return 0;
3397} 3706}
3398 3707
3399static void 3708static void
3400ChangeGroup(XtermWidget xw, const char *attribute, char *value) 3709ChangeGroup(XtermWidget xw, const char *attribute, char *value)
3401{ 3710{

cvs diff -r1.5 -r1.6 xsrc/external/mit/xterm/dist/ptyx.h (expand / switch to unified diff)

--- xsrc/external/mit/xterm/dist/ptyx.h 2010/06/30 04:49:44 1.5
+++ xsrc/external/mit/xterm/dist/ptyx.h 2010/11/21 06:20:30 1.6
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1/* $XTermId: ptyx.h,v 1.670 2010/06/15 08:34:38 tom Exp $ */ 1/* $XTermId: ptyx.h,v 1.675 2010/10/11 08:25:53 tom Exp $ */
2 2
3/* 3/*
4 * Copyright 1999-2009,2010 by Thomas E. Dickey 4 * Copyright 1999-2009,2010 by Thomas E. Dickey
5 * 5 *
6 * All Rights Reserved 6 * All Rights Reserved
7 * 7 *
8 * Permission is hereby granted, free of charge, to any person obtaining a 8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the 9 * copy of this software and associated documentation files (the
10 * "Software"), to deal in the Software without restriction, including 10 * "Software"), to deal in the Software without restriction, including
11 * without limitation the rights to use, copy, modify, merge, publish, 11 * without limitation the rights to use, copy, modify, merge, publish,
12 * distribute, sublicense, and/or sell copies of the Software, and to 12 * distribute, sublicense, and/or sell copies of the Software, and to
13 * permit persons to whom the Software is furnished to do so, subject to 13 * permit persons to whom the Software is furnished to do so, subject to
14 * the following conditions: 14 * the following conditions:
@@ -1364,26 +1364,27 @@ typedef enum { @@ -1364,26 +1364,27 @@ typedef enum {
1364 DP_DECPFF, 1364 DP_DECPFF,
1365 DP_DECSCLM, 1365 DP_DECSCLM,
1366 DP_DECSCNM, 1366 DP_DECSCNM,
1367 DP_DECTCEM, 1367 DP_DECTCEM,
1368 DP_DECTEK, 1368 DP_DECTEK,
1369 DP_PRN_EXTENT, 1369 DP_PRN_EXTENT,
1370 DP_PRN_FORMFEED, 1370 DP_PRN_FORMFEED,
1371 DP_X_ALTSCRN, 1371 DP_X_ALTSCRN,
1372 DP_X_DECCOLM, 1372 DP_X_DECCOLM,
1373 DP_X_LOGGING, 1373 DP_X_LOGGING,
1374 DP_X_MARGIN, 1374 DP_X_MARGIN,
1375 DP_X_MORE, 1375 DP_X_MORE,
1376 DP_X_MOUSE, 1376 DP_X_MOUSE,
 1377 DP_X_EXT_MOUSE,
1377 DP_X_REVWRAP, 1378 DP_X_REVWRAP,
1378 DP_X_X10MSE, 1379 DP_X_X10MSE,
1379#if OPT_BLINK_CURS 1380#if OPT_BLINK_CURS
1380 DP_CRS_BLINK, 1381 DP_CRS_BLINK,
1381#endif 1382#endif
1382#if OPT_FOCUS_EVENT 1383#if OPT_FOCUS_EVENT
1383 DP_X_FOCUS, 1384 DP_X_FOCUS,
1384#endif 1385#endif
1385#if OPT_TOOLBAR 1386#if OPT_TOOLBAR
1386 DP_TOOLBAR, 1387 DP_TOOLBAR,
1387#endif 1388#endif
1388 DP_LAST 1389 DP_LAST
1389} SaveModes; 1390} SaveModes;
@@ -1570,26 +1571,27 @@ typedef struct { @@ -1570,26 +1571,27 @@ typedef struct {
1570 Boolean brokenLinuxOSC; /* true to ignore Linux palette ctls */ 1571 Boolean brokenLinuxOSC; /* true to ignore Linux palette ctls */
1571#endif 1572#endif
1572#if OPT_BROKEN_ST 1573#if OPT_BROKEN_ST
1573 Boolean brokenStringTerm; /* true to match old OSC parse */ 1574 Boolean brokenStringTerm; /* true to match old OSC parse */
1574#endif 1575#endif
1575#if OPT_C1_PRINT || OPT_WIDE_CHARS 1576#if OPT_C1_PRINT || OPT_WIDE_CHARS
1576 Boolean c1_printable; /* true if we treat C1 as print */ 1577 Boolean c1_printable; /* true if we treat C1 as print */
1577#endif 1578#endif
1578 int border; /* inner border */ 1579 int border; /* inner border */
1579 int scrollBarBorder; /* scrollBar border */ 1580 int scrollBarBorder; /* scrollBar border */
1580 long event_mask; 1581 long event_mask;
1581 unsigned send_mouse_pos; /* user wants mouse transition */ 1582 unsigned send_mouse_pos; /* user wants mouse transition */
1582 /* and position information */ 1583 /* and position information */
 1584 Boolean ext_mode_mouse; /* support large terminals */
1583 Boolean send_focus_pos; /* user wants focus in/out info */ 1585 Boolean send_focus_pos; /* user wants focus in/out info */
1584 Boolean quiet_grab; /* true if no cursor change on focus */ 1586 Boolean quiet_grab; /* true if no cursor change on focus */
1585#if OPT_PASTE64 1587#if OPT_PASTE64
1586 Cardinal base64_paste; /* set to send paste in base64 */ 1588 Cardinal base64_paste; /* set to send paste in base64 */
1587 int base64_final; /* string-terminator for paste */ 1589 int base64_final; /* string-terminator for paste */
1588 /* _qWriteSelectionData expects these to be initialized to zero. 1590 /* _qWriteSelectionData expects these to be initialized to zero.
1589 * base64_flush() is the last step of the conversion, it clears these 1591 * base64_flush() is the last step of the conversion, it clears these
1590 * variables. 1592 * variables.
1591 */ 1593 */
1592 unsigned base64_accu; 1594 unsigned base64_accu;
1593 unsigned base64_count; 1595 unsigned base64_count;
1594 unsigned base64_pad; 1596 unsigned base64_pad;
1595#endif 1597#endif
@@ -1683,27 +1685,29 @@ typedef struct { @@ -1683,27 +1685,29 @@ typedef struct {
1683 Boolean fnt_prop; /* true if proportional fonts */ 1685 Boolean fnt_prop; /* true if proportional fonts */
1684 Boolean fnt_boxes; /* true if font has box-chars */ 1686 Boolean fnt_boxes; /* true if font has box-chars */
1685 Boolean force_packed; /* true to override proportional */ 1687 Boolean force_packed; /* true to override proportional */
1686#if OPT_BOX_CHARS 1688#if OPT_BOX_CHARS
1687 Boolean force_box_chars;/* true if we assume that */ 1689 Boolean force_box_chars;/* true if we assume that */
1688 Boolean force_all_chars;/* true to outline missing chars */ 1690 Boolean force_all_chars;/* true to outline missing chars */
1689 Boolean allow_packing; /* true to allow packed-fonts */ 1691 Boolean allow_packing; /* true to allow packed-fonts */
1690#endif 1692#endif
1691 Dimension fnt_wide; 1693 Dimension fnt_wide;
1692 Dimension fnt_high; 1694 Dimension fnt_high;
1693 XTermFonts fnts[fMAX]; /* normal/bold/etc for terminal */ 1695 XTermFonts fnts[fMAX]; /* normal/bold/etc for terminal */
1694 Boolean free_bold_box; /* same_font_size's austerity */ 1696 Boolean free_bold_box; /* same_font_size's austerity */
1695#ifndef NO_ACTIVE_ICON 1697#ifndef NO_ACTIVE_ICON
1696 XTermFonts fnt_icon; /* icon font */ 1698 XTermFonts fnt_icon; /* icon font */
 1699 String icon_fontname; /* name of icon font */
 1700 int icon_fontnum; /* number to use for icon font */
1697#endif /* NO_ACTIVE_ICON */ 1701#endif /* NO_ACTIVE_ICON */
1698 int enbolden; /* overstrike for bold font */ 1702 int enbolden; /* overstrike for bold font */
1699 XPoint *box; /* draw unselected cursor */ 1703 XPoint *box; /* draw unselected cursor */
1700 1704
1701 int cursor_state; /* ON, OFF, or BLINKED_OFF */ 1705 int cursor_state; /* ON, OFF, or BLINKED_OFF */
1702 int cursor_busy; /* do not redraw... */ 1706 int cursor_busy; /* do not redraw... */
1703 Boolean cursor_underline; /* true if cursor is in underline mode */ 1707 Boolean cursor_underline; /* true if cursor is in underline mode */
1704#if OPT_BLINK_CURS 1708#if OPT_BLINK_CURS
1705 Boolean cursor_blink; /* cursor blink enable */ 1709 Boolean cursor_blink; /* cursor blink enable */
1706 Boolean cursor_blink_res; /* initial cursor blink value */ 1710 Boolean cursor_blink_res; /* initial cursor blink value */
1707 Boolean cursor_blink_esc; /* cursor blink escape-state */ 1711 Boolean cursor_blink_esc; /* cursor blink escape-state */
1708#endif 1712#endif
1709#if OPT_BLINK_TEXT 1713#if OPT_BLINK_TEXT
@@ -1865,26 +1869,27 @@ typedef struct { @@ -1865,26 +1869,27 @@ typedef struct {
1865 1869
1866 Boolean waitingForTrackInfo; 1870 Boolean waitingForTrackInfo;
1867 int numberOfClicks; 1871 int numberOfClicks;
1868 int maxClicks; 1872 int maxClicks;
1869 int multiClickTime; /* time between multiclick selects */ 1873 int multiClickTime; /* time between multiclick selects */
1870 SelectUnit selectUnit; 1874 SelectUnit selectUnit;
1871 SelectUnit selectMap[NSELECTUNITS]; 1875 SelectUnit selectMap[NSELECTUNITS];
1872 String onClick[NSELECTUNITS + 1]; 1876 String onClick[NSELECTUNITS + 1];
1873 1877
1874 char *charClass; /* for overriding word selection */ 1878 char *charClass; /* for overriding word selection */
1875 Boolean cutNewline; /* whether or not line cut has \n */ 1879 Boolean cutNewline; /* whether or not line cut has \n */
1876 Boolean cutToBeginningOfLine; /* line cuts to BOL? */ 1880 Boolean cutToBeginningOfLine; /* line cuts to BOL? */
1877 Boolean highlight_selection; /* controls appearance of selection */ 1881 Boolean highlight_selection; /* controls appearance of selection */
 1882 Boolean show_wrap_marks; /* show lines which are wrapped */
1878 Boolean trim_selection; /* controls trimming of selection */ 1883 Boolean trim_selection; /* controls trimming of selection */
1879 Boolean i18nSelections; 1884 Boolean i18nSelections;
1880 Boolean brokenSelections; 1885 Boolean brokenSelections;
1881 Boolean keepSelection; /* do not lose selection on output */ 1886 Boolean keepSelection; /* do not lose selection on output */
1882 Boolean replyToEmacs; /* Send emacs escape code when done selecting or extending? */ 1887 Boolean replyToEmacs; /* Send emacs escape code when done selecting or extending? */
1883 Char *selection_data; /* the current selection */ 1888 Char *selection_data; /* the current selection */
1884 int selection_size; /* size of allocated buffer */ 1889 int selection_size; /* size of allocated buffer */
1885 unsigned long selection_length; /* number of significant bytes */ 1890 unsigned long selection_length; /* number of significant bytes */
1886 EventMode eventMode; 1891 EventMode eventMode;
1887 Time selection_time; /* latest event timestamp */ 1892 Time selection_time; /* latest event timestamp */
1888 Time lastButtonUpTime; 1893 Time lastButtonUpTime;
1889 unsigned lastButton; 1894 unsigned lastButton;
1890 1895
@@ -2114,31 +2119,31 @@ typedef struct @@ -2114,31 +2119,31 @@ typedef struct
2114 char *xterm_translations; 2119 char *xterm_translations;
2115 char *extra_translations; 2120 char *extra_translations;
2116#if OPT_INITIAL_ERASE 2121#if OPT_INITIAL_ERASE
2117 int reset_DECBKM; /* reset should set DECBKM */ 2122 int reset_DECBKM; /* reset should set DECBKM */
2118#endif 2123#endif
2119#if OPT_MOD_FKEYS 2124#if OPT_MOD_FKEYS
2120 TModify modify_now; /* current modifier value */ 2125 TModify modify_now; /* current modifier value */
2121 TModify modify_1st; /* original modifier value, for resets */ 2126 TModify modify_1st; /* original modifier value, for resets */
2122 int format_keys; /* format of modifyOtherKeys */ 2127 int format_keys; /* format of modifyOtherKeys */
2123#endif 2128#endif
2124} TKeyboard; 2129} TKeyboard;
2125 2130
2126typedef struct { 2131typedef struct {
2127 char *f_n; /* the normal font */ 2132 String f_n; /* the normal font */
2128 char *f_b; /* the bold font */ 2133 String f_b; /* the bold font */
2129#if OPT_WIDE_CHARS 2134#if OPT_WIDE_CHARS
2130 char *f_w; /* the normal wide font */ 2135 String f_w; /* the normal wide font */
2131 char *f_wb; /* the bold wide font */ 2136 String f_wb; /* the bold wide font */
2132#endif 2137#endif
2133} VTFontNames; 2138} VTFontNames;
2134 2139
2135#define GravityIsNorthWest(w) ((w)->misc.resizeGravity == NorthWestGravity) 2140#define GravityIsNorthWest(w) ((w)->misc.resizeGravity == NorthWestGravity)
2136#define GravityIsSouthWest(w) ((w)->misc.resizeGravity == SouthWestGravity) 2141#define GravityIsSouthWest(w) ((w)->misc.resizeGravity == SouthWestGravity)
2137 2142
2138typedef struct _Misc { 2143typedef struct _Misc {
2139 VTFontNames default_font; 2144 VTFontNames default_font;
2140 char *geo_metry; 2145 char *geo_metry;
2141 char *T_geometry; 2146 char *T_geometry;
2142#if OPT_WIDE_CHARS 2147#if OPT_WIDE_CHARS
2143 Boolean cjk_width; /* true for built-in CJK wcwidth() */ 2148 Boolean cjk_width; /* true for built-in CJK wcwidth() */
2144 Boolean mk_width; /* true for simpler built-in wcwidth() */ 2149 Boolean mk_width; /* true for simpler built-in wcwidth() */

cvs diff -r1.5 -r1.6 xsrc/external/mit/xterm/dist/xterm.man (expand / switch to unified diff)

--- xsrc/external/mit/xterm/dist/xterm.man 2010/06/30 04:49:45 1.5
+++ xsrc/external/mit/xterm/dist/xterm.man 2010/11/21 06:20:30 1.6
@@ -1,15 +1,15 @@ @@ -1,15 +1,15 @@
1'\" t 1'\" t
2.\" $XTermId: xterm.man,v 1.465 2010/06/15 09:38:48 tom Exp $ 2.\" $XTermId: xterm.man,v 1.467 2010/10/11 00:36:08 tom Exp $
3.\" 3.\"
4.\" Copyright 1996-2009,2010 by Thomas E. Dickey 4.\" Copyright 1996-2009,2010 by Thomas E. Dickey
5.\" 5.\"
6.\" All Rights Reserved 6.\" All Rights Reserved
7.\" 7.\"
8.\" Permission is hereby granted, free of charge, to any person obtaining a 8.\" Permission is hereby granted, free of charge, to any person obtaining a
9.\" copy of this software and associated documentation files (the 9.\" copy of this software and associated documentation files (the
10.\" "Software"), to deal in the Software without restriction, including 10.\" "Software"), to deal in the Software without restriction, including
11.\" without limitation the rights to use, copy, modify, merge, publish, 11.\" without limitation the rights to use, copy, modify, merge, publish,
12.\" distribute, sublicense, and/or sell copies of the Software, and to 12.\" distribute, sublicense, and/or sell copies of the Software, and to
13.\" permit persons to whom the Software is furnished to do so, subject to 13.\" permit persons to whom the Software is furnished to do so, subject to
14.\" the following conditions: 14.\" the following conditions:
15.\" 15.\"
@@ -72,27 +72,27 @@ @@ -72,27 +72,27 @@
72.. 72..
73.\" Escape single quotes in literal strings from groff's Unicode transform. 73.\" Escape single quotes in literal strings from groff's Unicode transform.
74.ie \n(.g .ds AQ \(aq 74.ie \n(.g .ds AQ \(aq
75.el .ds AQ ' 75.el .ds AQ '
76.ie \n(.g .ds `` \(lq 76.ie \n(.g .ds `` \(lq
77.el .ds `` `` 77.el .ds `` ``
78.ie \n(.g .ds '' \(rq 78.ie \n(.g .ds '' \(rq
79.el .ds '' '' 79.el .ds '' ''
80.TH XTERM 1 __vendorversion__ 80.TH XTERM 1 __vendorversion__
81.SH NAME 81.SH NAME
82xterm \- terminal emulator for X 82xterm \- terminal emulator for X
83.SH SYNOPSIS 83.SH SYNOPSIS
84.B xterm 84.B xterm
85[-\fItoolkitoption\fP ...] [-\fIoption\fP ...] [\fIshell\fP] 85[\-\fItoolkitoption\fP ...] [\-\fIoption\fP ...] [\fIshell\fP]
86.SH DESCRIPTION 86.SH DESCRIPTION
87The \fIxterm\fP program is a terminal emulator for the X Window System. 87The \fIxterm\fP program is a terminal emulator for the X Window System.
88It provides DEC VT102/VT220 (VTxxx) and Tektronix 4014 88It provides DEC VT102/VT220 (VTxxx) and Tektronix 4014
89compatible terminals for programs that cannot 89compatible terminals for programs that cannot
90use the window system directly. 90use the window system directly.
91If the underlying operating system supports 91If the underlying operating system supports
92terminal resizing capabilities (for example, the SIGWINCH signal in systems 92terminal resizing capabilities (for example, the SIGWINCH signal in systems
93derived from 4.3bsd), \fIxterm\fP will use the facilities to notify programs 93derived from 4.3bsd), \fIxterm\fP will use the facilities to notify programs
94running in the window whenever it is resized. 94running in the window whenever it is resized.
95. 95.
96.PP 96.PP
97The VTxxx and Tektronix 4014 terminals each have their own window so that you 97The VTxxx and Tektronix 4014 terminals each have their own window so that you
98can edit text in one and look at graphics in the other at the same time. 98can edit text in one and look at graphics in the other at the same time.
@@ -147,27 +147,27 @@ document.) @@ -147,27 +147,27 @@ document.)
147. 147.
148.PP 148.PP
149The Tektronix 4014 emulation is also fairly good. 149The Tektronix 4014 emulation is also fairly good.
150It supports 12-bit graphics addressing, scaled to the window size. 150It supports 12-bit graphics addressing, scaled to the window size.
151Four different font sizes and five different lines types are supported. 151Four different font sizes and five different lines types are supported.
152There is no write-through or defocused mode support. 152There is no write-through or defocused mode support.
153The Tektronix text and graphics commands are recorded internally by 153The Tektronix text and graphics commands are recorded internally by
154.I xterm 154.I xterm
155and may be written to a file by sending the COPY escape sequence (or through 155and may be written to a file by sending the COPY escape sequence (or through
156the 156the
157.B Tektronix 157.B Tektronix
158menu; see below). 158menu; see below).
159The name of the file will be 159The name of the file will be
160\*(``\fBCOPY\fIyyyy\fB-\fIMM\fB-\fIdd\fB.\fIhh\fB:\fImm\fB:\fIss\fR\*('', where 160\*(``\fBCOPY\fIyyyy\fB\-\fIMM\fB\-\fIdd\fB.\fIhh\fB:\fImm\fB:\fIss\fR\*('', where
161.IR yyyy , 161.IR yyyy ,
162.IR MM , 162.IR MM ,
163.IR dd , 163.IR dd ,
164.IR hh , 164.IR hh ,
165.I mm 165.I mm
166and 166and
167.I ss 167.I ss
168are the year, month, day, hour, minute and second when the COPY was performed 168are the year, month, day, hour, minute and second when the COPY was performed
169(the file is created in the directory 169(the file is created in the directory
170.I xterm 170.I xterm
171is started in, or the home directory for a login 171is started in, or the home directory for a login
172.IR xterm ). 172.IR xterm ).
173. 173.
@@ -218,993 +218,993 @@ on the screen. @@ -218,993 +218,993 @@ on the screen.
218allows character-based applications to receive mouse events (currently 218allows character-based applications to receive mouse events (currently
219button-press and release events, and button-motion events) 219button-press and release events, and button-motion events)
220as keyboard control sequences. 220as keyboard control sequences.
221See \fIXterm Control Sequences\fP for details. 221See \fIXterm Control Sequences\fP for details.
222. 222.
223. 223.
224.SH OPTIONS 224.SH OPTIONS
225The \fIxterm\fP terminal emulator 225The \fIxterm\fP terminal emulator
226accepts the standard X Toolkit command line options as well as 226accepts the standard X Toolkit command line options as well as
227many application-specific options. 227many application-specific options.
228If the option begins with a 228If the option begins with a
229.RB ` + ' 229.RB ` + '
230instead of a 230instead of a
231.RB ` - ', 231.RB ` \- ',
232the option is restored to its default value. 232the option is restored to its default value.
233The \fB-version\fP and \fB-help\fP options are interpreted even if \fIxterm\fP 233The \fB\-version\fP and \fB\-help\fP options are interpreted even if \fIxterm\fP
234cannot open the display, and are useful for testing and configuration scripts: 234cannot open the display, and are useful for testing and configuration scripts:
235.TP 8 235.TP 8
236.B -version 236.B \-version
237This causes \fIxterm\fP to print a version number to the standard output. 237This causes \fIxterm\fP to print a version number to the standard output.
238.TP 8 238.TP 8
239.B -help 239.B \-help
240This causes \fIxterm\fP to print out a verbose message describing its options, 240This causes \fIxterm\fP to print out a verbose message describing its options,
241one per line. 241one per line.
242The message is written to the standard output. 242The message is written to the standard output.
243\fIXterm\fP generates this message, sorting it and noting whether 243\fIXterm\fP generates this message, sorting it and noting whether
244a "\fB-option\fP" 244a "\fB\-option\fP"
245or a "\fB+option\fP" turns the feature on or off, 245or a "\fB+option\fP" turns the feature on or off,
246since some features historically have been one or the other. 246since some features historically have been one or the other.
247\fIXterm\fP generates a concise help message (multiple options per line) 247\fIXterm\fP generates a concise help message (multiple options per line)
248when an unknown option is used, e.g., 248when an unknown option is used, e.g.,
249.RS 249.RS
250 \fBxterm -z\fP 250 \fBxterm \-z\fP
251.RE 251.RE
252.IP 252.IP
253If the logic for a particular option such as logging is not compiled 253If the logic for a particular option such as logging is not compiled
254into \fIxterm\fP, the help text for that option also is not displayed 254into \fIxterm\fP, the help text for that option also is not displayed
255by the \fB-help\fP option. 255by the \fB\-help\fP option.
256. 256.
257.PP 257.PP
258One parameter (after all options) may be given. 258One parameter (after all options) may be given.
259That overrides \fIxterm\fP's built-in choice of shell program. 259That overrides \fIxterm\fP's built-in choice of shell program.
260Normally \fIxterm\fP checks the SHELL variable. 260Normally \fIxterm\fP checks the SHELL variable.
261If that is not set, \fIxterm\fP tries to use the shell program specified 261If that is not set, \fIxterm\fP tries to use the shell program specified
262in the password file. 262in the password file.
263If that is not set, \fIxterm\fP uses \fI/bin/sh\fP. 263If that is not set, \fIxterm\fP uses \fI/bin/sh\fP.
264If the parameter names an executable file, \fIxterm\fP uses that instead. 264If the parameter names an executable file, \fIxterm\fP uses that instead.
265The parameter must be an absolute path, or name a file found on the user's 265The parameter must be an absolute path, or name a file found on the user's
266PATH (and thereby construct an absolute path). 266PATH (and thereby construct an absolute path).
267The \fB-e\fP option cannot be used with this parameter since 267The \fB\-e\fP option cannot be used with this parameter since
268it uses all parameters following the option. 268it uses all parameters following the option.
269.PP 269.PP
270The other options are used to control the appearance and behavior. 270The other options are used to control the appearance and behavior.
271Not all options are necessarily configured into your copy of \fIxterm\fP: 271Not all options are necessarily configured into your copy of \fIxterm\fP:
272.TP 8 272.TP 8
273.B -132 273.B \-132
274Normally, the VT102 DECCOLM escape sequence that switches between 80 and 274Normally, the VT102 DECCOLM escape sequence that switches between 80 and
275132 column mode is ignored. 275132 column mode is ignored.
276This option causes the DECCOLM escape sequence to be recognized, and the 276This option causes the DECCOLM escape sequence to be recognized, and the
277.I xterm 277.I xterm
278window will resize appropriately. 278window will resize appropriately.
279.TP 8 279.TP 8
280.B -ah 280.B \-ah
281This option indicates that 281This option indicates that
282.I xterm 282.I xterm
283should always highlight the text cursor. 283should always highlight the text cursor.
284By default, 284By default,
285.I xterm 285.I xterm
286will display a hollow text cursor whenever the focus is lost or the 286will display a hollow text cursor whenever the focus is lost or the
287pointer leaves the window. 287pointer leaves the window.
288.TP 8 288.TP 8
289.B +ah 289.B +ah
290This option indicates that 290This option indicates that
291.I xterm 291.I xterm
292should do text cursor highlighting based on focus. 292should do text cursor highlighting based on focus.
293.TP 8 293.TP 8
294.B -ai 294.B \-ai
295This option disables active icon support if that feature was compiled 295This option disables active icon support if that feature was compiled
296into \fIxterm\fP. 296into \fIxterm\fP.
297This is equivalent to setting the \fIvt100\fP resource 297This is equivalent to setting the \fIvt100\fP resource
298\fBactiveIcon\fP to \*(``false\*(''. 298\fBactiveIcon\fP to \*(``false\*(''.
299.TP 8 299.TP 8
300.B +ai 300.B +ai
301This option enables active icon support if that feature was compiled 301This option enables active icon support if that feature was compiled
302into \fIxterm\fP. 302into \fIxterm\fP.
303This is equivalent to setting the \fIvt100\fP resource 303This is equivalent to setting the \fIvt100\fP resource
304\fBactiveIcon\fP to \*(``true\*(''. 304\fBactiveIcon\fP to \*(``true\*(''.
305.TP 8 305.TP 8
306.B -aw 306.B \-aw
307This option indicates that auto-wraparound should be allowed. 307This option indicates that auto-wraparound should be allowed.
308This 308This
309allows the cursor to automatically wrap to the beginning of the next 309allows the cursor to automatically wrap to the beginning of the next
310line when it is at the rightmost position of a line and text is 310line when it is at the rightmost position of a line and text is
311output. 311output.
312.TP 8 312.TP 8
313.B +aw 313.B +aw
314This option indicates that auto-wraparound should not be allowed. 314This option indicates that auto-wraparound should not be allowed.
315.TP 8 315.TP 8
316.BI -b " number" 316.BI \-b " number"
317This option specifies the size of the inner border (the distance between 317This option specifies the size of the inner border (the distance between
318the outer edge of the characters and the window border) in pixels. 318the outer edge of the characters and the window border) in pixels.
319That is the \fIvt100\fP \fIinternalBorder\fP resource. 319That is the \fIvt100\fP \fIinternalBorder\fP resource.
320The 320The
321default is 2. 321default is 2.
322.TP 8 322.TP 8
323.B +bc 323.B +bc
324turn off text cursor blinking. 324turn off text cursor blinking.
325This overrides the \fBcursorBlink\fR resource. 325This overrides the \fBcursorBlink\fR resource.
326.TP 8 326.TP 8
327.B -bc 327.B \-bc
328turn on text cursor blinking. 328turn on text cursor blinking.
329This overrides the \fBcursorBlink\fR resource. 329This overrides the \fBcursorBlink\fR resource.
330.TP 8 330.TP 8
331.BI -bcf " milliseconds" 331.BI \-bcf " milliseconds"
332set the amount of time text cursor is off when blinking via the 332set the amount of time text cursor is off when blinking via the
333\fIcursorOffTime\fP resource. 333\fIcursorOffTime\fP resource.
334.TP 8 334.TP 8
335.BI -bcn " milliseconds" 335.BI \-bcn " milliseconds"
336set the amount of time text cursor is on when blinking via the 336set the amount of time text cursor is on when blinking via the
337\fIcursorOffTime\fP resource. 337\fIcursorOffTime\fP resource.
338.TP 8 338.TP 8
339.B "-bdc" 339.B "\-bdc"
340Set the \fIvt100\fP resource \fBcolorBDMode\fR to \*(``false\*('', 340Set the \fIvt100\fP resource \fBcolorBDMode\fR to \*(``false\*('',
341disabling the display of characters with bold attribute as color 341disabling the display of characters with bold attribute as color
342.TP 8 342.TP 8
343.B "+bdc" 343.B "+bdc"
344Set the \fIvt100\fP resource \fBcolorBDMode\fR to \*(``true\*('', 344Set the \fIvt100\fP resource \fBcolorBDMode\fR to \*(``true\*('',
345enabling the display of characters with bold attribute as color 345enabling the display of characters with bold attribute as color
346rather than bold 346rather than bold
347.TP 8 347.TP 8
348.B "-cb" 348.B "\-cb"
349Set the \fIvt100\fP resource \fBcutToBeginningOfLine\fP to \*(``false\*(''. 349Set the \fIvt100\fP resource \fBcutToBeginningOfLine\fP to \*(``false\*(''.
350.TP 8 350.TP 8
351.B "+cb" 351.B "+cb"
352Set the \fIvt100\fP resource \fBcutToBeginningOfLine\fP to \*(``true\*(''. 352Set the \fIvt100\fP resource \fBcutToBeginningOfLine\fP to \*(``true\*(''.
353.TP 8 353.TP 8
354.B "-cc \fIcharacterclassrange\fP:\fIvalue\fP[,...]" 354.B "\-cc \fIcharacterclassrange\fP:\fIvalue\fP[,...]"
355This sets classes indicated by the given ranges for using in selecting by 355This sets classes indicated by the given ranges for using in selecting by
356words. 356words.
357See the section specifying character classes. 357See the section specifying character classes.
358and discussion of the \fIcharClass\fP resource. 358and discussion of the \fIcharClass\fP resource.
359.TP 8 359.TP 8
360.B "-cjk_width" 360.B "\-cjk_width"
361Set the \fBcjkWidth\fP resource to \*(``true\*(''. 361Set the \fBcjkWidth\fP resource to \*(``true\*(''.
362When turned on, characters with East Asian Ambiguous (A) category in UTR 11 362When turned on, characters with East Asian Ambiguous (A) category in UTR 11
363have a column width of 2. 363have a column width of 2.
364Otherwise, they have a column width of 1. 364Otherwise, they have a column width of 1.
365This may be useful for some legacy CJK text 365This may be useful for some legacy CJK text
366terminal-based programs assuming box drawings and others to have a column 366terminal-based programs assuming box drawings and others to have a column
367width of 2. 367width of 2.
368It also should be turned on when you specify a TrueType 368It also should be turned on when you specify a TrueType
369CJK double-width (bi-width/monospace) font either with \fB-fa\fP at 369CJK double-width (bi-width/monospace) font either with \fB\-fa\fP at
370the command line or \fBfaceName\fP resource. 370the command line or \fBfaceName\fP resource.
371The default is \*(``false\*('' 371The default is \*(``false\*(''
372.TP 8 372.TP 8
373.B "+cjk_width" 373.B "+cjk_width"
374Reset the \fBcjkWidth\fP resource. 374Reset the \fBcjkWidth\fP resource.
375.TP 8 375.TP 8
376.BI -class " string" 376.BI \-class " string"
377This option allows you to override \fIxterm\fP's resource class. 377This option allows you to override \fIxterm\fP's resource class.
378Normally it is \*(``XTerm\*('', but 378Normally it is \*(``XTerm\*('', but
379can be set to another class such as \*(``UXTerm\*('' to override selected resources. 379can be set to another class such as \*(``UXTerm\*('' to override selected resources.
380.TP 8 380.TP 8
381.B "-cm" 381.B "\-cm"
382This option disables recognition of ANSI color-change escape sequences. 382This option disables recognition of ANSI color-change escape sequences.
383It sets the \fIcolorMode\fP resource to \*(``false\*(''. 383It sets the \fIcolorMode\fP resource to \*(``false\*(''.
384.TP 8 384.TP 8
385.B "+cm" 385.B "+cm"
386This option enables recognition of ANSI color-change escape sequences. 386This option enables recognition of ANSI color-change escape sequences.
387This is the same as the \fIvt100\fP resource \fBcolorMode\fP. 387This is the same as the \fIvt100\fP resource \fBcolorMode\fP.
388.TP 8 388.TP 8
389.B "-cn" 389.B "\-cn"
390This option indicates that newlines should not be cut in line-mode 390This option indicates that newlines should not be cut in line-mode
391selections. 391selections.
392It sets the \fIcutNewline\fP resource to \*(``false\*(''. 392It sets the \fIcutNewline\fP resource to \*(``false\*(''.
393.TP 8 393.TP 8
394.B +cn 394.B +cn
395This option indicates that newlines should be cut in line-mode selections. 395This option indicates that newlines should be cut in line-mode selections.
396It sets the \fIcutNewline\fP resource to \*(``true\*(''. 396It sets the \fIcutNewline\fP resource to \*(``true\*(''.
397.TP 8 397.TP 8
398.BI -cr " color" 398.BI \-cr " color"
399This option specifies the color to use for text cursor. 399This option specifies the color to use for text cursor.
400The default is to 400The default is to
401use the same foreground color that is used for text. 401use the same foreground color that is used for text.
402It sets the \fIcursorColor\fP resource according to the parameter. 402It sets the \fIcursorColor\fP resource according to the parameter.
403.TP 8 403.TP 8
404.B -cu 404.B \-cu
405This option indicates that \fIxterm\fP should work around a bug in the 405This option indicates that \fIxterm\fP should work around a bug in the
406.IR more (1) 406.IR more (1)
407program that causes it 407program that causes it
408to incorrectly display lines that are exactly the width of the window and 408to incorrectly display lines that are exactly the width of the window and
409are followed by a line beginning with a tab 409are followed by a line beginning with a tab
410(the leading tabs are not displayed). 410(the leading tabs are not displayed).
411This option is so named because it was originally thought to be a bug 411This option is so named because it was originally thought to be a bug
412in the 412in the
413.IR curses (3x) 413.IR curses (3x)
414cursor motion package. 414cursor motion package.
415.TP 8 415.TP 8
416.B +cu 416.B +cu
417This option indicates that \fIxterm\fP should not work around the 417This option indicates that \fIxterm\fP should not work around the
418.IR more (1) 418.IR more (1)
419bug mentioned above. 419bug mentioned above.
420.TP 8 420.TP 8
421.B "-dc" 421.B "\-dc"
422This option disables the escape sequence to change dynamic colors: 422This option disables the escape sequence to change dynamic colors:
423the vt100 foreground and background colors, 423the vt100 foreground and background colors,
424its text cursor color, 424its text cursor color,
425the pointer cursor foreground and background colors, 425the pointer cursor foreground and background colors,
426the Tektronix emulator foreground and background colors, 426the Tektronix emulator foreground and background colors,
427its text cursor color 427its text cursor color
428and highlight color. 428and highlight color.
429The option sets the \fIdynamicColors\fP option to \*(``false\*(''. 429The option sets the \fIdynamicColors\fP option to \*(``false\*(''.
430.TP 8 430.TP 8
431.B "+dc" 431.B "+dc"
432This option enables the escape sequence to change dynamic colors. 432This option enables the escape sequence to change dynamic colors.
433The option sets the \fIdynamicColors\fP option to \*(``true\*(''. 433The option sets the \fIdynamicColors\fP option to \*(``true\*(''.
434.TP 8 434.TP 8
435.BI -e " program \fP[ \fIarguments \fP.\|.\|. ]\fI" 435.BI \-e " program \fP[ \fIarguments \fP.\|.\|. ]\fI"
436This option specifies the program (and its command line arguments) to be 436This option specifies the program (and its command line arguments) to be
437run in the \fIxterm\fP window. 437run in the \fIxterm\fP window.
438It also sets the window title and icon 438It also sets the window title and icon
439name to be the basename of the program being executed if neither \fI-T\fP 439name to be the basename of the program being executed if neither \fI\-T\fP
440nor \fI-n\fP are given on the command line. 440nor \fI\-n\fP are given on the command line.
441\fBThis must be the last option on the command line.\fP 441\fBThis must be the last option on the command line.\fP
442.TP 8 442.TP 8
443.BI -en " encoding" 443.BI \-en " encoding"
444This option determines the encoding on which \fIxterm\fP runs. 444This option determines the encoding on which \fIxterm\fP runs.
445It sets the \fBlocale\fR resource. 445It sets the \fBlocale\fR resource.
446Encodings other than UTF-8 are supported by using \fIluit\fR. 446Encodings other than UTF-8 are supported by using \fIluit\fR.
447The \fB-lc\fR option should be used instead of \fB-en\fR for 447The \fB\-lc\fR option should be used instead of \fB\-en\fR for
448systems with locale support. 448systems with locale support.
449.TP 8 449.TP 8
450.BI -fb " font" 450.BI \-fb " font"
451This option specifies a font to be used when displaying bold text. 451This option specifies a font to be used when displaying bold text.
452It sets the \fBboldFont\fR resource. 452It sets the \fBboldFont\fR resource.
453.IP 453.IP
454This font must be the same height and width as the normal font, otherwise it is ignored. 454This font must be the same height and width as the normal font, otherwise it is ignored.
455If only one of the normal or bold fonts is specified, it will be used as the 455If only one of the normal or bold fonts is specified, it will be used as the
456normal font and the bold font will be produced by overstriking this font. 456normal font and the bold font will be produced by overstriking this font.
457.IP 457.IP
458See also the discussion of \fBboldMode\fP and \fBalwaysBoldMode\fP resources. 458See also the discussion of \fBboldMode\fP and \fBalwaysBoldMode\fP resources.
459.TP 8 459.TP 8
460.BI -fa " pattern" 460.BI \-fa " pattern"
461This option sets the pattern for fonts selected from the FreeType 461This option sets the pattern for fonts selected from the FreeType
462library if support for that library was compiled into \fIxterm\fP. 462library if support for that library was compiled into \fIxterm\fP.
463This corresponds to the \fBfaceName\fP resource. 463This corresponds to the \fBfaceName\fP resource.
464When a CJK 464When a CJK
465double-width font is specified, you also need to turn 465double-width font is specified, you also need to turn
466on the \fBcjkWidth\fP resource. 466on the \fBcjkWidth\fP resource.
467.IP 467.IP
468See also the \fBrenderFont\fP resource, 468See also the \fBrenderFont\fP resource,
469which combines with this to determine whether FreeType fonts are 469which combines with this to determine whether FreeType fonts are
470initially active. 470initially active.
471.TP 8 471.TP 8
472.BI -fbb 472.BI \-fbb
473This option indicates that \fIxterm\fP should compare normal and bold fonts bounding 473This option indicates that \fIxterm\fP should compare normal and bold fonts bounding
474boxes to ensure they are compatible. 474boxes to ensure they are compatible.
475It sets the \fBfreeBoldBox\fP resource to \*(``false\*(''. 475It sets the \fBfreeBoldBox\fP resource to \*(``false\*(''.
476.TP 8 476.TP 8
477.BI +fbb 477.BI +fbb
478This option indicates that \fIxterm\fP should not compare normal and bold fonts bounding 478This option indicates that \fIxterm\fP should not compare normal and bold fonts bounding
479boxes to ensure they are compatible. 479boxes to ensure they are compatible.
480It sets the \fBfreeBoldBox\fP resource to \*(``true\*(''. 480It sets the \fBfreeBoldBox\fP resource to \*(``true\*(''.
481.TP 8 481.TP 8
482.BI -fbx 482.BI \-fbx
483This option indicates that \fIxterm\fP should not assume that the 483This option indicates that \fIxterm\fP should not assume that the
484normal and bold fonts have VT100 line-drawing characters. 484normal and bold fonts have VT100 line-drawing characters.
485If any are missing, \fIxterm\fP will draw the characters directly. 485If any are missing, \fIxterm\fP will draw the characters directly.
486It sets the \fBforceBoxChars\fP resource to \*(``false\*(''. 486It sets the \fBforceBoxChars\fP resource to \*(``false\*(''.
487.TP 8 487.TP 8
488.BI +fbx 488.BI +fbx
489This option indicates that \fIxterm\fP should assume that the 489This option indicates that \fIxterm\fP should assume that the
490normal and bold fonts have VT100 line-drawing characters. 490normal and bold fonts have VT100 line-drawing characters.
491It sets the \fBforceBoxChars\fP resource to \*(``true\*(''. 491It sets the \fBforceBoxChars\fP resource to \*(``true\*(''.
492.TP 8 492.TP 8
493.BI -fd " pattern" 493.BI \-fd " pattern"
494This option sets the pattern for double-width fonts selected from the FreeType 494This option sets the pattern for double-width fonts selected from the FreeType
495library if support for that library was compiled into \fIxterm\fP. 495library if support for that library was compiled into \fIxterm\fP.
496This corresponds to the \fBfaceNameDoublesize\fP resource. 496This corresponds to the \fBfaceNameDoublesize\fP resource.
497.TP 8 497.TP 8
498.BI -fi " font" 498.BI \-fi " font"
499This option sets the font for active icons if that feature was compiled 499This option sets the font for active icons if that feature was compiled
500into \fIxterm\fP. 500into \fIxterm\fP.
501.IP 501.IP
502See also the discussion of the \fBiconFont\fP resource. 502See also the discussion of the \fBiconFont\fP resource.
503.TP 8 503.TP 8
504.BI -fs " size" 504.BI \-fs " size"
505This option sets the pointsize for fonts selected from the FreeType 505This option sets the pointsize for fonts selected from the FreeType
506library if support for that library was compiled into \fIxterm\fP. 506library if support for that library was compiled into \fIxterm\fP.
507This corresponds to the \fBfaceSize\fP resource. 507This corresponds to the \fBfaceSize\fP resource.
508.TP 8 508.TP 8
509.B -fw \fIfont\fP 509.B \-fw \fIfont\fP
510This option specifies the font to be used for displaying wide text. 510This option specifies the font to be used for displaying wide text.
511By default, 511By default,
512it will attempt to use a font twice as wide as the font that will be used to 512it will attempt to use a font twice as wide as the font that will be used to
513draw normal text. 513draw normal text.
514If no double-width font is found, it will improvise, by stretching 514If no double-width font is found, it will improvise, by stretching
515the normal font. 515the normal font.
516This corresponds to the \fBwideFont\fP resource. 516This corresponds to the \fBwideFont\fP resource.
517.TP 8 517.TP 8
518.B -fwb \fIfont\fP 518.B \-fwb \fIfont\fP
519This option specifies the font to be used for displaying bold wide text. 519This option specifies the font to be used for displaying bold wide text.
520By default, 520By default,
521it will attempt to use a font twice as wide as the font that will be used to 521it will attempt to use a font twice as wide as the font that will be used to
522draw bold text. 522draw bold text.
523If no double-width font is found, it will improvise, by stretching 523If no double-width font is found, it will improvise, by stretching
524the bold font. 524the bold font.
525This corresponds to the \fBwideBoldFont\fP resource. 525This corresponds to the \fBwideBoldFont\fP resource.
526.TP 8 526.TP 8
527.B -fx \fIfont\fP 527.B \-fx \fIfont\fP
528This option specifies the font to be used for displaying the preedit string 528This option specifies the font to be used for displaying the preedit string
529in the "OverTheSpot" input method. 529in the "OverTheSpot" input method.
530.IP 530.IP
531See also the discussion of the \fBximFont\fP resource. 531See also the discussion of the \fBximFont\fP resource.
532.TP 8 532.TP 8
533.BI -hc " color" 533.BI \-hc " color"
534(see \fB-selbg\fP). 534(see \fB\-selbg\fP).
535.TP 8 535.TP 8
536.BI -hf 536.BI \-hf
537This option indicates that HP Function Key escape codes should be generated 537This option indicates that HP Function Key escape codes should be generated
538for function keys. 538for function keys.
539It sets the \fBhpFunctionKeys\fP resource to \*(``true\*(''. 539It sets the \fBhpFunctionKeys\fP resource to \*(``true\*(''.
540.TP 8 540.TP 8
541.BI +hf 541.BI +hf
542This option indicates that HP Function Key escape codes should not be generated 542This option indicates that HP Function Key escape codes should not be generated
543for function keys. 543for function keys.
544It sets the \fBhpFunctionKeys\fP resource to \*(``false\*(''. 544It sets the \fBhpFunctionKeys\fP resource to \*(``false\*(''.
545.TP 8 545.TP 8
546.BI -hm 546.BI \-hm
547Tells \fIxterm\fP to use 547Tells \fIxterm\fP to use
548\fBhighlightTextColor\fP and \fBhighlightColor\fP 548\fBhighlightTextColor\fP and \fBhighlightColor\fP
549to override the reversed foreground/background colors in a selection. 549to override the reversed foreground/background colors in a selection.
550It sets the \fBhighlightColorMode\fP resource to \*(``true\*(''. 550It sets the \fBhighlightColorMode\fP resource to \*(``true\*(''.
551.TP 8 551.TP 8
552.BI +hm 552.BI +hm
553Tells \fIxterm\fP not to use 553Tells \fIxterm\fP not to use
554\fBhighlightTextColor\fP and \fBhighlightColor\fP 554\fBhighlightTextColor\fP and \fBhighlightColor\fP
555to override the reversed foreground/background colors in a selection. 555to override the reversed foreground/background colors in a selection.
556It sets the \fBhighlightColorMode\fP resource to \*(``false\*(''. 556It sets the \fBhighlightColorMode\fP resource to \*(``false\*(''.
557.TP 8 557.TP 8
558.BI -hold 558.BI \-hold
559Turn on the \fBhold\fP resource, i.e., 559Turn on the \fBhold\fP resource, i.e.,
560\fIxterm\fP will not immediately destroy its window when the shell command completes. 560\fIxterm\fP will not immediately destroy its window when the shell command completes.
561It will wait until you use the window manager to destroy/kill the window, or 561It will wait until you use the window manager to destroy/kill the window, or
562if you use the menu entries that send a signal, e.g., HUP or KILL. 562if you use the menu entries that send a signal, e.g., HUP or KILL.
563.TP 8 563.TP 8
564.BI +hold 564.BI +hold
565Turn off the \fBhold\fP resource, i.e., 565Turn off the \fBhold\fP resource, i.e.,
566\fIxterm\fP will immediately destroy its window when the shell command completes. 566\fIxterm\fP will immediately destroy its window when the shell command completes.
567.TP 8 567.TP 8
568.B -ie 568.B \-ie
569Turn on the \fBptyInitialErase\fP resource, i.e., 569Turn on the \fBptyInitialErase\fP resource, i.e.,
570use the pseudo-terminal's sense of the stty erase value. 570use the pseudo-terminal's sense of the stty erase value.
571.TP 8 571.TP 8
572.B +ie 572.B +ie
573Turn off the \fBptyInitialErase\fP resource, i.e., 573Turn off the \fBptyInitialErase\fP resource, i.e.,
574set the stty erase value using the \fBkb\fP string from the termcap entry as 574set the stty erase value using the \fBkb\fP string from the termcap entry as
575a reference, if available. 575a reference, if available.
576.TP 8 576.TP 8
577.B -im 577.B \-im
578Turn on the \fBuseInsertMode\fP resource, 578Turn on the \fBuseInsertMode\fP resource,
579which forces use of insert mode by adding appropriate entries to the TERMCAP 579which forces use of insert mode by adding appropriate entries to the TERMCAP
580environment variable. 580environment variable.
581.TP 8 581.TP 8
582.B +im 582.B +im
583Turn off the \fBuseInsertMode\fP resource. 583Turn off the \fBuseInsertMode\fP resource.
584.TP 8 584.TP 8
585.BI -into " windowId" 585.BI \-into " windowId"
586Given an X window identifier (a decimal integer), 586Given an X window identifier (a decimal integer),
587\fIxterm\fP will reparent its top-level shell widget to that window. 587\fIxterm\fP will reparent its top-level shell widget to that window.
588This is used to embed \fIxterm\fP within other applications. 588This is used to embed \fIxterm\fP within other applications.
589.TP 8 589.TP 8
590.B -j 590.B \-j
591This option indicates that \fIxterm\fP should do jump scrolling. 591This option indicates that \fIxterm\fP should do jump scrolling.
592It corresponds to the \fBjumpScroll\fP resource. 592It corresponds to the \fBjumpScroll\fP resource.
593Normally, 593Normally,
594text is scrolled one line at a time; this option allows \fIxterm\fP to move 594text is scrolled one line at a time; this option allows \fIxterm\fP to move
595multiple lines at a time so that it does not fall as far behind. 595multiple lines at a time so that it does not fall as far behind.
596Its use is 596Its use is
597strongly recommended since it makes \fIxterm\fP much faster when scanning 597strongly recommended since it makes \fIxterm\fP much faster when scanning
598through large amounts of text. 598through large amounts of text.
599The VT100 escape sequences for enabling and 599The VT100 escape sequences for enabling and
600disabling smooth scroll as well as the \*(``VT Options\*('' 600disabling smooth scroll as well as the \*(``VT Options\*(''
601menu can be used to turn this 601menu can be used to turn this
602feature on or off. 602feature on or off.
603.TP 8 603.TP 8
604.B +j 604.B +j
605This option indicates that \fIxterm\fP should not do jump scrolling. 605This option indicates that \fIxterm\fP should not do jump scrolling.
606.TP 8 606.TP 8
607.B -k8 607.B \-k8
608This option sets the \fBallowC1Printable\fP resource. 608This option sets the \fBallowC1Printable\fP resource.
609When \fBallowC1Printable\fP is set, \fIxterm\fP overrides the mapping 609When \fBallowC1Printable\fP is set, \fIxterm\fP overrides the mapping
610of C1 control characters (code 128-159) to treat them as printable. 610of C1 control characters (code 128-159) to treat them as printable.
611.TP 8 611.TP 8
612.B +k8 612.B +k8
613This option resets the \fBallowC1Printable\fP resource. 613This option resets the \fBallowC1Printable\fP resource.
614.TP 8 614.TP 8
615.BI -kt " keyboardtype" 615.BI \-kt " keyboardtype"
616This option sets the \fBkeyboardType\fP resource. 616This option sets the \fBkeyboardType\fP resource.
617Possible values include: 617Possible values include:
618\*(``unknown\*('', 618\*(``unknown\*('',
619\*(``default\*('', 619\*(``default\*('',
620\*(``hp\*('', 620\*(``hp\*('',
621\*(``sco\*('', 621\*(``sco\*('',
622\*(``sun\*('', 622\*(``sun\*('',
623\*(``tcap\*('' and 623\*(``tcap\*('' and
624\*(``vt220\*(''. 624\*(``vt220\*(''.
625.IP 625.IP
626The value \*(``unknown\*('', 626The value \*(``unknown\*('',
627causes the corresponding resource to be ignored. 627causes the corresponding resource to be ignored.
628.IP 628.IP
629The value \*(``default\*('', 629The value \*(``default\*('',
630suppresses the associated resources 630suppresses the associated resources
631.BR hpFunctionKeys , 631.BR hpFunctionKeys ,
632.BR scoFunctionKeys , 632.BR scoFunctionKeys ,
633.BR sunFunctionKeys, 633.BR sunFunctionKeys,
634.BR tcapFunctionKeys 634.BR tcapFunctionKeys
635and 635and
636.BR sunKeyboard , 636.BR sunKeyboard ,
637using the Sun/PC keyboard layout. 637using the Sun/PC keyboard layout.
638.TP 8 638.TP 8
639.B -l 639.B \-l
640Turn logging on. 640Turn logging on.
641Normally logging is not supported, due to security concerns. 641Normally logging is not supported, due to security concerns.
642Some versions of \fIxterm\fP may have logging enabled. 642Some versions of \fIxterm\fP may have logging enabled.
643The logfile is written to the directory from which \fIxterm\fP is 643The logfile is written to the directory from which \fIxterm\fP is
644invoked. 644invoked.
645The filename is generated, of the form 645The filename is generated, of the form
646.sp 646.sp
647 XtermLog.\fIXXXXXX\fR 647 XtermLog.\fIXXXXXX\fR
648.sp 648.sp
649or 649or
650.sp 650.sp
651 Xterm.log.\fIhostname.yyyy.mm.dd.hh.mm.ss.XXXXXX\fR 651 Xterm.log.\fIhostname.yyyy.mm.dd.hh.mm.ss.XXXXXX\fR
652.sp 652.sp
653depending on how \fIxterm\fP was built. 653depending on how \fIxterm\fP was built.
654.TP 8 654.TP 8
655.B +l 655.B +l
656Turn logging off. 656Turn logging off.
657.TP 8 657.TP 8
658.B -lc 658.B \-lc
659Turn on support of various encodings according to the users' 659Turn on support of various encodings according to the users'
660locale setting, i.e., LC_ALL, LC_CTYPE, or LANG environment variables. 660locale setting, i.e., LC_ALL, LC_CTYPE, or LANG environment variables.
661This is achieved by turning on UTF-8 mode and by invoking \fIluit\fR for 661This is achieved by turning on UTF-8 mode and by invoking \fIluit\fR for
662conversion between locale encodings and UTF-8. 662conversion between locale encodings and UTF-8.
663(\fIluit\fR is not invoked in UTF-8 locales.) 663(\fIluit\fR is not invoked in UTF-8 locales.)
664This corresponds to the \fBlocale\fR resource. 664This corresponds to the \fBlocale\fR resource.
665.IP 665.IP
666The actual list of encodings which are supported is determined by \fIluit\fR. 666The actual list of encodings which are supported is determined by \fIluit\fR.
667Consult the \fIluit\fR manual page for further details. 667Consult the \fIluit\fR manual page for further details.
668.IP 668.IP
669See also the discussion of the \fB-u8\fP option which supports UTF-8 locales. 669See also the discussion of the \fB\-u8\fP option which supports UTF-8 locales.
670.TP 8 670.TP 8
671.B +lc 671.B +lc
672Turn off support of automatic selection of locale encodings. 672Turn off support of automatic selection of locale encodings.
673Conventional 8bit mode or, in UTF-8 locales or with \fB-u8\fP option, 673Conventional 8bit mode or, in UTF-8 locales or with \fB\-u8\fP option,
674UTF-8 mode will be used. 674UTF-8 mode will be used.
675.TP 8 675.TP 8
676.BI -lcc " path" 676.BI \-lcc " path"
677File name for the encoding converter from/to locale encodings 677File name for the encoding converter from/to locale encodings
678and UTF-8 which is used with \fB-lc\fP option or \fBlocale\fR resource. 678and UTF-8 which is used with \fB\-lc\fP option or \fBlocale\fR resource.
679This corresponds to the \fBlocaleFilter\fR resource. 679This corresponds to the \fBlocaleFilter\fR resource.
680.TP 8 680.TP 8
681.B -leftbar 681.B \-leftbar
682Force scrollbar to the left side of VT100 screen. 682Force scrollbar to the left side of VT100 screen.
683This is the default, unless you have set the rightScrollBar resource. 683This is the default, unless you have set the rightScrollBar resource.
684.TP 8 684.TP 8
685.BI -lf " filename" 685.BI \-lf " filename"
686Specify the log-filename. 686Specify the log-filename.
687See the \fB-l\fP option. 687See the \fB\-l\fP option.
688.TP 8 688.TP 8
689.B -ls 689.B \-ls
690This option indicates that the shell that is started in the \fIxterm\fP window 690This option indicates that the shell that is started in the \fIxterm\fP window
691will be a login shell (i.e., the first character of argv[0] will be a dash, 691will be a login shell (i.e., the first character of argv[0] will be a dash,
692indicating to the shell that it should read the user's .login or .profile). 692indicating to the shell that it should read the user's .login or .profile).
693.IP 693.IP
694The \fB-ls\fP flag and the \fBloginShell\fP resource 694The \fB\-ls\fP flag and the \fBloginShell\fP resource
695are ignored if \fB-e\fP is also given, 695are ignored if \fB\-e\fP is also given,
696because \fIxterm\fP does not know how to make the shell 696because \fIxterm\fP does not know how to make the shell
697start the given command after whatever it does when it is a login 697start the given command after whatever it does when it is a login
698shell - the user's shell of choice need not be a Bourne shell after all. 698shell \- the user's shell of choice need not be a Bourne shell after all.
699Also, \fIxterm\ -e\fP is supposed to provide a consistent 699Also, \fIxterm\ \-e\fP is supposed to provide a consistent
700functionality for other applications that need to start text-mode 700functionality for other applications that need to start text-mode
701programs in a window, and if \fBloginShell\fP were not ignored, the 701programs in a window, and if \fBloginShell\fP were not ignored, the
702result of ~/.profile might interfere with that. 702result of ~/.profile might interfere with that.
703.IP 703.IP
704If you do want the effect of \fB-ls\fP and \fB-e\fP simultaneously, you 704If you do want the effect of \fB\-ls\fP and \fB\-e\fP simultaneously, you
705may get away with something like 705may get away with something like
706.RS 15 706.RS 15
707xterm -e /bin/bash -l -c "my command here" 707xterm \-e /bin/bash \-l \-c "my command here"
708.RE 708.RE
709.IP 709.IP
710Finally, \fB-ls\fP is not completely ignored, 710Finally, \fB\-ls\fP is not completely ignored,
711because \fIxterm\ -ls\ -e\fP does write a \fI/etc/wtmp\fP entry 711because \fIxterm\ \-ls\ \-e\fP does write a \fI/etc/wtmp\fP entry
712(if configured to do so), 712(if configured to do so),
713whereas \fIxterm\ -e\fP does not. 713whereas \fIxterm\ \-e\fP does not.
714.TP 8 714.TP 8
715.B -maximized 715.B \-maximized
716This option indicates that \fIxterm\fP should ask the window manager to 716This option indicates that \fIxterm\fP should ask the window manager to
717maximize its layout on startup. 717maximize its layout on startup.
718This corresponds to the \fBmaximized\fP resource. 718This corresponds to the \fBmaximized\fP resource.
719.IP 719.IP
720Maximizing is not the reverse of iconifying; 720Maximizing is not the reverse of iconifying;
721it is possible to do both with certain window managers. 721it is possible to do both with certain window managers.
722.TP 8 722.TP 8
723.B +maximized 723.B +maximized
724This option indicates that \fIxterm\fP should ask the window manager to 724This option indicates that \fIxterm\fP should ask the window manager to
725maximize its layout on startup. 725maximize its layout on startup.
726.TP 8 726.TP 8
727.B +ls 727.B +ls
728This option indicates that the shell that is started should not be a login 728This option indicates that the shell that is started should not be a login
729shell (i.e., it will be a normal \*(``subshell\*(''). 729shell (i.e., it will be a normal \*(``subshell\*('').
730.TP 8 730.TP 8
731.B -mb 731.B \-mb
732This option indicates that \fIxterm\fP should ring a margin bell when 732This option indicates that \fIxterm\fP should ring a margin bell when
733the user types near the right end of a line. 733the user types near the right end of a line.
734.TP 8 734.TP 8
735.B +mb 735.B +mb
736This option indicates that margin bell should not be rung. 736This option indicates that margin bell should not be rung.
737.TP 8 737.TP 8
738.BI -mc " milliseconds" 738.BI \-mc " milliseconds"
739This option specifies the maximum time between multi-click selections. 739This option specifies the maximum time between multi-click selections.
740.TP 8 740.TP 8
741.B -mesg 741.B \-mesg
742Turn off the \fBmessages\fP resource, i.e., 742Turn off the \fBmessages\fP resource, i.e.,
743disallow write access to the terminal. 743disallow write access to the terminal.
744.TP 8 744.TP 8
745.B +mesg 745.B +mesg
746Turn on the \fBmessages\fP resource, i.e., 746Turn on the \fBmessages\fP resource, i.e.,
747allow write access to the terminal. 747allow write access to the terminal.
748.TP 8 748.TP 8
749.B "-mk_width" 749.B "\-mk_width"
750Set the \fBmkWidth\fP resource to \*(``true\*(''. 750Set the \fBmkWidth\fP resource to \*(``true\*(''.
751This makes \fIxterm\fP use a built-in version of the wide-character width 751This makes \fIxterm\fP use a built-in version of the wide-character width
752calculation. 752calculation.
753The default is \*(``false\*('' 753The default is \*(``false\*(''
754.TP 8 754.TP 8
755.B "+mk_width" 755.B "+mk_width"
756Reset the \fBmkWidth\fP resource. 756Reset the \fBmkWidth\fP resource.
757.TP 8 757.TP 8
758.BI -ms " color" 758.BI \-ms " color"
759This option specifies the color to be used for the pointer cursor. 759This option specifies the color to be used for the pointer cursor.
760The default 760The default
761is to use the foreground color. 761is to use the foreground color.
762This sets the \fIpointerColor\fP resource. 762This sets the \fIpointerColor\fP resource.
763.TP 8 763.TP 8
764.BI -nb " number" 764.BI \-nb " number"
765This option specifies the number of characters from the right end of a line 765This option specifies the number of characters from the right end of a line
766at which the margin bell, if enabled, will ring. 766at which the margin bell, if enabled, will ring.
767The default is 10. 767The default is 10.
768.TP 8 768.TP 8
769.B "-nul" 769.B "\-nul"
770This option disables the display of underlining. 770This option disables the display of underlining.
771.TP 8 771.TP 8
772.B "+nul" 772.B "+nul"
773This option enables the display of underlining. 773This option enables the display of underlining.
774.TP 8 774.TP 8
775.B -pc 775.B \-pc
776This option enables the PC-style use of bold colors (see boldColors 776This option enables the PC-style use of bold colors (see boldColors
777resource). 777resource).
778.TP 8 778.TP 8
779.B +pc 779.B +pc
780This option disables the PC-style use of bold colors. 780This option disables the PC-style use of bold colors.
781.TP 8 781.TP 8
782.B -pob 782.B \-pob
783This option indicates that the window should be raised whenever a 783This option indicates that the window should be raised whenever a
784Control-G is received. 784Control-G is received.
785.TP 8 785.TP 8
786.B +pob 786.B +pob
787This option indicates that the window should not be raised whenever a 787This option indicates that the window should not be raised whenever a
788Control-G is received. 788Control-G is received.
789.TP 8 789.TP 8
790.B -rightbar 790.B \-rightbar
791Force scrollbar to the right side of VT100 screen. 791Force scrollbar to the right side of VT100 screen.
792.TP 8 792.TP 8
793.B "-rvc" 793.B "\-rvc"
794This option disables the display of characters with reverse attribute as color. 794This option disables the display of characters with reverse attribute as color.
795.TP 8 795.TP 8
796.B "+rvc" 796.B "+rvc"
797This option enables the display of characters with reverse attribute as color. 797This option enables the display of characters with reverse attribute as color.
798.TP 8 798.TP 8
799.B -rw 799.B \-rw
800This option indicates that reverse-wraparound should be allowed. 800This option indicates that reverse-wraparound should be allowed.
801This allows 801This allows
802the cursor to back up from the leftmost column of one line to the rightmost 802the cursor to back up from the leftmost column of one line to the rightmost
803column of the previous line. 803column of the previous line.
804This is very useful for editing long shell 804This is very useful for editing long shell
805command lines and is encouraged. 805command lines and is encouraged.
806This option can be turned on and off from 806This option can be turned on and off from
807the \*(``VT Options\*('' menu. 807the \*(``VT Options\*('' menu.
808.TP 8 808.TP 8
809.B +rw 809.B +rw
810This option indicates that reverse-wraparound should not be allowed. 810This option indicates that reverse-wraparound should not be allowed.
811.TP 8 811.TP 8
812.B -s 812.B \-s
813This option indicates that \fIxterm\fP may scroll asynchronously, meaning that 813This option indicates that \fIxterm\fP may scroll asynchronously, meaning that
814the screen does not have to be kept completely up to date while scrolling. 814the screen does not have to be kept completely up to date while scrolling.
815This allows \fIxterm\fP to run faster when network latencies are very high 815This allows \fIxterm\fP to run faster when network latencies are very high
816and is typically useful when running across a very large internet or many 816and is typically useful when running across a very large internet or many
817gateways. 817gateways.
818.TP 8 818.TP 8
819.B +s 819.B +s
820This option indicates that \fIxterm\fP should scroll synchronously. 820This option indicates that \fIxterm\fP should scroll synchronously.
821.TP 8 821.TP 8
822.B -samename 822.B \-samename
823Does not send title and icon name change requests when the request 823Does not send title and icon name change requests when the request
824would have no effect: the name is not changed. 824would have no effect: the name is not changed.
825This has the advantage 825This has the advantage
826of preventing flicker and the disadvantage of requiring an extra 826of preventing flicker and the disadvantage of requiring an extra
827round trip to the server to find out the previous value. 827round trip to the server to find out the previous value.
828In practice 828In practice
829this should never be a problem. 829this should never be a problem.
830.TP 8 830.TP 8
831.B +samename 831.B +samename
832Always send title and icon name change requests. 832Always send title and icon name change requests.
833.TP 8 833.TP 8
834.B -sb 834.B \-sb
835This option indicates that some number of lines that are scrolled off the top 835This option indicates that some number of lines that are scrolled off the top
836of the window should be saved and that a scrollbar should be displayed so that 836of the window should be saved and that a scrollbar should be displayed so that
837those lines can be viewed. 837those lines can be viewed.
838This option may be turned on and off from the 838This option may be turned on and off from the
839\*(``VT Options\*('' menu. 839\*(``VT Options\*('' menu.
840.TP 8 840.TP 8
841.B +sb 841.B +sb
842This option indicates that a scrollbar should not be displayed. 842This option indicates that a scrollbar should not be displayed.
843.TP 8 843.TP 8
844.BI -selbg " color" 844.BI \-selbg " color"
845This option specifies the color to use for the background of selected text. 845This option specifies the color to use for the background of selected text.
846If not specified, reverse video is used. 846If not specified, reverse video is used.
847See the discussion of the \fBhighlightColor\fP resource. 847See the discussion of the \fBhighlightColor\fP resource.
848.TP 8 848.TP 8
849.BI -selfg " color" 849.BI \-selfg " color"
850This option specifies the color to use for selected text. 850This option specifies the color to use for selected text.
851If not specified, reverse video is used. 851If not specified, reverse video is used.
852See the discussion of the \fBhighlightTextColor\fP resource. 852See the discussion of the \fBhighlightTextColor\fP resource.
853.TP 8 853.TP 8
854.B -sf 854.B \-sf
855This option indicates that Sun Function Key escape codes should be generated 855This option indicates that Sun Function Key escape codes should be generated
856for function keys. 856for function keys.
857.TP 8 857.TP 8
858.B +sf 858.B +sf
859This option indicates that the standard escape codes should be generated for 859This option indicates that the standard escape codes should be generated for
860function keys. 860function keys.
861.TP 8 861.TP 8
862.B -si 862.B \-si
863This option indicates that output to a window should not automatically 863This option indicates that output to a window should not automatically
864reposition the screen to the bottom of the scrolling region. 864reposition the screen to the bottom of the scrolling region.
865This option can be turned on and off from the \*(``VT Options\*('' menu. 865This option can be turned on and off from the \*(``VT Options\*('' menu.
866.TP 8 866.TP 8
867.B +si 867.B +si
868This option indicates that output to a window should cause it to 868This option indicates that output to a window should cause it to
869scroll to the bottom. 869scroll to the bottom.
870.TP 8 870.TP 8
871.B -sk 871.B \-sk
872This option indicates that pressing a key while 872This option indicates that pressing a key while
873using the scrollbar to review previous lines of text should 873using the scrollbar to review previous lines of text should
874cause the window to be repositioned automatically in the normal position at the 874cause the window to be repositioned automatically in the normal position at the
875bottom of the scroll region. 875bottom of the scroll region.
876.TP 8 876.TP 8
877.B +sk 877.B +sk
878This option indicates that pressing a key while using the scrollbar 878This option indicates that pressing a key while using the scrollbar
879should not cause the window to be repositioned. 879should not cause the window to be repositioned.
880.TP 8 880.TP 8
881.BI -sl " number" 881.BI \-sl " number"
882This option specifies the number of lines to save that have been scrolled 882This option specifies the number of lines to save that have been scrolled
883off the top of the screen. 883off the top of the screen.
884This corresponds to the \fBsaveLines\fP resource. 884This corresponds to the \fBsaveLines\fP resource.
885The default is 64. 885The default is 64.
886.TP 8 886.TP 8
887.B -sm 887.B \-sm
888This option, corresponding to the \fBsessionMgt\fR resource, 888This option, corresponding to the \fBsessionMgt\fR resource,
889indicates that \fIxterm\fR should 889indicates that \fIxterm\fR should
890set up session manager callbacks. 890set up session manager callbacks.
891.TP 8 891.TP 8
892.B +sm 892.B +sm
893This option indicates that \fIxterm\fR should 893This option indicates that \fIxterm\fR should
894not set up session manager callbacks. 894not set up session manager callbacks.
895.TP 8 895.TP 8
896.B -sp 896.B \-sp
897This option indicates that Sun/PC keyboard should be assumed, 897This option indicates that Sun/PC keyboard should be assumed,
898providing mapping for keypad \*(``+' to \*(``,', and 898providing mapping for keypad \*(``+' to \*(``,', and
899CTRL-F1 to F13, CTRL-F2 to F14, etc. 899CTRL-F1 to F13, CTRL-F2 to F14, etc.
900.TP 8 900.TP 8
901.B +sp 901.B +sp
902This option indicates that the standard escape codes should be generated for 902This option indicates that the standard escape codes should be generated for
903keypad and function keys. 903keypad and function keys.
904.TP 8 904.TP 8
905.B -t 905.B \-t
906This option indicates that \fIxterm\fP should start in Tektronix mode, rather 906This option indicates that \fIxterm\fP should start in Tektronix mode, rather
907than in VT102 mode. 907than in VT102 mode.
908Switching between the two windows is done using the 908Switching between the two windows is done using the
909\*(``Options\*('' menus. 909\*(``Options\*('' menus.
910.IR Termcap (5) 910.IR Termcap (5)
911entries that work with 911entries that work with
912.I xterm 912.I xterm
913\*(``tek4014,\*('' 913\*(``tek4014,\*(''
914\*(``tek4015,\*('' 914\*(``tek4015,\*(''
915\*(``tek4012,\*('' 915\*(``tek4012,\*(''
916\*(``tek4013,\*('' 916\*(``tek4013,\*(''
917\*(``tek4010,\*('' and 917\*(``tek4010,\*('' and
918\*(``dumb.\*('' 918\*(``dumb.\*(''
919.I xterm 919.I xterm
920automatically searches the termcap file in this order for these entries and then 920automatically searches the termcap file in this order for these entries and then
921sets the \*(``TERM\*('' and the \*(``TERMCAP\*('' environment variables. 921sets the \*(``TERM\*('' and the \*(``TERMCAP\*('' environment variables.
922.TP 8 922.TP 8
923.B +t 923.B +t
924This option indicates that \fIxterm\fP should start in VT102 mode. 924This option indicates that \fIxterm\fP should start in VT102 mode.
925.TP 8 925.TP 8
926.B -tb 926.B \-tb
927This option, corresponding to the \fBtoolBar\fR resource, 927This option, corresponding to the \fBtoolBar\fR resource,
928indicates that \fIxterm\fR should display a toolbar (or menubar) 928indicates that \fIxterm\fR should display a toolbar (or menubar)
929at the top of its window. 929at the top of its window.
930The buttons in the toolbar correspond to 930The buttons in the toolbar correspond to
931the popup menus, e.g., control/left/mouse for "Main Options". 931the popup menus, e.g., control/left/mouse for "Main Options".
932.TP 8 932.TP 8
933.B +tb 933.B +tb
934This option indicates that \fIxterm\fR should 934This option indicates that \fIxterm\fR should
935not set up a toolbar. 935not set up a toolbar.
936.TP 8 936.TP 8
937.BI -ti " term_id" 937.BI \-ti " term_id"
938Specify the name used by \fIxterm\fP to select the 938Specify the name used by \fIxterm\fP to select the
939correct response to terminal ID queries. 939correct response to terminal ID queries.
940It also specifies the emulation level, 940It also specifies the emulation level,
941used to determine the type of response to a DA control sequence. 941used to determine the type of response to a DA control sequence.
942Valid values include vt52, vt100, vt101, vt102, and vt220 (the "vt" is optional). 942Valid values include vt52, vt100, vt101, vt102, and vt220 (the "vt" is optional).
943The default is vt100. 943The default is vt100.
944The term_id argument specifies the terminal ID to use. 944The term_id argument specifies the terminal ID to use.
945(This is the same as the \fBdecTerminalID\fP resource). 945(This is the same as the \fBdecTerminalID\fP resource).
946.TP 8 946.TP 8
947.BI -tm " string" 947.BI \-tm " string"
948This option specifies a series of terminal setting keywords followed by the 948This option specifies a series of terminal setting keywords followed by the
949characters that should be bound to those functions, similar to the \fIstty\fP 949characters that should be bound to those functions, similar to the \fIstty\fP
950program. 950program.
951The keywords and their values are described in detail in the \fBttyModes\fP 951The keywords and their values are described in detail in the \fBttyModes\fP
952resource. 952resource.
953.TP 8 953.TP 8
954.BI -tn " name" 954.BI \-tn " name"
955This option specifies the name of the terminal type to be set in the TERM 955This option specifies the name of the terminal type to be set in the TERM
956environment variable. 956environment variable.
957It corresponds to the \fBtermName\fP resource. 957It corresponds to the \fBtermName\fP resource.
958This terminal type must exist in the terminal 958This terminal type must exist in the terminal
959database 959database
960(termcap or terminfo, depending on how \fIxterm\fP is built) 960(termcap or terminfo, depending on how \fIxterm\fP is built)
961and should have \fIli#\fP and \fIco#\fP entries. 961and should have \fIli#\fP and \fIco#\fP entries.
962If the terminal type is not found, \fIxterm\fP uses the built-in list 962If the terminal type is not found, \fIxterm\fP uses the built-in list
963\*(``xterm\*('', \*(``vt102\*('', etc. 963\*(``xterm\*('', \*(``vt102\*('', etc.
964.TP 8 964.TP 8
965.B -u8 965.B \-u8
966This option sets the \fButf8\fP resource. 966This option sets the \fButf8\fP resource.
967When \fButf8\fP is set, \fIxterm\fP interprets incoming data as UTF-8. 967When \fButf8\fP is set, \fIxterm\fP interprets incoming data as UTF-8.
968This sets the \fBwideChars\fP resource as a side-effect, 968This sets the \fBwideChars\fP resource as a side-effect,
969but the UTF-8 mode set by this option prevents it from being turned off. 969but the UTF-8 mode set by this option prevents it from being turned off.
970If you must turn it on and off, use the \fBwideChars\fP resource. 970If you must turn it on and off, use the \fBwideChars\fP resource.
971.IP 971.IP
972This option and the \fButf8\fR resource are overridden by 972This option and the \fButf8\fR resource are overridden by
973the \fB-lc\fP and \fB-en\fP options and \fBlocale\fR resource. 973the \fB\-lc\fP and \fB\-en\fP options and \fBlocale\fR resource.
974That is, if \fIxterm\fP has been compiled to support \fIluit\fR, 974That is, if \fIxterm\fP has been compiled to support \fIluit\fR,
975and the \fBlocale\fP resource is not \*(``false\*('' 975and the \fBlocale\fP resource is not \*(``false\*(''
976this option is ignored. 976this option is ignored.
977We recommend using 977We recommend using
978the \fB-lc\fR option or the \*(``\fBlocale:\ true\fR\*('' resource 978the \fB\-lc\fR option or the \*(``\fBlocale:\ true\fR\*('' resource
979in UTF-8 locales when your operating system supports locale, 979in UTF-8 locales when your operating system supports locale,
980or \fB-en\ UTF-8\fP option or the \*(``\fBlocale:\ UTF-8\fR\*('' resource 980or \fB\-en\ UTF-8\fP option or the \*(``\fBlocale:\ UTF-8\fR\*('' resource
981when your operating system does not support locale. 981when your operating system does not support locale.
982.TP 8 982.TP 8
983.B +u8 983.B +u8
984This option resets the \fButf8\fP resource. 984This option resets the \fButf8\fP resource.
985.TP 8 985.TP 8
986.B "-uc" 986.B "\-uc"
987This option makes the cursor underlined instead of a box. 987This option makes the cursor underlined instead of a box.
988.TP 8 988.TP 8
989.B "+uc" 989.B "+uc"
990This option makes the cursor a box instead of underlined. 990This option makes the cursor a box instead of underlined.
991.TP 8 991.TP 8
992.B "-ulc" 992.B "\-ulc"
993This option disables the display of characters with underline attribute as 993This option disables the display of characters with underline attribute as
994color rather than with underlining. 994color rather than with underlining.
995.TP 8 995.TP 8
996.B "+ulc" 996.B "+ulc"
997This option enables the display of characters with underline attribute as 997This option enables the display of characters with underline attribute as
998color rather than with underlining. 998color rather than with underlining.
999.TP 8 999.TP 8
1000.B "-ulit" 1000.B "\-ulit"
1001This option, corresponding to the \fBitalicULMode\fP resource, 1001This option, corresponding to the \fBitalicULMode\fP resource,
1002disables the display of characters with underline attribute as 1002disables the display of characters with underline attribute as
1003italics rather than with underlining. 1003italics rather than with underlining.
1004.TP 8 1004.TP 8
1005.B "+ulit" 1005.B "+ulit"
1006This option, corresponding to the \fBitalicULMode\fP resource, 1006This option, corresponding to the \fBitalicULMode\fP resource,
1007enables the display of characters with underline attribute as 1007enables the display of characters with underline attribute as
1008italics rather than with underlining. 1008italics rather than with underlining.
1009.TP 8 1009.TP 8
1010.B -ut 1010.B \-ut
1011This option indicates that \fIxterm\fP should not write a record into the 1011This option indicates that \fIxterm\fP should not write a record into the
1012the system \fIutmp\fP log file. 1012the system \fIutmp\fP log file.
1013.TP 8 1013.TP 8
1014.B +ut 1014.B +ut
1015This option indicates that \fIxterm\fP should write a record into 1015This option indicates that \fIxterm\fP should write a record into
1016the system \fIutmp\fP log file. 1016the system \fIutmp\fP log file.
1017.TP 8 1017.TP 8
1018.B -vb 1018.B \-vb
1019This option indicates that a visual bell is preferred over an audible one. 1019This option indicates that a visual bell is preferred over an audible one.
1020Instead of ringing the terminal bell whenever a Control-G is received, the 1020Instead of ringing the terminal bell whenever a Control-G is received, the
1021window will be flashed. 1021window will be flashed.
1022.TP 8 1022.TP 8
1023.B +vb 1023.B +vb
1024This option indicates that a visual bell should not be used. 1024This option indicates that a visual bell should not be used.
1025.TP 8 1025.TP 8
1026.B -wc 1026.B \-wc
1027This option sets the \fBwideChars\fP resource. 1027This option sets the \fBwideChars\fP resource.
1028When \fBwideChars\fP is set, \fIxterm\fP maintains internal structures for 16-bit 1028When \fBwideChars\fP is set, \fIxterm\fP maintains internal structures for 16-bit
1029characters. 1029characters.
1030If you do not set this resource to \*(``true\*('', 1030If you do not set this resource to \*(``true\*('',
1031\fIxterm\fP will ignore the escape sequence which turns UTF-8 mode on and off. 1031\fIxterm\fP will ignore the escape sequence which turns UTF-8 mode on and off.
1032The default is \*(``false\*(''. 1032The default is \*(``false\*(''.
1033.TP 8 1033.TP 8
1034.B +wc 1034.B +wc
1035This option resets the \fBwideChars\fP resource. 1035This option resets the \fBwideChars\fP resource.
1036.TP 8 1036.TP 8
1037.B -wf 1037.B \-wf
1038This option indicates that \fIxterm\fP should wait for the window to be mapped 1038This option indicates that \fIxterm\fP should wait for the window to be mapped
1039the first time before starting the subprocess so that the initial terminal 1039the first time before starting the subprocess so that the initial terminal
1040size settings and environment variables are correct. 1040size settings and environment variables are correct.
1041It is the application's 1041It is the application's
1042responsibility to catch subsequent terminal size changes. 1042responsibility to catch subsequent terminal size changes.
1043.TP 8 1043.TP 8
1044.B +wf 1044.B +wf
1045This option indicates that \fIxterm\fP should not wait before starting the 1045This option indicates that \fIxterm\fP should not wait before starting the
1046subprocess. 1046subprocess.
1047.TP 8 1047.TP 8
1048.B -ziconbeep \fIpercent\fP 1048.B \-ziconbeep \fIpercent\fP
1049Same as \fBzIconBeep\fP resource. 1049Same as \fBzIconBeep\fP resource.
1050If percent is non-zero, xterms that produce output while iconified 1050If percent is non-zero, xterms that produce output while iconified
1051will cause an XBell sound at the given volume 1051will cause an XBell sound at the given volume
1052and have "***" prepended to their icon titles. 1052and have "***" prepended to their icon titles.
1053Most window managers will detect this change immediately, showing you 1053Most window managers will detect this change immediately, showing you
1054which window has the output. 1054which window has the output.
1055(A similar feature was in x10 \fIxterm\fP.) 1055(A similar feature was in x10 \fIxterm\fP.)
1056.TP 8 1056.TP 8
1057.B -C 1057.B \-C
1058This option indicates that this window should receive console output. 1058This option indicates that this window should receive console output.
1059This 1059This
1060is not supported on all systems. 1060is not supported on all systems.
1061To obtain console output, you must be the 1061To obtain console output, you must be the
1062owner of the console device, and you must have read and write permission 1062owner of the console device, and you must have read and write permission
1063for it. 1063for it.
1064If you are running X under \fIxdm\fP on the console screen you may 1064If you are running X under \fIxdm\fP on the console screen you may
1065need to have the session startup and reset programs explicitly change the 1065need to have the session startup and reset programs explicitly change the
1066ownership of the console device in order to get this option to work. 1066ownership of the console device in order to get this option to work.
1067.TP 8 1067.TP 8
1068.B -S\fIccn\fP 1068.B \-S\fIccn\fP
1069This option allows \fIxterm\fP to be used as an input and 1069This option allows \fIxterm\fP to be used as an input and
1070output channel for an existing program and is sometimes used in specialized 1070output channel for an existing program and is sometimes used in specialized
1071applications. 1071applications.
1072The option value specifies the last few letters of the name of a pseudo-terminal 1072The option value specifies the last few letters of the name of a pseudo-terminal
1073to use in slave mode, plus the number of the inherited file descriptor. 1073to use in slave mode, plus the number of the inherited file descriptor.
1074If the option contains a \*(``/\*('' character, that delimits the characters 1074If the option contains a \*(``/\*('' character, that delimits the characters
1075used for the pseudo-terminal name from the file descriptor. 1075used for the pseudo-terminal name from the file descriptor.
1076Otherwise, exactly two characters are used from the option for 1076Otherwise, exactly two characters are used from the option for
1077the pseudo-terminal name, the remainder is the file descriptor. 1077the pseudo-terminal name, the remainder is the file descriptor.
1078Examples: 1078Examples:
1079.nf 1079.nf
1080.RS 15 1080.RS 15
1081-S123/45 1081-S123/45
1082-Sab34 1082-Sab34
1083.RE 1083.RE
1084.fi 1084.fi
1085.IP 1085.IP
1086Note that \fIxterm\fP does not close any file descriptor 1086Note that \fIxterm\fP does not close any file descriptor
1087which it did not open for its own use. 1087which it did not open for its own use.
1088It is possible (though probably not portable) to have an application 1088It is possible (though probably not portable) to have an application
1089which passes an open file descriptor down to \fIxterm\fP past the 1089which passes an open file descriptor down to \fIxterm\fP past the
1090initialization or the \fB-S\fP option to a process running in the \fIxterm\fP. 1090initialization or the \fB\-S\fP option to a process running in the \fIxterm\fP.
1091.PP 1091.PP
1092The following command line arguments are provided for compatibility with 1092The following command line arguments are provided for compatibility with
1093older versions. 1093older versions.
1094They may not be supported in the next release as the X 1094They may not be supported in the next release as the X
1095Toolkit provides standard options that accomplish the same task. 1095Toolkit provides standard options that accomplish the same task.
1096.TP 8 1096.TP 8
1097.B "%\fIgeom\fP" 1097.B "%\fIgeom\fP"
1098This option specifies the preferred size and position of the Tektronix window. 1098This option specifies the preferred size and position of the Tektronix window.
1099It is shorthand for specifying the \*(``\fI*tekGeometry\fP\*('' resource. 1099It is shorthand for specifying the \*(``\fI*tekGeometry\fP\*('' resource.
1100.TP 8 1100.TP 8
1101.B \ #\fIgeom\fP 1101.B \ #\fIgeom\fP
1102This option specifies the preferred position of the icon window. 1102This option specifies the preferred position of the icon window.
1103It is shorthand for specifying the \*(``\fI*iconGeometry\fP\*('' resource. 1103It is shorthand for specifying the \*(``\fI*iconGeometry\fP\*('' resource.
1104.TP 8 1104.TP 8
1105.BI -T " string" 1105.BI \-T " string"
1106This option specifies the title for \fIxterm\fP's windows. 1106This option specifies the title for \fIxterm\fP's windows.
1107It is equivalent to \fB-title\fP. 1107It is equivalent to \fB\-title\fP.
1108.TP 8 1108.TP 8
1109.BI -n " string" 1109.BI \-n " string"
1110This option specifies the icon name for \fIxterm\fP's windows. 1110This option specifies the icon name for \fIxterm\fP's windows.
1111It is shorthand for specifying the \*(``\fI*iconName\fP\*('' resource. 1111It is shorthand for specifying the \*(``\fI*iconName\fP\*('' resource.
1112Note that this is not the same as the toolkit option \fB-name\fP (see below). 1112Note that this is not the same as the toolkit option \fB\-name\fP (see below).
1113The default icon name is the application name. 1113The default icon name is the application name.
1114.TP 8 1114.TP 8
1115.B -r 1115.B \-r
1116This option indicates that reverse video should be simulated by swapping 1116This option indicates that reverse video should be simulated by swapping
1117the foreground and background colors. 1117the foreground and background colors.
1118It is equivalent to 1118It is equivalent to
1119\fB-rv\fP. 1119\fB\-rv\fP.
1120.TP 8 1120.TP 8
1121.BI -w " number" 1121.BI \-w " number"
1122This option specifies the width in pixels of the border surrounding the window. 1122This option specifies the width in pixels of the border surrounding the window.
1123It is equivalent to \fB-borderwidth\fP or \fB-bw\fP. 1123It is equivalent to \fB\-borderwidth\fP or \fB\-bw\fP.
1124. 1124.
1125.PP 1125.PP
1126The following standard X Toolkit command line arguments are commonly used 1126The following standard X Toolkit command line arguments are commonly used
1127with \fIxterm\fP: 1127with \fIxterm\fP:
1128.TP 8 1128.TP 8
1129.B -bd \fIcolor\fP 1129.B \-bd \fIcolor\fP
1130This option specifies the color to use for the border of the window. 1130This option specifies the color to use for the border of the window.
1131The corresponding resource name is \fIborderColor\fP. 1131The corresponding resource name is \fIborderColor\fP.
1132\fIxterm\fP uses the X Toolkit default, which is \*(``XtDefaultForeground\*(''. 1132\fIxterm\fP uses the X Toolkit default, which is \*(``XtDefaultForeground\*(''.
1133.TP 8 1133.TP 8
1134.B -bg \fIcolor\fP 1134.B \-bg \fIcolor\fP
1135This option specifies the color to use for the background of the window. 1135This option specifies the color to use for the background of the window.
1136The corresponding resource name is \fIbackground\fP. 1136The corresponding resource name is \fIbackground\fP.
1137The default is \*(``XtDefaultBackground.\*('' 1137The default is \*(``XtDefaultBackground.\*(''
1138.TP 8 1138.TP 8
1139.B -bw \fInumber\fP 1139.B \-bw \fInumber\fP
1140This option specifies the width in pixels of the border surrounding the window. 1140This option specifies the width in pixels of the border surrounding the window.
1141.IP 1141.IP
1142This appears to be a legacy of older X releases. 1142This appears to be a legacy of older X releases.
1143It sets the \fBborderWidth\fP resource of the shell widget, 1143It sets the \fBborderWidth\fP resource of the shell widget,
1144and may provide advice to your window manager to set the thickness of the 1144and may provide advice to your window manager to set the thickness of the
1145window frame. 1145window frame.
1146Most window managers do not use this information. 1146Most window managers do not use this information.
1147See the \fB-b\fP option, which controls the inner border of the \fIxterm\fP 1147See the \fB\-b\fP option, which controls the inner border of the \fIxterm\fP
1148window. 1148window.
1149.TP 8 1149.TP 8
1150.B -display \fIdisplay\fP 1150.B \-display \fIdisplay\fP
1151This option specifies the X server to contact; see \fIX(__miscmansuffix__)\fP. 1151This option specifies the X server to contact; see \fIX(__miscmansuffix__)\fP.
1152.TP 8 1152.TP 8
1153.B -fg \fIcolor\fP 1153.B \-fg \fIcolor\fP
1154This option specifies the color to use for displaying text. 1154This option specifies the color to use for displaying text.
1155The corresponding resource name is \fIforeground\fP. 1155The corresponding resource name is \fIforeground\fP.
1156The default is 1156The default is
1157\*(``XtDefaultForeground.\*('' 1157\*(``XtDefaultForeground.\*(''
1158.TP 8 1158.TP 8
1159.B -fn \fIfont\fP 1159.B \-fn \fIfont\fP
1160This option specifies the font to be used for displaying normal text. 1160This option specifies the font to be used for displaying normal text.
1161The corresponding resource name is \fIfont\fP. 1161The corresponding resource name is \fIfont\fP.
1162The resource value default is \fIfixed\fP. 1162The resource value default is \fIfixed\fP.
1163.TP 8 1163.TP 8
1164.B -font \fIfont\fP 1164.B \-font \fIfont\fP
1165This is the same as \fB-fn\fP. 1165This is the same as \fB\-fn\fP.
1166.TP 8 1166.TP 8
1167.B -geometry \fIgeometry\fP 1167.B \-geometry \fIgeometry\fP
1168This option specifies the preferred size and position of the VT102 window; 1168This option specifies the preferred size and position of the VT102 window;
1169see \fIX(__miscmansuffix__)\fP. 1169see \fIX(__miscmansuffix__)\fP.
1170.TP 8 1170.TP 8
1171.B -iconic 1171.B \-iconic
1172This option indicates that \fIxterm\fP should ask the window manager to 1172This option indicates that \fIxterm\fP should ask the window manager to
1173start it as an icon rather than as the normal window. 1173start it as an icon rather than as the normal window.
1174The corresponding resource name is \fIiconic\fP. 1174The corresponding resource name is \fIiconic\fP.
1175.TP 8 1175.TP 8
1176.B -name \fIname\fP 1176.B \-name \fIname\fP
1177This option specifies the application name under which resources are to be 1177This option specifies the application name under which resources are to be
1178obtained, rather than the default executable file name. 1178obtained, rather than the default executable file name.
1179\fIName\fP should not contain \*(``.\*('' or \*(``*\*('' characters. 1179\fIName\fP should not contain \*(``.\*('' or \*(``*\*('' characters.
1180.TP 8 1180.TP 8
1181.B -rv 1181.B \-rv
1182This option indicates that reverse video should be simulated by swapping 1182This option indicates that reverse video should be simulated by swapping
1183the foreground and background colors. 1183the foreground and background colors.
1184The corresponding resource name is \fIreverseVideo\fP. 1184The corresponding resource name is \fIreverseVideo\fP.
1185.TP 8 1185.TP 8
1186.B +rv 1186.B +rv
1187Disable the simulation of reverse video by swapping foreground and background 1187Disable the simulation of reverse video by swapping foreground and background
1188colors. 1188colors.
1189.TP 8 1189.TP 8
1190.B -title \fIstring\fP 1190.B \-title \fIstring\fP
1191This option specifies the window title string, which may be displayed by 1191This option specifies the window title string, which may be displayed by
1192window managers if the user so chooses. 1192window managers if the user so chooses.
1193The default title is the command 1193The default title is the command
1194line specified after the \fB-e\fP option, if any, otherwise the application 1194line specified after the \fB\-e\fP option, if any, otherwise the application
1195name. 1195name.
1196.TP 8 1196.TP 8
1197.B -xrm \fIresourcestring\fP 1197.B \-xrm \fIresourcestring\fP
1198This option specifies a resource string to be used. 1198This option specifies a resource string to be used.
1199This is especially 1199This is especially
1200useful for setting resources that do not have separate command line options. 1200useful for setting resources that do not have separate command line options.
1201. 1201.
1202. 1202.
1203.SH RESOURCES 1203.SH RESOURCES
1204The program understands all of the core X Toolkit resource names and classes. 1204The program understands all of the core X Toolkit resource names and classes.
1205Application specific resources (e.g., "\fBXTerm.\fP\fINAME\fP") follow: 1205Application specific resources (e.g., "\fBXTerm.\fP\fINAME\fP") follow:
1206.TP 8 1206.TP 8
1207.B "backarrowKeyIsErase (\fPclass\fB BackarrowKeyIsErase)" 1207.B "backarrowKeyIsErase (\fPclass\fB BackarrowKeyIsErase)"
1208Tie the VTxxx \fBbackarrowKey\fP and \fBptyInitialErase\fP resources 1208Tie the VTxxx \fBbackarrowKey\fP and \fBptyInitialErase\fP resources
1209together by setting the DECBKM state according to whether the initial value of 1209together by setting the DECBKM state according to whether the initial value of
1210stty erase is a backspace (8) or delete (127) character. 1210stty erase is a backspace (8) or delete (127) character.
@@ -1411,27 +1411,27 @@ flush, @@ -1411,27 +1411,27 @@ flush,
1411intr, 1411intr,
1412kill, 1412kill,
1413lnext, 1413lnext,
1414quit, 1414quit,
1415rprnt, 1415rprnt,
1416start, 1416start,
1417status, 1417status,
1418stop, 1418stop,
1419susp, 1419susp,
1420swtch and 1420swtch and
1421weras. 1421weras.
1422Control characters may be specified as ^char (e.g., ^c or ^u) 1422Control characters may be specified as ^char (e.g., ^c or ^u)
1423and \fB^?\fP may be used to indicate delete (127). 1423and \fB^?\fP may be used to indicate delete (127).
1424Use \fB^-\fP to denote \fIundef\fP. 1424Use \fB^\-\fP to denote \fIundef\fP.
1425Use \fB\\034\fP to represent \fB^\\\fP, since a literal backslash in 1425Use \fB\\034\fP to represent \fB^\\\fP, since a literal backslash in
1426an X resource escapes the next character. 1426an X resource escapes the next character.
1427.IP 1427.IP
1428This is very useful for overriding 1428This is very useful for overriding
1429the default terminal settings without having to do an \fIstty\fP every time 1429the default terminal settings without having to do an \fIstty\fP every time
1430an \fIxterm\fP is started. 1430an \fIxterm\fP is started.
1431Note, however, that the stty program on a given host may use different 1431Note, however, that the stty program on a given host may use different
1432keywords; \fIxterm\fR's table is built-in. 1432keywords; \fIxterm\fR's table is built-in.
1433.IP 1433.IP
1434If the \fBttyModes\fP resource specifies a value for \fBerase\fP, 1434If the \fBttyModes\fP resource specifies a value for \fBerase\fP,
1435that overrides the \fBptyInitialErase\fP resource setting, 1435that overrides the \fBptyInitialErase\fP resource setting,
1436i.e., \fIxterm\fP initializes the terminal to match that value. 1436i.e., \fIxterm\fP initializes the terminal to match that value.
1437.TP 8 1437.TP 8
@@ -1454,31 +1454,31 @@ the system \fIutmp\fP log file. @@ -1454,31 +1454,31 @@ the system \fIutmp\fP log file.
1454If true, \fIxterm\fP will not try. 1454If true, \fIxterm\fP will not try.
1455The default is \*(``false.\*('' 1455The default is \*(``false.\*(''
1456.TP 8 1456.TP 8
1457.B "waitForMap (\fPclass\fB WaitForMap)" 1457.B "waitForMap (\fPclass\fB WaitForMap)"
1458Specifies whether or not \fIxterm\fP should wait for the initial window map 1458Specifies whether or not \fIxterm\fP should wait for the initial window map
1459before starting the subprocess. 1459before starting the subprocess.
1460This is part of the 1460This is part of the
1461.B ptyHandshake 1461.B ptyHandshake
1462logic. 1462logic.
1463When \fIxterm\fP is directed to wait in this fashion, 1463When \fIxterm\fP is directed to wait in this fashion,
1464it passes the terminal size from the display end of the pseudo-terminal 1464it passes the terminal size from the display end of the pseudo-terminal
1465to the terminal I/O connection, e.g., according to the window manager. 1465to the terminal I/O connection, e.g., according to the window manager.
1466Otherwise, it uses the size as given in resource values or command-line 1466Otherwise, it uses the size as given in resource values or command-line
1467option \fB-geom\fP. 1467option \fB\-geom\fP.
1468The default is \*(``false.\*('' 1468The default is \*(``false.\*(''
1469.TP 8 1469.TP 8
1470.B "zIconBeep (\fPclass\fB ZIconBeep)" 1470.B "zIconBeep (\fPclass\fB ZIconBeep)"
1471Same as -ziconbeep command line argument. 1471Same as \-ziconbeep command line argument.
1472If the value of this resource is non-zero, xterms that produce output 1472If the value of this resource is non-zero, xterms that produce output
1473while iconified will cause an XBell sound at the given volume 1473while iconified will cause an XBell sound at the given volume
1474and have "***" prepended to their icon titles. 1474and have "***" prepended to their icon titles.
1475Most window managers will detect this change immediately, showing you 1475Most window managers will detect this change immediately, showing you
1476which window has the output. 1476which window has the output.
1477(A similar feature was in x10 \fIxterm\fR.) 1477(A similar feature was in x10 \fIxterm\fR.)
1478The default is \*(``false.\*('' 1478The default is \*(``false.\*(''
1479.\" 1479.\"
1480.SS VT100 Widget Resources 1480.SS VT100 Widget Resources
1481.PP 1481.PP
1482The following resources are specified as part 1482The following resources are specified as part
1483of the \fIvt100\fP widget (class \fIVT100\fP). 1483of the \fIvt100\fP widget (class \fIVT100\fP).
1484They are specified by patterns such as "\fBXTerm.vt100.\fP\fINAME\fP". 1484They are specified by patterns such as "\fBXTerm.vt100.\fP\fINAME\fP".
@@ -2016,27 +2016,27 @@ This can be set to values in the range 0 @@ -2016,27 +2016,27 @@ This can be set to values in the range 0
2016The default is \*(``2\*(''. 2016The default is \*(``2\*(''.
2017.TP 8 2017.TP 8
2018.B "ctrlFKeys (\fPclass\fB CtrlFKeys)" 2018.B "ctrlFKeys (\fPclass\fB CtrlFKeys)"
2019In VT220 keyboard mode (see \fBsunKeyboard\fP resource), 2019In VT220 keyboard mode (see \fBsunKeyboard\fP resource),
2020specifies the amount by which to shift F1-F12 given a control modifier (CTRL). 2020specifies the amount by which to shift F1-F12 given a control modifier (CTRL).
2021This allows you to generate key symbols for F10-F20 on a Sun/PC keyboard. 2021This allows you to generate key symbols for F10-F20 on a Sun/PC keyboard.
2022The default is \*(``10\*('', which means that CTRL F1 generates the key 2022The default is \*(``10\*('', which means that CTRL F1 generates the key
2023symbol for F11. 2023symbol for F11.
2024.TP 8 2024.TP 8
2025.B "curses (\fPclass\fB Curses)" 2025.B "curses (\fPclass\fB Curses)"
2026Specifies whether or not the last column bug in 2026Specifies whether or not the last column bug in
2027.IR more (1) 2027.IR more (1)
2028should be worked around. 2028should be worked around.
2029See the \fB-cu\fP option for details. 2029See the \fB\-cu\fP option for details.
2030The default is \*(``false.\*('' 2030The default is \*(``false.\*(''
2031.TP 8 2031.TP 8
2032.B "cursorBlink (\fPclass\fB CursorBlink)" 2032.B "cursorBlink (\fPclass\fB CursorBlink)"
2033Specifies whether to make the cursor blink. 2033Specifies whether to make the cursor blink.
2034The default is \*(``false.\*('' 2034The default is \*(``false.\*(''
2035.TP 8 2035.TP 8
2036.B "cursorColor (\fPclass\fB CursorColor)" 2036.B "cursorColor (\fPclass\fB CursorColor)"
2037Specifies the color to use for the text cursor. 2037Specifies the color to use for the text cursor.
2038The default is \*(``XtDefaultForeground.\*('' 2038The default is \*(``XtDefaultForeground.\*(''
2039By default, 2039By default,
2040\fIxterm\fP attempts to keep this color from being the same as the background 2040\fIxterm\fP attempts to keep this color from being the same as the background
2041color, since it draws the cursor by filling the background of a text cell. 2041color, since it draws the cursor by filling the background of a text cell.
2042The same restriction applies to control sequences which may change this color. 2042The same restriction applies to control sequences which may change this color.
@@ -2691,54 +2691,54 @@ where the encodings were not supported b @@ -2691,54 +2691,54 @@ where the encodings were not supported b
2691with changing fonts. 2691with changing fonts.
2692For other locales, \fIxterm\fR will use conventional 8bit mode. 2692For other locales, \fIxterm\fR will use conventional 8bit mode.
2693.TP 2693.TP
2694.I checkfont 2694.I checkfont
2695If mini-luit is compiled-in, \fIxterm\fR will check if a Unicode font has 2695If mini-luit is compiled-in, \fIxterm\fR will check if a Unicode font has
2696been specified. 2696been specified.
2697If so, it checks if the character encoding for the 2697If so, it checks if the character encoding for the
2698current locale is POSIX, Latin-1 or Latin-9, uses the appropriate 2698current locale is POSIX, Latin-1 or Latin-9, uses the appropriate
2699mapping to support those with the Unicode font. 2699mapping to support those with the Unicode font.
2700For other encodings, \fIxterm\fR assumes that UTF-8 encoding is required. 2700For other encodings, \fIxterm\fR assumes that UTF-8 encoding is required.
2701.TP 2701.TP
2702.I false 2702.I false
2703\fIxterm\fR will use conventional 8bit mode 2703\fIxterm\fR will use conventional 8bit mode
2704or UTF-8 mode according to \fButf8\fR resource or \fB-u8\fP option. 2704or UTF-8 mode according to \fButf8\fR resource or \fB\-u8\fP option.
2705.RE 2705.RE
2706.IP 2706.IP
2707Any other value, e.g., \*(``UTF-8\*('' or \*(``ISO8859-2\*('', 2707Any other value, e.g., \*(``UTF-8\*('' or \*(``ISO8859-2\*('',
2708is assumed to be an encoding name; 2708is assumed to be an encoding name;
2709\fIluit\fR will be invoked to support the encoding. 2709\fIluit\fR will be invoked to support the encoding.
2710The actual list of supported encodings depends on \fIluit\fR. 2710The actual list of supported encodings depends on \fIluit\fR.
2711The default is \*(``medium\*(''. 2711The default is \*(``medium\*(''.
2712.IP 2712.IP
2713Regardless of your locale and encoding, 2713Regardless of your locale and encoding,
2714you need an ISO-10646-1 font to display the result. 2714you need an ISO-10646-1 font to display the result.
2715Your configuration may not include this font, 2715Your configuration may not include this font,
2716or locale-support by \fIxterm\fP may not be needed. 2716or locale-support by \fIxterm\fP may not be needed.
2717At startup, \fIxterm\fP uses a mechanism equivalent to 2717At startup, \fIxterm\fP uses a mechanism equivalent to
2718the \fBload-vt-fonts(utf8Fonts,\ Utf8Fonts)\fP action 2718the \fBload-vt-fonts(utf8Fonts,\ Utf8Fonts)\fP action
2719to load font name subresources of the VT100 widget. 2719to load font name subresources of the VT100 widget.
2720That is, 2720That is,
2721resource patterns such as "\fB*vt100.utf8Fonts.font\fP" will be loaded, 2721resource patterns such as "\fB*vt100.utf8Fonts.font\fP" will be loaded,
2722and (if this resource is enabled), override the normal fonts. 2722and (if this resource is enabled), override the normal fonts.
2723If no subresources are found, 2723If no subresources are found,
2724the normal fonts such as "\fB*vt100.font\fP", etc., are used. 2724the normal fonts such as "\fB*vt100.font\fP", etc., are used.
2725The resource files distributed with \fIxterm\fP use ISO-10646-1 fonts, 2725The resource files distributed with \fIxterm\fP use ISO-10646-1 fonts,
2726but do not rely on them unless you are using the locale mechanism. 2726but do not rely on them unless you are using the locale mechanism.
2727.TP 8 2727.TP 8
2728.B "localeFilter (\fPclass\fB LocaleFilter)" 2728.B "localeFilter (\fPclass\fB LocaleFilter)"
2729Specifies the file name for the encoding converter from/to locale 2729Specifies the file name for the encoding converter from/to locale
2730encodings and UTF-8 which is used with the \fB-lc\fR option or \fBlocale\fR resource. 2730encodings and UTF-8 which is used with the \fB\-lc\fR option or \fBlocale\fR resource.
2731The help message shown by \*(``xterm -help\*('' lists the default value, 2731The help message shown by \*(``xterm \-help\*('' lists the default value,
2732which depends on your system configuration. 2732which depends on your system configuration.
2733.IP 2733.IP
2734If the encoding converter requires command-line parameters, 2734If the encoding converter requires command-line parameters,
2735you should put those within a shell script to execute the converter, 2735you should put those within a shell script to execute the converter,
2736and set this resource to point to the shell script. 2736and set this resource to point to the shell script.
2737.TP 8 2737.TP 8
2738.B "loginShell (\fPclass\fB LoginShell)" 2738.B "loginShell (\fPclass\fB LoginShell)"
2739Specifies whether or not the shell to be run in the window should be started 2739Specifies whether or not the shell to be run in the window should be started
2740as a login shell. 2740as a login shell.
2741The default is \*(``false.\*('' 2741The default is \*(``false.\*(''
2742.TP 8 2742.TP 8
2743.B "marginBell (\fPclass\fB MarginBell)" 2743.B "marginBell (\fPclass\fB MarginBell)"
2744Specifies whether or not the bell should be rung when the user types near the 2744Specifies whether or not the bell should be rung when the user types near the
@@ -2785,45 +2785,45 @@ l l l. @@ -2785,45 +2785,45 @@ l l l.
2785\fIcjkWidth\fR \fImkWidth\fR \fIAction\fP 2785\fIcjkWidth\fR \fImkWidth\fR \fIAction\fP
2786false false use system tables subject to \fBmkSamplePass\fP 2786false false use system tables subject to \fBmkSamplePass\fP
2787false true use built-in tables 2787false true use built-in tables
2788true false use built-in CJK tables 2788true false use built-in CJK tables
2789true true use built-in CJK tables 2789true true use built-in CJK tables
2790.TE 2790.TE
2791.TP 8 2791.TP 8
2792.B "modifyCursorKeys (\fPclass\fB ModifyCursorKeys\fP)" 2792.B "modifyCursorKeys (\fPclass\fB ModifyCursorKeys\fP)"
2793Tells how to handle the special case where 2793Tells how to handle the special case where
2794Control-, Shift-, Alt- or Meta-modifiers are used to add a parameter to 2794Control-, Shift-, Alt- or Meta-modifiers are used to add a parameter to
2795the escape sequence returned by a cursor-key. 2795the escape sequence returned by a cursor-key.
2796The default is \*(``2\*('': 2796The default is \*(``2\*('':
2797.IP 2797.IP
2798Set it to -1 to disable it. 2798Set it to \-1 to disable it.
2799.br 2799.br
2800Set it to 0 to use the old/obsolete behavior. 2800Set it to 0 to use the old/obsolete behavior.
2801.br 2801.br
2802Set it to 1 to prefix modified sequences with CSI. 2802Set it to 1 to prefix modified sequences with CSI.
2803.br 2803.br
2804Set it to 2 to force the modifier to be the second parameter if it would 2804Set it to 2 to force the modifier to be the second parameter if it would
2805otherwise be the first. 2805otherwise be the first.
2806.br 2806.br
2807Set it to 3 to mark the sequence with a \*(``>\*('' to hint that it is private. 2807Set it to 3 to mark the sequence with a \*(``>\*('' to hint that it is private.
2808.TP 8 2808.TP 8
2809.B "modifyFunctionKeys (\fPclass\fB ModifyFunctionKeys\fP)" 2809.B "modifyFunctionKeys (\fPclass\fB ModifyFunctionKeys\fP)"
2810Tells how to handle the special case where 2810Tells how to handle the special case where
2811Control-, Shift-, Alt- or Meta-modifiers are used to add a parameter to 2811Control-, Shift-, Alt- or Meta-modifiers are used to add a parameter to
2812the escape sequence returned by a (numbered) function-key. 2812the escape sequence returned by a (numbered) function-key.
2813The default is \*(``2\*(''. 2813The default is \*(``2\*(''.
2814The resource values are similar to \fBmodifyCursorKeys\fP: 2814The resource values are similar to \fBmodifyCursorKeys\fP:
2815.IP 2815.IP
2816Set it to -1 to permit the user to use shift- and control-modifiers 2816Set it to \-1 to permit the user to use shift- and control-modifiers
2817to construct function-key strings using the normal encoding scheme. 2817to construct function-key strings using the normal encoding scheme.
2818.br 2818.br
2819Set it to 0 to use the old/obsolete behavior. 2819Set it to 0 to use the old/obsolete behavior.
2820.br 2820.br
2821Set it to 1 to prefix modified sequences with CSI. 2821Set it to 1 to prefix modified sequences with CSI.
2822.br 2822.br
2823Set it to 2 to force the modifier to be the second parameter if it would 2823Set it to 2 to force the modifier to be the second parameter if it would
2824otherwise be the first. 2824otherwise be the first.
2825.br 2825.br
2826Set it to 3 to mark the sequence with a \*(``>\*('' to hint that it is private. 2826Set it to 3 to mark the sequence with a \*(``>\*('' to hint that it is private.
2827.IP 2827.IP
2828If \fBmodifyFunctionKeys\fP is zero, 2828If \fBmodifyFunctionKeys\fP is zero,
2829\fIxterm\fP uses Control- and Shift-modifiers to allow the user to 2829\fIxterm\fP uses Control- and Shift-modifiers to allow the user to
@@ -3180,26 +3180,32 @@ The default is \*(``true.\*('' @@ -3180,26 +3180,32 @@ The default is \*(``true.\*(''
3180.TP 8 3180.TP 8
3181.B "showBlinkAsBold (\fPclass\fB ShowBlinkAsBold)" 3181.B "showBlinkAsBold (\fPclass\fB ShowBlinkAsBold)"
3182Tells \fIxterm\fP whether to display text with blink-attribute the same 3182Tells \fIxterm\fP whether to display text with blink-attribute the same
3183as bold. 3183as bold.
3184If \fIxterm\fP has not been configured to support blinking text, 3184If \fIxterm\fP has not been configured to support blinking text,
3185the default is \*(``true.\*('', which corresponds to older versions of \fIxterm\fP, 3185the default is \*(``true.\*('', which corresponds to older versions of \fIxterm\fP,
3186otherwise the default is \*(``false.\*('' 3186otherwise the default is \*(``false.\*(''
3187.TP 8 3187.TP 8
3188.B "showMissingGlyphs (\fPclass\fB ShowMissingGlyphs)" 3188.B "showMissingGlyphs (\fPclass\fB ShowMissingGlyphs)"
3189Tells \fIxterm\fP whether to display a box outlining places where 3189Tells \fIxterm\fP whether to display a box outlining places where
3190a character has been used that the font does not represent. 3190a character has been used that the font does not represent.
3191The default is \*(``false.\*('' 3191The default is \*(``false.\*(''
3192.TP 8 3192.TP 8
 3193.B "showWrapMarks (\fPclass\fB ShowWrapMarks)"
 3194For debugging \fIxterm\fP and applications that may manipulate the
 3195wrapped-line flag by writing text at the right margin,
 3196show a mark on the right inner-border of the window.
 3197The mark shows which lines have the flag set.
 3198.TP 8
3193.B "signalInhibit (\fPclass\fB SignalInhibit)" 3199.B "signalInhibit (\fPclass\fB SignalInhibit)"
3194Specifies whether or not the entries in the \*(``Main Options\*('' menu for sending 3200Specifies whether or not the entries in the \*(``Main Options\*('' menu for sending
3195signals to \fIxterm\fP should be disallowed. 3201signals to \fIxterm\fP should be disallowed.
3196The default is \*(``false.\*('' 3202The default is \*(``false.\*(''
3197.TP 8 3203.TP 8
3198.B "tekGeometry (\fPclass\fB Geometry)" 3204.B "tekGeometry (\fPclass\fB Geometry)"
3199Specifies the preferred size and position of the Tektronix window. 3205Specifies the preferred size and position of the Tektronix window.
3200There is no default for this resource. 3206There is no default for this resource.
3201.TP 8 3207.TP 8
3202.B "tekInhibit (\fPclass\fB TekInhibit)" 3208.B "tekInhibit (\fPclass\fB TekInhibit)"
3203Specifies whether or not 3209Specifies whether or not
3204the escape sequence to enter 3210the escape sequence to enter
3205Tektronix mode should be ignored. 3211Tektronix mode should be ignored.
@@ -3303,49 +3309,49 @@ If you set this resource, \fIxterm\fP al @@ -3303,49 +3309,49 @@ If you set this resource, \fIxterm\fP al
3303The resource is an integer, expected to range from 0 to 3: 3309The resource is an integer, expected to range from 0 to 3:
3304.RS 3310.RS
3305.TP 3 3311.TP 3
33060 33120
3307UTF-8 mode is initially off. 3313UTF-8 mode is initially off.
3308The command-line option \fB+u8\fP sets the resource to this value. 3314The command-line option \fB+u8\fP sets the resource to this value.
3309Escape sequences for turning UTF-8 mode on/off are allowed. 3315Escape sequences for turning UTF-8 mode on/off are allowed.
3310.TP 3316.TP
33111 33171
3312UTF-8 mode is initially on. 3318UTF-8 mode is initially on.
3313Escape sequences for turning UTF-8 mode on/off are allowed. 3319Escape sequences for turning UTF-8 mode on/off are allowed.
3314.TP 3320.TP
33152 33212
3316The command-line option \fB-u8\fP sets the resource to this value. 3322The command-line option \fB\-u8\fP sets the resource to this value.
3317Escape sequences for turning UTF-8 mode on/off are ignored. 3323Escape sequences for turning UTF-8 mode on/off are ignored.
3318.TP 3324.TP
33193 33253
3320This is the default value of the resource. 3326This is the default value of the resource.
3321It is changed during initialization depending on 3327It is changed during initialization depending on
3322whether the \fBlocale\fP resource was set, to 0 or 2. 3328whether the \fBlocale\fP resource was set, to 0 or 2.
3323See the \fBlocale\fR resource for additional discussion of non-UTF-8 locales. 3329See the \fBlocale\fR resource for additional discussion of non-UTF-8 locales.
3324.RE 3330.RE
3325.IP 3331.IP
3326If you want to set the value of \fButf8\fP, it should be in this range. 3332If you want to set the value of \fButf8\fP, it should be in this range.
3327Other nonzero values are treated the same as \*(``1\*('', 3333Other nonzero values are treated the same as \*(``1\*('',
3328i.e., UTF-8 mode is initially on, and 3334i.e., UTF-8 mode is initially on, and
3329escape sequences for turning UTF-8 mode on/off are allowed. 3335escape sequences for turning UTF-8 mode on/off are allowed.
3330.TP 8 3336.TP 8
3331.B "utf8Fonts (\fPclass\fB Utf8Fonts)" 3337.B "utf8Fonts (\fPclass\fB Utf8Fonts)"
3332See the discussion of the \fBlocale\fP resource. 3338See the discussion of the \fBlocale\fP resource.
3333.TP 8 3339.TP 8
3334.B "utf8Latin1 (\fPclass\fB Utf8Latin1)" 3340.B "utf8Latin1 (\fPclass\fB Utf8Latin1)"
3335If true, 3341If true,
3336allow an ISO-8859-1 \fInormal\fP 3342allow an ISO-8859-1 \fInormal\fP
3337font to be combined with an ISO-10646 font if the latter is given 3343font to be combined with an ISO-10646 font if the latter is given
3338via the \fB-fw\fP option or its corresponding resource value. 3344via the \fB\-fw\fP option or its corresponding resource value.
3339The default is \*(``false.\*('' 3345The default is \*(``false.\*(''
3340.TP 8 3346.TP 8
3341.B "utf8SelectTypes (\fPclass\fB Utf8SelectTypes)" 3347.B "utf8SelectTypes (\fPclass\fB Utf8SelectTypes)"
3342Override \fIxterm\fP's default selection target list (see SELECT/PASTE) for 3348Override \fIxterm\fP's default selection target list (see SELECT/PASTE) for
3343selections in wide-character (UTF-8) mode. 3349selections in wide-character (UTF-8) mode.
3344The default is an empty string, which does not override anything. 3350The default is an empty string, which does not override anything.
3345.TP 8 3351.TP 8
3346.B "utf8Title (\fPclass\fB Utf8Title)" 3352.B "utf8Title (\fPclass\fB Utf8Title)"
3347Applications can set \fIxterm\fP's title by writing a control sequence. 3353Applications can set \fIxterm\fP's title by writing a control sequence.
3348Normally this control sequence follows the VT220 convention, 3354Normally this control sequence follows the VT220 convention,
3349which encodes the string in ISO-8859-1 and 3355which encodes the string in ISO-8859-1 and
3350allows for an 8-bit string terminator. 3356allows for an 8-bit string terminator.
3351If \fIxterm\fP is started in a UTF-8 locale, 3357If \fIxterm\fP is started in a UTF-8 locale,
@@ -3985,27 +3991,27 @@ Specifies whether or not synthetic key a @@ -3985,27 +3991,27 @@ Specifies whether or not synthetic key a
3985the X protocol SendEvent request should be interpreted or discarded. 3991the X protocol SendEvent request should be interpreted or discarded.
3986This corresponds to the \fBallowSendEvents\fP resource. 3992This corresponds to the \fBallowSendEvents\fP resource.
3987.TP 3993.TP
3988Redraw Window (redraw) 3994Redraw Window (redraw)
3989Forces the X display to repaint; 3995Forces the X display to repaint;
3990useful in some environments. 3996useful in some environments.
3991.RE 3997.RE
3992.TP 3998.TP
3993Commands for capturing output: 3999Commands for capturing output:
3994.RS 4000.RS
3995.TP 4001.TP
3996Log to File (logging) 4002Log to File (logging)
3997Captures text sent to the screen in a logfile, 4003Captures text sent to the screen in a logfile,
3998as in the \fB-l\fP logging option. 4004as in the \fB\-l\fP logging option.
3999.TP 4005.TP
4000Print Window (print) 4006Print Window (print)
4001Sends the text of the current window to the program given in the 4007Sends the text of the current window to the program given in the
4002\fBprinterCommand\fP resource. 4008\fBprinterCommand\fP resource.
4003.TP 4009.TP
4004Redirect to Printer (print-redir) 4010Redirect to Printer (print-redir)
4005This sets the \fBprinterControlMode\fR to 0 or 2. 4011This sets the \fBprinterControlMode\fR to 0 or 2.
4006You can use this to turn the printer on as if an application had sent 4012You can use this to turn the printer on as if an application had sent
4007the appropriate control sequence. 4013the appropriate control sequence.
4008It is also useful for switching the printer 4014It is also useful for switching the printer
4009off if an application turns it on without resetting the print control mode. 4015off if an application turns it on without resetting the print control mode.
4010.RE 4016.RE
4011.TP 4017.TP
@@ -4095,63 +4101,63 @@ the process group of the process running @@ -4095,63 +4101,63 @@ the process group of the process running
4095.PP 4101.PP
4096The 4102The
4097.I vtMenu 4103.I vtMenu
4098sets various modes in the VT102 emulation, and is popped up when the 4104sets various modes in the VT102 emulation, and is popped up when the
4099\*(``control\*('' key and pointer button two are pressed in the VT102 window. 4105\*(``control\*('' key and pointer button two are pressed in the VT102 window.
4100.TP 4106.TP
4101VT102/VT220 Modes: 4107VT102/VT220 Modes:
4102.RS 4108.RS
4103. 4109.
4104.TP 4110.TP
4105Enable Scrollbar (scrollbar) 4111Enable Scrollbar (scrollbar)
4106Enable (or disable) the scrollbar. 4112Enable (or disable) the scrollbar.
4107This corresponds to the 4113This corresponds to the
4108.B -sb 4114.B \-sb
4109option and the 4115option and the
4110.B scrollBar 4116.B scrollBar
4111resource. 4117resource.
4112. 4118.
4113.TP 4119.TP
4114Enable Jump Scroll (jumpscroll) 4120Enable Jump Scroll (jumpscroll)
4115Enable (or disable) jump scrolling. 4121Enable (or disable) jump scrolling.
4116This corresponds to the 4122This corresponds to the
4117.B -j 4123.B \-j
4118option and the 4124option and the
4119.B jumpScroll 4125.B jumpScroll
4120resource. 4126resource.
4121. 4127.
4122.TP 4128.TP
4123Enable Reverse Video (reversevideo) 4129Enable Reverse Video (reversevideo)
4124Enable (or disable) reverse-video. 4130Enable (or disable) reverse-video.
4125This corresponds to the 4131This corresponds to the
4126.B -rv 4132.B \-rv
4127option and the 4133option and the
4128.B reverseVideo 4134.B reverseVideo
4129resource. 4135resource.
4130. 4136.
4131.TP 4137.TP
4132Enable Auto Wraparound (autowrap) 4138Enable Auto Wraparound (autowrap)
4133Enable (or disable) auto-wraparound. 4139Enable (or disable) auto-wraparound.
4134This corresponds to the 4140This corresponds to the
4135.B -aw 4141.B \-aw
4136option and the 4142option and the
4137.B autoWrap 4143.B autoWrap
4138resource. 4144resource.
4139. 4145.
4140.TP 4146.TP
4141Enable Reverse Wraparound (reversewrap) 4147Enable Reverse Wraparound (reversewrap)
4142Enable (or disable) reverse wraparound. 4148Enable (or disable) reverse wraparound.
4143This corresponds to the 4149This corresponds to the
4144.B -rw 4150.B \-rw
4145option and the 4151option and the
4146.B reverseWrap 4152.B reverseWrap
4147resource. 4153resource.
4148. 4154.
4149.TP 4155.TP
4150Enable Auto Linefeed (autolinefeed) 4156Enable Auto Linefeed (autolinefeed)
4151Enable (or disable) auto-linefeed. 4157Enable (or disable) auto-linefeed.
4152This is the VT102 NEL function, 4158This is the VT102 NEL function,
4153which causes the emulator to emit a linefeed after each carriage return. 4159which causes the emulator to emit a linefeed after each carriage return.
4154There is no corresponding command-line option or resource setting. 4160There is no corresponding command-line option or resource setting.
4155. 4161.
4156.TP 4162.TP
4157Enable Application Cursor Keys (appcursor) 4163Enable Application Cursor Keys (appcursor)
@@ -4163,47 +4169,47 @@ There is no corresponding command-line o @@ -4163,47 +4169,47 @@ There is no corresponding command-line o
4163. 4169.
4164.TP 4170.TP
4165Enable Application Keypad (appkeypad) 4171Enable Application Keypad (appkeypad)
4166Enable (or disable) application keypad keys. 4172Enable (or disable) application keypad keys.
4167This corresponds to the 4173This corresponds to the
4168.B appkeypadDefault 4174.B appkeypadDefault
4169resource. 4175resource.
4170There is no corresponding command-line option. 4176There is no corresponding command-line option.
4171. 4177.
4172.TP 4178.TP
4173Scroll to Bottom on Key Press (scrollkey) 4179Scroll to Bottom on Key Press (scrollkey)
4174Enable (or disable) scrolling to the bottom of the scrolling region on a keypress. 4180Enable (or disable) scrolling to the bottom of the scrolling region on a keypress.
4175This corresponds to the 4181This corresponds to the
4176.B -sk 4182.B \-sk
4177option and the 4183option and the
4178.B scrollKey 4184.B scrollKey
4179resource. 4185resource.
4180.IP 4186.IP
4181As a special case, the XON / XOFF keys (control/S and control/Q) are ignored. 4187As a special case, the XON / XOFF keys (control/S and control/Q) are ignored.
4182. 4188.
4183.TP 4189.TP
4184Scroll to Bottom on Tty Output (scrollttyoutput) 4190Scroll to Bottom on Tty Output (scrollttyoutput)
4185Enable (or disable) scrolling to the bottom of the scrolling region on output to the terminal. 4191Enable (or disable) scrolling to the bottom of the scrolling region on output to the terminal.
4186This corresponds to the 4192This corresponds to the
4187.B -si 4193.B \-si
4188option and the 4194option and the
4189.B scrollTtyOutput 4195.B scrollTtyOutput
4190resource. 4196resource.
4191. 4197.
4192.TP 4198.TP
4193Allow 80/132 Column Switching (allow132) 4199Allow 80/132 Column Switching (allow132)
4194Enable (or disable) switching between 80 and 132 columns. 4200Enable (or disable) switching between 80 and 132 columns.
4195This corresponds to the 4201This corresponds to the
4196.B -132 4202.B \-132
4197option and the 4203option and the
4198.B c132 4204.B c132
4199resource. 4205resource.
4200. 4206.
4201.TP 4207.TP
4202Keep Selection (keepSelection) 4208Keep Selection (keepSelection)
4203Tell \fIxterm\fP whether to disown the selection when it stops highlighting it, 4209Tell \fIxterm\fP whether to disown the selection when it stops highlighting it,
4204e.g., when an application modifies the display so that it no longer matches 4210e.g., when an application modifies the display so that it no longer matches
4205the text which has been highlighted. 4211the text which has been highlighted.
4206As long as \fIxterm\fP continues to own the selection, 4212As long as \fIxterm\fP continues to own the selection,
4207it can provide the corresponding text to other clients via cut/paste. 4213it can provide the corresponding text to other clients via cut/paste.
4208This corresponds to the 4214This corresponds to the
4209.B keepSelection 4215.B keepSelection
@@ -4214,74 +4220,74 @@ There is no corresponding command-line o @@ -4214,74 +4220,74 @@ There is no corresponding command-line o
4214Select to Clipboard (selectToClipboard) 4220Select to Clipboard (selectToClipboard)
4215Tell \fIxterm\fP whether to use the PRIMARY or CLIPBOARD 4221Tell \fIxterm\fP whether to use the PRIMARY or CLIPBOARD
4216for SELECT tokens in the \fBtranslations\fP resource which 4222for SELECT tokens in the \fBtranslations\fP resource which
4217maps keyboard and mouse actions to select/paste actions. 4223maps keyboard and mouse actions to select/paste actions.
4218This corresponds to the 4224This corresponds to the
4219.B selectToClipboard 4225.B selectToClipboard
4220resource. 4226resource.
4221There is no corresponding command-line option. 4227There is no corresponding command-line option.
4222. 4228.
4223.TP 4229.TP
4224Enable Visual Bell (visualbell) 4230Enable Visual Bell (visualbell)
4225Enable (or disable) visible bell (i.e., flashing) instead of an audible bell. 4231Enable (or disable) visible bell (i.e., flashing) instead of an audible bell.
4226This corresponds to the 4232This corresponds to the
4227.B -vb 4233.B \-vb
4228option and the 4234option and the
4229.B visualBell 4235.B visualBell
4230resource. 4236resource.
4231. 4237.
4232.TP 4238.TP
4233Enable Bell Urgency (bellIsUrgent) 4239Enable Bell Urgency (bellIsUrgent)
4234Enable (or disable) Urgency window manager hint when Control-G is received. 4240Enable (or disable) Urgency window manager hint when Control-G is received.
4235This corresponds to the 4241This corresponds to the
4236.B bellIsUrgent 4242.B bellIsUrgent
4237resource. 4243resource.
4238. 4244.
4239.TP 4245.TP
4240Enable Pop on Bell (poponbell) 4246Enable Pop on Bell (poponbell)
4241Enable (or disable) raising of the window when Control-G is received. 4247Enable (or disable) raising of the window when Control-G is received.
4242This corresponds to the 4248This corresponds to the
4243.B -pop 4249.B \-pop
4244option and the 4250option and the
4245.B popOnBell 4251.B popOnBell
4246resource. 4252resource.
4247. 4253.
4248.TP 4254.TP
4249Enable Blinking Cursor (cursorblink) 4255Enable Blinking Cursor (cursorblink)
4250Enable (or disable) the blinking-cursor feature. 4256Enable (or disable) the blinking-cursor feature.
4251This corresponds to the 4257This corresponds to the
4252.B -bc 4258.B \-bc
4253option and the 4259option and the
4254.B cursorBlink 4260.B cursorBlink
4255resource. 4261resource.
4256There is also an escape sequence 4262There is also an escape sequence
4257(see the document \fIXterm Control Sequences\fP). 4263(see the document \fIXterm Control Sequences\fP).
4258The menu entry and the escape sequence states are XOR'd: 4264The menu entry and the escape sequence states are XOR'd:
4259if both are enabled, the cursor will not blink, 4265if both are enabled, the cursor will not blink,
4260if only one is enabled, the cursor will blink. 4266if only one is enabled, the cursor will blink.
4261. 4267.
4262.TP 4268.TP
4263Enable Alternate Screen Switching (titeInhibit) 4269Enable Alternate Screen Switching (titeInhibit)
4264Enable (or disable) switching between the normal and alternate screens. 4270Enable (or disable) switching between the normal and alternate screens.
4265This corresponds to the 4271This corresponds to the
4266.B titeInhibit 4272.B titeInhibit
4267resource. 4273resource.
4268There is no corresponding command-line option. 4274There is no corresponding command-line option.
4269. 4275.
4270.TP 4276.TP
4271Enable Active Icon (activeicon) 4277Enable Active Icon (activeicon)
4272Enable (or disable) the active-icon feature. 4278Enable (or disable) the active-icon feature.
4273This corresponds to the 4279This corresponds to the
4274.B -ai 4280.B \-ai
4275option and the 4281option and the
4276.B activeIcon 4282.B activeIcon
4277resource. 4283resource.
4278.RE 4284.RE
4279. 4285.
4280.TP 4286.TP
4281VT102/VT220 Commands: 4287VT102/VT220 Commands:
4282.RS 4288.RS
4283.TP 4289.TP
4284Do Soft Reset (softreset) 4290Do Soft Reset (softreset)
4285Reset scroll regions. 4291Reset scroll regions.
4286This can be convenient when some program has left the scroll regions 4292This can be convenient when some program has left the scroll regions
4287set incorrectly (often a problem when using VMS or TOPS-20). 4293set incorrectly (often a problem when using VMS or TOPS-20).
@@ -4591,41 +4597,41 @@ of the \fBcharClass\fP (class \fICharCla @@ -4591,41 +4597,41 @@ of the \fBcharClass\fP (class \fICharCla
4591This resource is a 4597This resource is a
4592series of comma-separated 4598series of comma-separated
4593of \fIrange\fP:\fIvalue\fP pairs. 4599of \fIrange\fP:\fIvalue\fP pairs.
4594The 4600The
4595\fIrange\fP is either a single number or \fIlow\fP-\fIhigh\fP in the range of 0 4601\fIrange\fP is either a single number or \fIlow\fP-\fIhigh\fP in the range of 0
4596to 65535, corresponding to the code for the character or characters to be 4602to 65535, corresponding to the code for the character or characters to be
4597set. 4603set.
4598The \fIvalue\fP is arbitrary, although the default table uses the 4604The \fIvalue\fP is arbitrary, although the default table uses the
4599character number of the first character occurring in the set. 4605character number of the first character occurring in the set.
4600When not in 4606When not in
4601UTF-8 mode, only the first 256 bytes of this table will be used. 4607UTF-8 mode, only the first 256 bytes of this table will be used.
4602. 4608.
4603.PP 4609.PP
4604The default table starts as follows - 4610The default table starts as follows \-
4605.NS 4611.NS
4606static int charClass[256] = { 4612static int charClass[256] = {
4607/\(** NUL SOH STX ETX EOT ENQ ACK BEL */ 4613/\(** NUL SOH STX ETX EOT ENQ ACK BEL */
4608 32, 1, 1, 1, 1, 1, 1, 1, 4614 32, 1, 1, 1, 1, 1, 1, 1,
4609/\(** BS HT NL VT NP CR SO SI */ 4615/\(** BS HT NL VT NP CR SO SI */
4610 1, 32, 1, 1, 1, 1, 1, 1, 4616 1, 32, 1, 1, 1, 1, 1, 1,
4611/\(** DLE DC1 DC2 DC3 DC4 NAK SYN ETB */ 4617/\(** DLE DC1 DC2 DC3 DC4 NAK SYN ETB */
4612 1, 1, 1, 1, 1, 1, 1, 1, 4618 1, 1, 1, 1, 1, 1, 1, 1,
4613/\(** CAN EM SUB ESC FS GS RS US */ 4619/\(** CAN EM SUB ESC FS GS RS US */
4614 1, 1, 1, 1, 1, 1, 1, 1, 4620 1, 1, 1, 1, 1, 1, 1, 1,
4615/\(** SP ! " # $ % & \*(AQ */ 4621/\(** SP ! " # $ % & \*(AQ */
4616.\" " <- for emacs autocolor to work well :-) 4622.\" " <- for emacs autocolor to work well :-)
4617 32, 33, 34, 35, 36, 37, 38, 39, 4623 32, 33, 34, 35, 36, 37, 38, 39,
4618/\(** ( ) * + , - . / */ 4624/\(** ( ) * + , \- . / */
4619 40, 41, 42, 43, 44, 45, 46, 47, 4625 40, 41, 42, 43, 44, 45, 46, 47,
4620/\(** 0 1 2 3 4 5 6 7 */ 4626/\(** 0 1 2 3 4 5 6 7 */
4621 48, 48, 48, 48, 48, 48, 48, 48, 4627 48, 48, 48, 48, 48, 48, 48, 48,
4622/\(** 8 9 : ; < = > ? */ 4628/\(** 8 9 : ; < = > ? */
4623 48, 48, 58, 59, 60, 61, 62, 63, 4629 48, 48, 58, 59, 60, 61, 62, 63,
4624/\(** @ A B C D E F G */ 4630/\(** @ A B C D E F G */
4625 64, 48, 48, 48, 48, 48, 48, 48, 4631 64, 48, 48, 48, 48, 48, 48, 48,
4626/\(** H I J K L M N O */ 4632/\(** H I J K L M N O */
4627 48, 48, 48, 48, 48, 48, 48, 48, 4633 48, 48, 48, 48, 48, 48, 48, 48,
4628/\(** P Q R S T U V W */ 4634/\(** P Q R S T U V W */
4629 48, 48, 48, 48, 48, 48, 48, 48, 4635 48, 48, 48, 48, 48, 48, 48, 48,
4630/\(** X Y Z [ \\ ] ^ _ */ 4636/\(** X Y Z [ \\ ] ^ _ */
4631 48, 48, 48, 91, 92, 93, 94, 48, 4637 48, 48, 48, 91, 92, 93, 94, 48,
@@ -4635,52 +4641,52 @@ static int charClass[256] = { @@ -4635,52 +4641,52 @@ static int charClass[256] = {
4635 48, 48, 48, 48, 48, 48, 48, 48, 4641 48, 48, 48, 48, 48, 48, 48, 48,
4636/\(** p q r s t u v w */ 4642/\(** p q r s t u v w */
4637 48, 48, 48, 48, 48, 48, 48, 48, 4643 48, 48, 48, 48, 48, 48, 48, 48,
4638/\(** x y z { | } ~ DEL */ 4644/\(** x y z { | } ~ DEL */
4639 48, 48, 48, 123, 124, 125, 126, 1, 4645 48, 48, 48, 123, 124, 125, 126, 1,
4640/\(** x80 x81 x82 x83 IND NEL SSA ESA */ 4646/\(** x80 x81 x82 x83 IND NEL SSA ESA */
4641 1, 1, 1, 1, 1, 1, 1, 1, 4647 1, 1, 1, 1, 1, 1, 1, 1,
4642/\(** HTS HTJ VTS PLD PLU RI SS2 SS3 */ 4648/\(** HTS HTJ VTS PLD PLU RI SS2 SS3 */
4643 1, 1, 1, 1, 1, 1, 1, 1, 4649 1, 1, 1, 1, 1, 1, 1, 1,
4644/\(** DCS PU1 PU2 STS CCH MW SPA EPA */ 4650/\(** DCS PU1 PU2 STS CCH MW SPA EPA */
4645 1, 1, 1, 1, 1, 1, 1, 1, 4651 1, 1, 1, 1, 1, 1, 1, 1,
4646/\(** x98 x99 x9A CSI ST OSC PM APC */ 4652/\(** x98 x99 x9A CSI ST OSC PM APC */
4647 1, 1, 1, 1, 1, 1, 1, 1, 4653 1, 1, 1, 1, 1, 1, 1, 1,
4648/\(** - i c/ L ox Y- | So */ 4654/\(** \- i c/ L ox Y\- | So */
4649 160, 161, 162, 163, 164, 165, 166, 167, 4655 160, 161, 162, 163, 164, 165, 166, 167,
4650/\(** .. c0 ip << _ R0 - */ 4656/\(** .. c0 ip << _ R0 \- */
4651 168, 169, 170, 171, 172, 173, 174, 175, 4657 168, 169, 170, 171, 172, 173, 174, 175,
4652/\(** o +- 2 3 \*(AQ u q| . */ 4658/\(** o +\- 2 3 \*(AQ u q| . */
4653 176, 177, 178, 179, 180, 181, 182, 183, 4659 176, 177, 178, 179, 180, 181, 182, 183,
4654/\(** , 1 2 >> 1/4 1/2 3/4 ? */ 4660/\(** , 1 2 >> 1/4 1/2 3/4 ? */
4655 184, 185, 186, 187, 188, 189, 190, 191, 4661 184, 185, 186, 187, 188, 189, 190, 191,
4656/\(** A` A\*(AQ A^ A~ A: Ao AE C, */ 4662/\(** A` A\*(AQ A^ A~ A: Ao AE C, */
4657 48, 48, 48, 48, 48, 48, 48, 48, 4663 48, 48, 48, 48, 48, 48, 48, 48,
4658/\(** E` E\*(AQ E^ E: I` I\*(AQ I^ I: */ 4664/\(** E` E\*(AQ E^ E: I` I\*(AQ I^ I: */
4659 48, 48, 48, 48, 48, 48, 48, 48, 4665 48, 48, 48, 48, 48, 48, 48, 48,
4660/\(** D- N~ O` O\*(AQ O^ O~ O: X */ 4666/\(** D\- N~ O` O\*(AQ O^ O~ O: X */
4661 48, 48, 48, 48, 48, 48, 48, 215, 4667 48, 48, 48, 48, 48, 48, 48, 215,
4662/\(** O/ U` U\*(AQ U^ U: Y\*(AQ P B */ 4668/\(** O/ U` U\*(AQ U^ U: Y\*(AQ P B */
4663 48, 48, 48, 48, 48, 48, 48, 48, 4669 48, 48, 48, 48, 48, 48, 48, 48,
4664/\(** a` a\*(AQ a^ a~ a: ao ae c, */ 4670/\(** a` a\*(AQ a^ a~ a: ao ae c, */
4665 48, 48, 48, 48, 48, 48, 48, 48, 4671 48, 48, 48, 48, 48, 48, 48, 48,
4666/\(** e` e\*(AQ e^ e: i` i\*(AQ i^ i: */ 4672/\(** e` e\*(AQ e^ e: i` i\*(AQ i^ i: */
4667 48, 48, 48, 48, 48, 48, 48, 48, 4673 48, 48, 48, 48, 48, 48, 48, 48,
4668/\(** d n~ o` o\*(AQ o^ o~ o: -: */ 4674/\(** d n~ o` o\*(AQ o^ o~ o: \-: */
4669 48, 48, 48, 48, 48, 48, 48, 247, 4675 48, 48, 48, 48, 48, 48, 48, 247,
4670/\(** o/ u` u\*(AQ u^ u: y\*(AQ P y: */ 4676/\(** o/ u` u\*(AQ u^ u: y\*(AQ P y: */
4671 48, 48, 48, 48, 48, 48, 48, 48}; 4677 48, 48, 48, 48, 48, 48, 48, 48};
4672.NE 4678.NE
4673For example, the string \*(``33:48,37:48,45-47:48,38:48\*('' indicates that the 4679For example, the string \*(``33:48,37:48,45\-47:48,38:48\*('' indicates that the
4674exclamation mark, percent sign, dash, period, slash, and ampersand characters 4680exclamation mark, percent sign, dash, period, slash, and ampersand characters
4675should be treated the same way as characters and numbers. 4681should be treated the same way as characters and numbers.
4676This is useful 4682This is useful
4677for cutting and pasting electronic mailing addresses and filenames. 4683for cutting and pasting electronic mailing addresses and filenames.
4678. 4684.
4679. 4685.
4680.SH ACTIONS 4686.SH ACTIONS
4681It is possible to rebind keys (or sequences of keys) to arbitrary strings 4687It is possible to rebind keys (or sequences of keys) to arbitrary strings
4682for input, by changing the \fBtranslations\fP resources 4688for input, by changing the \fBtranslations\fP resources
4683for the vt100 or tek4014 widgets. 4689for the vt100 or tek4014 widgets.
4684Changing the \fBtranslations\fP resource 4690Changing the \fBtranslations\fP resource
4685for events other than key and button events is not expected, 4691for events other than key and button events is not expected,
4686and will cause unpredictable behavior. 4692and will cause unpredictable behavior.
@@ -4734,27 +4740,27 @@ The parameter values are the menu names: @@ -4734,27 +4740,27 @@ The parameter values are the menu names:
4734.B "dabbrev-expand()" 4740.B "dabbrev-expand()"
4735Expands the word before cursor by searching in the preceding text on the 4741Expands the word before cursor by searching in the preceding text on the
4736screen and in the scrollback buffer for words starting with that 4742screen and in the scrollback buffer for words starting with that
4737abbreviation. 4743abbreviation.
4738Repeating \fBdabbrev-expand()\fP several times in sequence searches for an 4744Repeating \fBdabbrev-expand()\fP several times in sequence searches for an
4739alternative expansion by looking farther back. 4745alternative expansion by looking farther back.
4740Lack of more matches is signaled by a \fBbeep()\fP. 4746Lack of more matches is signaled by a \fBbeep()\fP.
4741Attempts to expand an empty word 4747Attempts to expand an empty word
4742(i.e., when cursor is preceded by a space) yield successively all previous 4748(i.e., when cursor is preceded by a space) yield successively all previous
4743words. 4749words.
4744Consecutive identical expansions are ignored. 4750Consecutive identical expansions are ignored.
4745The word here is defined as a sequence of non-whitespace characters. 4751The word here is defined as a sequence of non-whitespace characters.
4746This feature partially emulates the behavior 4752This feature partially emulates the behavior
4747of \*(``dynamic abbreviation\*('' expansion in Emacs (bound there to M-/). 4753of \*(``dynamic abbreviation\*('' expansion in Emacs (bound there to M\-/).
4748Here is a resource setting for \fIxterm\fP which will do the same thing: 4754Here is a resource setting for \fIxterm\fP which will do the same thing:
4749.NS 4755.NS
4750*VT100*translations: #override \\n\\\& 4756*VT100*translations: #override \\n\\\&
4751 Meta <KeyPress> /:dabbrev-expand() 4757 Meta <KeyPress> /:dabbrev-expand()
4752.NE 4758.NE
4753.TP 8 4759.TP 8
4754.B "deiconify()" 4760.B "deiconify()"
4755Changes the window state back to normal, if it was iconified. 4761Changes the window state back to normal, if it was iconified.
4756.TP 8 4762.TP 8
4757.B "delete-is-del()" 4763.B "delete-is-del()"
4758This action toggles the state of the \fBdeleteIsDEL\fP resource. 4764This action toggles the state of the \fBdeleteIsDEL\fP resource.
4759.TP 8 4765.TP 8
4760.B "dired-button()" 4766.B "dired-button()"
@@ -4922,29 +4928,29 @@ This action redraws the window and is al @@ -4922,29 +4928,29 @@ This action redraws the window and is al
4922\fIredraw\fP entry in \fImainMenu\fP. 4928\fIredraw\fP entry in \fImainMenu\fP.
4923.TP 8 4929.TP 8
4924.B "restore()" 4930.B "restore()"
4925Restores the window to the size before it was last maximized. 4931Restores the window to the size before it was last maximized.
4926.TP 8 4932.TP 8
4927.B "scroll-back(\fIcount\fP [,\fIunits\fP [,\fImouse\fP] ])" 4933.B "scroll-back(\fIcount\fP [,\fIunits\fP [,\fImouse\fP] ])"
4928This action scrolls the text window backward so that text that had previously 4934This action scrolls the text window backward so that text that had previously
4929scrolled off the top of the screen is now visible. 4935scrolled off the top of the screen is now visible.
4930.IP 4936.IP
4931The \fIcount\fP argument 4937The \fIcount\fP argument
4932indicates the number of \fIunits\fP (which may be \fIpage\fP, \fIhalfpage\fP, 4938indicates the number of \fIunits\fP (which may be \fIpage\fP, \fIhalfpage\fP,
4933\fIpixel\fP, or \fIline\fP) by which to scroll. 4939\fIpixel\fP, or \fIline\fP) by which to scroll.
4934.IP 4940.IP
4935An adjustment can be specified for these values by appending a "+" or "-" 4941An adjustment can be specified for these values by appending a "+" or "\-"
4936sign followed by a number, 4942sign followed by a number,
4937e.g., \fIpage-2\fP to specify 2 lines less than a page. 4943e.g., \fIpage\-2\fP to specify 2 lines less than a page.
4938.IP 4944.IP
4939If the third parameter \fImouse\fP is given, the action is ignored when 4945If the third parameter \fImouse\fP is given, the action is ignored when
4940mouse reporting is enabled. 4946mouse reporting is enabled.
4941.TP 8 4947.TP 8
4942.B "scroll-forw(\fIcount\fP [,\fIunits\fP [,\fImouse\fP] ])" 4948.B "scroll-forw(\fIcount\fP [,\fIunits\fP [,\fImouse\fP] ])"
4943This action is similar to \fBscroll-back\fP except that it scrolls 4949This action is similar to \fBscroll-back\fP except that it scrolls
4944in the other direction. 4950in the other direction.
4945.TP 8 4951.TP 8
4946.B "secure()" 4952.B "secure()"
4947This action toggles the \fISecure Keyboard\fP mode described in the 4953This action toggles the \fISecure Keyboard\fP mode described in the
4948section named \fBSECURITY\fP, and is invoked from the \fBsecurekbd\fP 4954section named \fBSECURITY\fP, and is invoked from the \fBsecurekbd\fP
4949entry in \fImainMenu\fP. 4955entry in \fImainMenu\fP.
4950.TP 8 4956.TP 8
@@ -4975,27 +4981,27 @@ It should only be bound to Motion events @@ -4975,27 +4981,27 @@ It should only be bound to Motion events
4975.TP 8 4981.TP 8
4976.B "select-set()" 4982.B "select-set()"
4977This action stores text that corresponds to the current selection, 4983This action stores text that corresponds to the current selection,
4978without affecting the selection mode. 4984without affecting the selection mode.
4979.TP 8 4985.TP 8
4980.B "select-start()" 4986.B "select-start()"
4981This action begins text selection at the current pointer location. 4987This action begins text selection at the current pointer location.
4982See 4988See
4983the section on \fBPOINTER USAGE\fP for information on making selections. 4989the section on \fBPOINTER USAGE\fP for information on making selections.
4984.TP 8 4990.TP 8
4985.B "send-signal(\fIsigname\fP)" 4991.B "send-signal(\fIsigname\fP)"
4986This action sends the signal named by \fIsigname\fP 4992This action sends the signal named by \fIsigname\fP
4987to the \fIxterm\fP subprocess (the shell or program specified with 4993to the \fIxterm\fP subprocess (the shell or program specified with
4988the \fI-e\fP command line option) and is also invoked by the 4994the \fI\-e\fP command line option) and is also invoked by the
4989.BR suspend , 4995.BR suspend ,
4990.BR continue , 4996.BR continue ,
4991.BR interrupt , 4997.BR interrupt ,
4992.BR hangup , 4998.BR hangup ,
4993.BR terminate , 4999.BR terminate ,
4994and 5000and
4995.BR kill 5001.BR kill
4996entries in \fImainMenu\fP. 5002entries in \fImainMenu\fP.
4997Allowable signal names are (case is 5003Allowable signal names are (case is
4998not significant): 5004not significant):
4999\fItstp\fP (if supported by the operating system), \fIsuspend\fP (same 5005\fItstp\fP (if supported by the operating system), \fIsuspend\fP (same
5000as \fItstp\fP), \fIcont\fP 5006as \fItstp\fP), \fIcont\fP
5001(if supported by the operating system), \fIint\fP, \fIhup\fP, \fIterm\fP, 5007(if supported by the operating system), \fIint\fP, \fIhup\fP, \fIterm\fP,
@@ -5432,27 +5438,27 @@ WINDOWID @@ -5432,27 +5438,27 @@ WINDOWID
5432is set to the X window id number of the \fIxterm\fP window. 5438is set to the X window id number of the \fIxterm\fP window.
5433.TP 5 5439.TP 5
5434XTERM_LOCALE 5440XTERM_LOCALE
5435shows the locale which was used by \fIxterm\fP on startup. 5441shows the locale which was used by \fIxterm\fP on startup.
5436Some shell initialization scripts may set a different locale. 5442Some shell initialization scripts may set a different locale.
5437.TP 5 5443.TP 5
5438XTERM_SHELL 5444XTERM_SHELL
5439is set to the pathname of the program which is invoked. 5445is set to the pathname of the program which is invoked.
5440Usually that is a shell program, e.g., \fI/bin/sh\fP. 5446Usually that is a shell program, e.g., \fI/bin/sh\fP.
5441Since it is not necessarily a shell program however, 5447Since it is not necessarily a shell program however,
5442it is distinct from \*(``SHELL\*(''. 5448it is distinct from \*(``SHELL\*(''.
5443.TP 5 5449.TP 5
5444XTERM_VERSION 5450XTERM_VERSION
5445is set to the string displayed by the \fB-version\fP option. 5451is set to the string displayed by the \fB\-version\fP option.
5446That is normally an identifier for the X Window libraries used to 5452That is normally an identifier for the X Window libraries used to
5447build \fIxterm\fP, followed by 5453build \fIxterm\fP, followed by
5448\fIxterm\fP's patch number in parenthesis. 5454\fIxterm\fP's patch number in parenthesis.
5449The patch number is also part of the response to a Secondary Device Attributes 5455The patch number is also part of the response to a Secondary Device Attributes
5450(DA) control sequence (see \fIXterm Control Sequences\fP). 5456(DA) control sequence (see \fIXterm Control Sequences\fP).
5451. 5457.
5452.PP 5458.PP
5453Depending on your system configuration, \fIxterm\fP may also set the 5459Depending on your system configuration, \fIxterm\fP may also set the
5454following: 5460following:
5455.TP 5 5461.TP 5
5456COLUMNS 5462COLUMNS
5457the width of the \fIxterm\fP in characters (cf: "stty columns"). 5463the width of the \fIxterm\fP in characters (cf: "stty columns").
5458.TP 5 5464.TP 5
@@ -5481,31 +5487,31 @@ may be defined to a nonstandard location @@ -5481,31 +5487,31 @@ may be defined to a nonstandard location
5481. 5487.
5482.SH FILES 5488.SH FILES
5483The actual pathnames given may differ on your system. 5489The actual pathnames given may differ on your system.
5484.TP 5 5490.TP 5
5485\fI/etc/utmp\fP 5491\fI/etc/utmp\fP
5486the system logfile, which records user logins. 5492the system logfile, which records user logins.
5487.TP 5 5493.TP 5
5488\fI/etc/wtmp\fP 5494\fI/etc/wtmp\fP
5489the system logfile, which records user logins and logouts. 5495the system logfile, which records user logins and logouts.
5490.TP 5 5496.TP 5
5491.I __apploaddir__/XTerm 5497.I __apploaddir__/XTerm
5492the \fIxterm\fP default application resources. 5498the \fIxterm\fP default application resources.
5493.TP 5 5499.TP 5
5494.I __apploaddir__/XTerm-color 5500.I __apploaddir__/XTerm\-color
5495the \fIxterm\fP color application resources. 5501the \fIxterm\fP color application resources.
5496If your display supports color, use this 5502If your display supports color, use this
5497.in +10 5503.in +10
5498*customization: -color 5504*customization: \-color
5499.in -10 5505.in -10
5500in your .Xdefaults file to 5506in your .Xdefaults file to
5501automatically use this resource file rather than 5507automatically use this resource file rather than
5502.IR __apploaddir__/XTerm . 5508.IR __apploaddir__/XTerm .
5503If you do not do this, 5509If you do not do this,
5504\fIxterm\fP uses its compiled-in default resource settings for colors. 5510\fIxterm\fP uses its compiled-in default resource settings for colors.
5505. 5511.
5506. 5512.
5507.SH ERROR MESSAGES 5513.SH ERROR MESSAGES
5508Most of the fatal error messages from \fIxterm\fP use the following format: 5514Most of the fatal error messages from \fIxterm\fP use the following format:
5509.RS 5515.RS
5510xterm: Error \fIXXX\fP, errno \fIYYY\fP: \fIZZZ\fP 5516xterm: Error \fIXXX\fP, errno \fIYYY\fP: \fIZZZ\fP
5511.RE 5517.RE