Module Name: xsrc
Committed By: mrg
Date: Sun Nov 21 06:20:30 UTC 2010
Modified Files:
xsrc/external/mit/xterm/dist: misc.c ptyx.h xterm.man
Log Message:
merge cornflakes for xterm 266
To generate a diff of this commit:
cvs rdiff -u -r1.5 -r1.6 xsrc/external/mit/xterm/dist/misc.c \
xsrc/external/mit/xterm/dist/ptyx.h \
xsrc/external/mit/xterm/dist/xterm.man
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: xsrc/external/mit/xterm/dist/misc.c
diff -u xsrc/external/mit/xterm/dist/misc.c:1.5 xsrc/external/mit/xterm/dist/misc.c:1.6
--- xsrc/external/mit/xterm/dist/misc.c:1.5 Wed Jun 30 04:49:44 2010
+++ xsrc/external/mit/xterm/dist/misc.c Sun Nov 21 06:20:30 2010
@@ -1,4 +1,4 @@
-/* $XTermId: misc.c,v 1.503 2010/06/20 21:33:49 tom Exp $ */
+/* $XTermId: misc.c,v 1.510 2010/10/11 08:33:33 tom Exp $ */
/*
* Copyright 1999-2009,2010 by Thomas E. Dickey
@@ -425,9 +425,32 @@
&& event.xany.type == MotionNotify
&& event.xcrossing.window == XtWindow(xw)) {
SendMousePosition(xw, &event);
+ xtermShowPointer(xw, True);
continue;
}
+ /*
+ * If the event is interesting (and not a keyboard event), turn the
+ * mouse pointer back on.
+ */
+ if (screen->hide_pointer) {
+ switch (event.xany.type) {
+ case KeyPress:
+ case KeyRelease:
+ case ButtonPress:
+ case ButtonRelease:
+ /* also these... */
+ case Expose:
+ case NoExpose:
+ case PropertyNotify:
+ case ClientMessage:
+ break;
+ default:
+ xtermShowPointer(xw, True);
+ break;
+ }
+ }
+
if (!event.xany.send_event ||
screen->allowSendEvents ||
((event.xany.type != KeyPress) &&
@@ -435,28 +458,6 @@
(event.xany.type != ButtonPress) &&
(event.xany.type != ButtonRelease))) {
- /*
- * If the event is interesting (and not a keyboard event), turn the
- * mouse pointer back on.
- */
- if (screen->hide_pointer) {
- switch (event.xany.type) {
- case KeyPress:
- case KeyRelease:
- case ButtonPress:
- case ButtonRelease:
- /* also these... */
- case Expose:
- case NoExpose:
- case PropertyNotify:
- case ClientMessage:
- break;
- default:
- xtermShowPointer(xw, True);
- break;
- }
- }
-
XtDispatchEvent(&event);
}
} while (XtAppPending(app_con) & XtIMXEvent);
@@ -2551,7 +2552,7 @@
* the corresponding menu font entry.
*/
static int
-ParseShiftedFont(XtermWidget xw, char *source, char **target)
+ParseShiftedFont(XtermWidget xw, String source, String * target)
{
TScreen *screen = TScreenOf(xw);
int num = screen->menu_font_number;
@@ -2586,13 +2587,13 @@
}
static void
-QueryFontRequest(XtermWidget xw, char *buf, int final)
+QueryFontRequest(XtermWidget xw, String buf, int final)
{
if (AllowFontOps(xw, efGetFont)) {
TScreen *screen = TScreenOf(xw);
Bool success = True;
int num;
- char *base = buf + 1;
+ String base = buf + 1;
const char *name = 0;
char temp[10];
@@ -2636,7 +2637,7 @@
}
static void
-ChangeFontRequest(XtermWidget xw, char *buf)
+ChangeFontRequest(XtermWidget xw, String buf)
{
if (AllowFontOps(xw, efSetFont)) {
TScreen *screen = TScreenOf(xw);
@@ -3386,6 +3387,314 @@
unparse_end(xw);
}
+#if OPT_DEC_RECTOPS
+enum {
+ mdUnknown = 0,
+ mdMaybeSet = 1,
+ mdMaybeReset = 2,
+ mdAlwaysSet = 3,
+ mdAlwaysReset = 4
+};
+
+#define MdBool(bool) ((bool) ? mdMaybeSet : mdMaybeReset)
+#define MdFlag(mode,flag) MdBool(xw->keyboard.flags & MODE_KAM)
+
+/*
+ * Reply is the same format as the query, with pair of mode/value:
+ * 0 - not recognized
+ * 1 - set
+ * 2 - reset
+ * 3 - permanently set
+ * 4 - permanently reset
+ * Only one mode can be reported at a time.
+ */
+void
+do_rpm(XtermWidget xw, int nparams, int *params)
+{
+ ANSI reply;
+ int result = 0;
+ int count = 0;
+
+ TRACE(("do_rpm %d:%d\n", nparams, params[0]));
+ memset(&reply, 0, sizeof(reply));
+ if (nparams >= 1) {
+ switch (params[0]) {
+ case 1: /* GATM */
+ result = mdAlwaysReset;
+ break;
+ case 2:
+ result = MdFlag(xw->keyboard.flags, MODE_KAM);
+ break;
+ case 3: /* CRM */
+ result = mdMaybeReset;
+ break;
+ case 4:
+ result = MdFlag(xw->flags, INSERT);
+ break;
+ case 5: /* SRTM */
+ case 7: /* VEM */
+ case 10: /* HEM */
+ case 11: /* PUM */
+ result = mdAlwaysReset;
+ break;
+ case 12:
+ result = MdFlag(xw->keyboard.flags, MODE_SRM);
+ break;
+ case 13: /* FEAM */
+ case 14: /* FETM */
+ case 15: /* MATM */
+ case 16: /* TTM */
+ case 17: /* SATM */
+ case 18: /* TSM */
+ case 19: /* EBM */
+ result = mdAlwaysReset;
+ break;
+ case 20:
+ result = MdFlag(xw->flags, LINEFEED);
+ break;
+ }
+ reply.a_param[count++] = (ParmType) params[0];
+ reply.a_param[count++] = (ParmType) result;
+ }
+ reply.a_type = ANSI_CSI;
+ reply.a_nparam = (ParmType) count;
+ reply.a_inters = '$';
+ reply.a_final = 'y';
+ unparseseq(xw, &reply);
+}
+
+void
+do_decrpm(XtermWidget xw, int nparams, int *params)
+{
+ ANSI reply;
+ int result = 0;
+ int count = 0;
+
+ TRACE(("do_decrpm %d:%d\n", nparams, params[0]));
+ memset(&reply, 0, sizeof(reply));
+ if (nparams >= 1) {
+ TScreen *screen = TScreenOf(xw);
+
+ switch (params[0]) {
+ case 1: /* DECCKM */
+ result = MdFlag(xw->keyboard.flags, MODE_DECCKM);
+ break;
+ case 2: /* DECANM - ANSI/VT52 mode */
+#if OPT_VT52_MODE
+ result = MdBool(screen->terminal_id >= 100);
+#else
+ result = mdMaybeSet;
+#endif
+ break;
+ case 3: /* DECCOLM */
+ result = MdFlag(xw->flags, IN132COLUMNS);
+ break;
+ case 4: /* DECSCLM (slow scroll) */
+ result = MdFlag(xw->flags, SMOOTHSCROLL);
+ break;
+ case 5: /* DECSCNM */
+ result = MdFlag(xw->flags, REVERSE_VIDEO);
+ break;
+ case 6: /* DECOM */
+ result = MdFlag(xw->flags, ORIGIN);
+ break;
+ case 7: /* DECAWM */
+ result = MdFlag(xw->flags, WRAPAROUND);
+ break;
+ case 8: /* DECARM */
+ result = mdAlwaysReset;
+ break;
+ case SET_X10_MOUSE: /* X10 mouse */
+ result = MdBool(screen->send_mouse_pos == X10_MOUSE);
+ break;
+#if OPT_TOOLBAR
+ case 10: /* rxvt */
+ result = MdBool(resource.toolBar);
+ break;
+#endif
+#if OPT_BLINK_CURS
+ case 12: /* att610: Start/stop blinking cursor */
+ result = MdBool(screen->cursor_blink_res);
+ break;
+#endif
+ case 18: /* DECPFF: print form feed */
+ result = MdBool(screen->printer_formfeed);
+ break;
+ case 19: /* DECPEX: print extent */
+ result = MdBool(screen->printer_extent);
+ break;
+ case 25: /* DECTCEM: Show/hide cursor (VT200) */
+ result = MdBool(screen->cursor_set);
+ break;
+ case 30: /* rxvt */
+ result = MdBool(screen->fullVwin.sb_info.width != OFF);
+ break;
+#if OPT_SHIFT_FONTS
+ case 35: /* rxvt */
+ result = MdBool(xw->misc.shift_fonts);
+ break;
+#endif
+#if OPT_TEK4014
+ case 38: /* DECTEK */
+ result = MdBool(TEK4014_ACTIVE(xw));
+ break;
+#endif
+ case 40: /* 132 column mode */
+ result = MdBool(screen->c132);
+ break;
+ case 41: /* curses hack */
+ result = MdBool(screen->curses);
+ break;
+ case 42: /* DECNRCM national charset (VT220) */
+ result = MdFlag(xw->flags, NATIONAL);
+ break;
+ case 44: /* margin bell */
+ result = MdBool(screen->marginbell);
+ break;
+ case 45: /* reverse wraparound */
+ result = MdFlag(xw->flags, REVERSEWRAP);
+ break;
+#ifdef ALLOWLOGGING
+ case 46: /* logging */
+#ifdef ALLOWLOGFILEONOFF
+ result = MdBool(screen->logging);
+#endif /* ALLOWLOGFILEONOFF */
+ break;
+#endif
+ case 1049: /* alternate buffer & cursor */
+ /* FALLTHRU */
+ case 1047:
+ /* FALLTHRU */
+ case 47: /* alternate buffer */
+ result = MdBool(screen->whichBuf);
+ break;
+ case 66: /* DECNKM */
+ result = MdFlag(xw->keyboard.flags, MODE_DECKPAM);
+ break;
+ case 67: /* DECBKM */
+ result = MdFlag(xw->keyboard.flags, MODE_DECBKM);
+ break;
+ case SET_VT200_MOUSE: /* xterm bogus sequence */
+ result = MdBool(screen->send_mouse_pos == VT200_MOUSE);
+ break;
+ case SET_VT200_HIGHLIGHT_MOUSE: /* xterm sequence w/hilite tracking */
+ result = MdBool(screen->send_mouse_pos == VT200_HIGHLIGHT_MOUSE);
+ break;
+ case SET_BTN_EVENT_MOUSE:
+ result = MdBool(screen->send_mouse_pos == BTN_EVENT_MOUSE);
+ break;
+ case SET_ANY_EVENT_MOUSE:
+ result = MdBool(screen->send_mouse_pos == ANY_EVENT_MOUSE);
+ break;
+#if OPT_FOCUS_EVENT
+ case SET_FOCUS_EVENT_MOUSE:
+ result = MdBool(screen->send_focus_pos);
+ break;
+#endif
+ case SET_EXT_MODE_MOUSE:
+ result = MdBool(screen->ext_mode_mouse);
+ break;
+ case 1010: /* rxvt */
+ result = MdBool(screen->scrollttyoutput);
+ break;
+ case 1011: /* rxvt */
+ result = MdBool(screen->scrollkey);
+ break;
+ case 1034:
+ result = MdBool(screen->input_eight_bits);
+ break;
+#if OPT_NUM_LOCK
+ case 1035:
+ result = MdBool(xw->misc.real_NumLock);
+ break;
+ case 1036:
+ result = MdBool(screen->meta_sends_esc);
+ break;
+#endif
+ case 1037:
+ result = MdBool(screen->delete_is_del);
+ break;
+#if OPT_NUM_LOCK
+ case 1039:
+ result = MdBool(screen->alt_sends_esc);
+ break;
+#endif
+ case 1040:
+ result = MdBool(screen->keepSelection);
+ break;
+ case 1041:
+ result = MdBool(screen->selectToClipboard);
+ break;
+ case 1042:
+ result = MdBool(screen->bellIsUrgent);
+ break;
+ case 1043:
+ result = MdBool(screen->poponbell);
+ break;
+ case 1048:
+ result = MdBool(screen->sc[screen->whichBuf].saved);
+ break;
+#if OPT_TCAP_FKEYS
+ case 1050:
+ result = MdBool(xw->keyboard.type == keyboardIsTermcap);
+ break;
+#endif
+#if OPT_SUN_FUNC_KEYS
+ case 1051:
+ result = MdBool(xw->keyboard.type == keyboardIsSun);
+ break;
+#endif
+#if OPT_HP_FUNC_KEYS
+ case 1052:
+ result = MdBool(xw->keyboard.type == keyboardIsHP);
+ break;
+#endif
+#if OPT_SCO_FUNC_KEYS
+ case 1053:
+ result = MdBool(xw->keyboard.type == keyboardIsSCO);
+ break;
+#endif
+ case 1060:
+ result = MdBool(xw->keyboard.type == keyboardIsLegacy);
+ break;
+#if OPT_SUNPC_KBD
+ case 1061:
+ result = MdBool(xw->keyboard.type == keyboardIsVT220);
+ break;
+#endif
+#if OPT_READLINE
+ case SET_BUTTON1_MOVE_POINT:
+ result = MdBool(screen->click1_moves);
+ break;
+ case SET_BUTTON2_MOVE_POINT:
+ result = MdBool(screen->paste_moves);
+ break;
+ case SET_DBUTTON3_DELETE:
+ result = MdBool(screen->dclick3_deletes);
+ break;
+ case SET_PASTE_IN_BRACKET:
+ result = MdBool(screen->paste_brackets);
+ break;
+ case SET_PASTE_QUOTE:
+ result = MdBool(screen->paste_quotes);
+ break;
+ case SET_PASTE_LITERAL_NL:
+ result = MdBool(screen->paste_literal_nl);
+ break;
+#endif /* OPT_READLINE */
+ }
+ reply.a_param[count++] = (ParmType) params[0];
+ reply.a_param[count++] = (ParmType) result;
+ }
+ reply.a_type = ANSI_CSI;
+ reply.a_pintro = '?';
+ reply.a_nparam = (ParmType) count;
+ reply.a_inters = '$';
+ reply.a_final = 'y';
+ unparseseq(xw, &reply);
+}
+#endif /* OPT_DEC_RECTOPS */
+
char *
udk_lookup(int keycode, int *len)
{
Index: xsrc/external/mit/xterm/dist/ptyx.h
diff -u xsrc/external/mit/xterm/dist/ptyx.h:1.5 xsrc/external/mit/xterm/dist/ptyx.h:1.6
--- xsrc/external/mit/xterm/dist/ptyx.h:1.5 Wed Jun 30 04:49:44 2010
+++ xsrc/external/mit/xterm/dist/ptyx.h Sun Nov 21 06:20:30 2010
@@ -1,4 +1,4 @@
-/* $XTermId: ptyx.h,v 1.670 2010/06/15 08:34:38 tom Exp $ */
+/* $XTermId: ptyx.h,v 1.675 2010/10/11 08:25:53 tom Exp $ */
/*
* Copyright 1999-2009,2010 by Thomas E. Dickey
@@ -1374,6 +1374,7 @@
DP_X_MARGIN,
DP_X_MORE,
DP_X_MOUSE,
+ DP_X_EXT_MOUSE,
DP_X_REVWRAP,
DP_X_X10MSE,
#if OPT_BLINK_CURS
@@ -1580,6 +1581,7 @@
long event_mask;
unsigned send_mouse_pos; /* user wants mouse transition */
/* and position information */
+ Boolean ext_mode_mouse; /* support large terminals */
Boolean send_focus_pos; /* user wants focus in/out info */
Boolean quiet_grab; /* true if no cursor change on focus */
#if OPT_PASTE64
@@ -1693,7 +1695,9 @@
XTermFonts fnts[fMAX]; /* normal/bold/etc for terminal */
Boolean free_bold_box; /* same_font_size's austerity */
#ifndef NO_ACTIVE_ICON
- XTermFonts fnt_icon; /* icon font */
+ XTermFonts fnt_icon; /* icon font */
+ String icon_fontname; /* name of icon font */
+ int icon_fontnum; /* number to use for icon font */
#endif /* NO_ACTIVE_ICON */
int enbolden; /* overstrike for bold font */
XPoint *box; /* draw unselected cursor */
@@ -1875,6 +1879,7 @@
Boolean cutNewline; /* whether or not line cut has \n */
Boolean cutToBeginningOfLine; /* line cuts to BOL? */
Boolean highlight_selection; /* controls appearance of selection */
+ Boolean show_wrap_marks; /* show lines which are wrapped */
Boolean trim_selection; /* controls trimming of selection */
Boolean i18nSelections;
Boolean brokenSelections;
@@ -2124,11 +2129,11 @@
} TKeyboard;
typedef struct {
- char *f_n; /* the normal font */
- char *f_b; /* the bold font */
+ String f_n; /* the normal font */
+ String f_b; /* the bold font */
#if OPT_WIDE_CHARS
- char *f_w; /* the normal wide font */
- char *f_wb; /* the bold wide font */
+ String f_w; /* the normal wide font */
+ String f_wb; /* the bold wide font */
#endif
} VTFontNames;
Index: xsrc/external/mit/xterm/dist/xterm.man
diff -u xsrc/external/mit/xterm/dist/xterm.man:1.5 xsrc/external/mit/xterm/dist/xterm.man:1.6
--- xsrc/external/mit/xterm/dist/xterm.man:1.5 Wed Jun 30 04:49:45 2010
+++ xsrc/external/mit/xterm/dist/xterm.man Sun Nov 21 06:20:30 2010
@@ -1,5 +1,5 @@
'\" t
-.\" $XTermId: xterm.man,v 1.465 2010/06/15 09:38:48 tom Exp $
+.\" $XTermId: xterm.man,v 1.467 2010/10/11 00:36:08 tom Exp $
.\"
.\" Copyright 1996-2009,2010 by Thomas E. Dickey
.\"
@@ -82,7 +82,7 @@
xterm \- terminal emulator for X
.SH SYNOPSIS
.B xterm
-[-\fItoolkitoption\fP ...] [-\fIoption\fP ...] [\fIshell\fP]
+[\-\fItoolkitoption\fP ...] [\-\fIoption\fP ...] [\fIshell\fP]
.SH DESCRIPTION
The \fIxterm\fP program is a terminal emulator for the X Window System.
It provides DEC VT102/VT220 (VTxxx) and Tektronix 4014
@@ -157,7 +157,7 @@
.B Tektronix
menu; see below).
The name of the file will be
-\*(``\fBCOPY\fIyyyy\fB-\fIMM\fB-\fIdd\fB.\fIhh\fB:\fImm\fB:\fIss\fR\*('', where
+\*(``\fBCOPY\fIyyyy\fB\-\fIMM\fB\-\fIdd\fB.\fIhh\fB:\fImm\fB:\fIss\fR\*('', where
.IR yyyy ,
.IR MM ,
.IR dd ,
@@ -228,31 +228,31 @@
If the option begins with a
.RB ` + '
instead of a
-.RB ` - ',
+.RB ` \- ',
the option is restored to its default value.
-The \fB-version\fP and \fB-help\fP options are interpreted even if \fIxterm\fP
+The \fB\-version\fP and \fB\-help\fP options are interpreted even if \fIxterm\fP
cannot open the display, and are useful for testing and configuration scripts:
.TP 8
-.B -version
+.B \-version
This causes \fIxterm\fP to print a version number to the standard output.
.TP 8
-.B -help
+.B \-help
This causes \fIxterm\fP to print out a verbose message describing its options,
one per line.
The message is written to the standard output.
\fIXterm\fP generates this message, sorting it and noting whether
-a "\fB-option\fP"
+a "\fB\-option\fP"
or a "\fB+option\fP" turns the feature on or off,
since some features historically have been one or the other.
\fIXterm\fP generates a concise help message (multiple options per line)
when an unknown option is used, e.g.,
.RS
- \fBxterm -z\fP
+ \fBxterm \-z\fP
.RE
.IP
If the logic for a particular option such as logging is not compiled
into \fIxterm\fP, the help text for that option also is not displayed
-by the \fB-help\fP option.
+by the \fB\-help\fP option.
.
.PP
One parameter (after all options) may be given.
@@ -264,20 +264,20 @@
If the parameter names an executable file, \fIxterm\fP uses that instead.
The parameter must be an absolute path, or name a file found on the user's
PATH (and thereby construct an absolute path).
-The \fB-e\fP option cannot be used with this parameter since
+The \fB\-e\fP option cannot be used with this parameter since
it uses all parameters following the option.
.PP
The other options are used to control the appearance and behavior.
Not all options are necessarily configured into your copy of \fIxterm\fP:
.TP 8
-.B -132
+.B \-132
Normally, the VT102 DECCOLM escape sequence that switches between 80 and
132 column mode is ignored.
This option causes the DECCOLM escape sequence to be recognized, and the
.I xterm
window will resize appropriately.
.TP 8
-.B -ah
+.B \-ah
This option indicates that
.I xterm
should always highlight the text cursor.
@@ -291,7 +291,7 @@
.I xterm
should do text cursor highlighting based on focus.
.TP 8
-.B -ai
+.B \-ai
This option disables active icon support if that feature was compiled
into \fIxterm\fP.
This is equivalent to setting the \fIvt100\fP resource
@@ -303,7 +303,7 @@
This is equivalent to setting the \fIvt100\fP resource
\fBactiveIcon\fP to \*(``true\*(''.
.TP 8
-.B -aw
+.B \-aw
This option indicates that auto-wraparound should be allowed.
This
allows the cursor to automatically wrap to the beginning of the next
@@ -313,7 +313,7 @@
.B +aw
This option indicates that auto-wraparound should not be allowed.
.TP 8
-.BI -b " number"
+.BI \-b " number"
This option specifies the size of the inner border (the distance between
the outer edge of the characters and the window border) in pixels.
That is the \fIvt100\fP \fIinternalBorder\fP resource.
@@ -324,19 +324,19 @@
turn off text cursor blinking.
This overrides the \fBcursorBlink\fR resource.
.TP 8
-.B -bc
+.B \-bc
turn on text cursor blinking.
This overrides the \fBcursorBlink\fR resource.
.TP 8
-.BI -bcf " milliseconds"
+.BI \-bcf " milliseconds"
set the amount of time text cursor is off when blinking via the
\fIcursorOffTime\fP resource.
.TP 8
-.BI -bcn " milliseconds"
+.BI \-bcn " milliseconds"
set the amount of time text cursor is on when blinking via the
\fIcursorOffTime\fP resource.
.TP 8
-.B "-bdc"
+.B "\-bdc"
Set the \fIvt100\fP resource \fBcolorBDMode\fR to \*(``false\*('',
disabling the display of characters with bold attribute as color
.TP 8
@@ -345,19 +345,19 @@
enabling the display of characters with bold attribute as color
rather than bold
.TP 8
-.B "-cb"
+.B "\-cb"
Set the \fIvt100\fP resource \fBcutToBeginningOfLine\fP to \*(``false\*(''.
.TP 8
.B "+cb"
Set the \fIvt100\fP resource \fBcutToBeginningOfLine\fP to \*(``true\*(''.
.TP 8
-.B "-cc \fIcharacterclassrange\fP:\fIvalue\fP[,...]"
+.B "\-cc \fIcharacterclassrange\fP:\fIvalue\fP[,...]"
This sets classes indicated by the given ranges for using in selecting by
words.
See the section specifying character classes.
and discussion of the \fIcharClass\fP resource.
.TP 8
-.B "-cjk_width"
+.B "\-cjk_width"
Set the \fBcjkWidth\fP resource to \*(``true\*(''.
When turned on, characters with East Asian Ambiguous (A) category in UTR 11
have a column width of 2.
@@ -366,19 +366,19 @@
terminal-based programs assuming box drawings and others to have a column
width of 2.
It also should be turned on when you specify a TrueType
-CJK double-width (bi-width/monospace) font either with \fB-fa\fP at
+CJK double-width (bi-width/monospace) font either with \fB\-fa\fP at
the command line or \fBfaceName\fP resource.
The default is \*(``false\*(''
.TP 8
.B "+cjk_width"
Reset the \fBcjkWidth\fP resource.
.TP 8
-.BI -class " string"
+.BI \-class " string"
This option allows you to override \fIxterm\fP's resource class.
Normally it is \*(``XTerm\*('', but
can be set to another class such as \*(``UXTerm\*('' to override selected resources.
.TP 8
-.B "-cm"
+.B "\-cm"
This option disables recognition of ANSI color-change escape sequences.
It sets the \fIcolorMode\fP resource to \*(``false\*(''.
.TP 8
@@ -386,7 +386,7 @@
This option enables recognition of ANSI color-change escape sequences.
This is the same as the \fIvt100\fP resource \fBcolorMode\fP.
.TP 8
-.B "-cn"
+.B "\-cn"
This option indicates that newlines should not be cut in line-mode
selections.
It sets the \fIcutNewline\fP resource to \*(``false\*(''.
@@ -395,13 +395,13 @@
This option indicates that newlines should be cut in line-mode selections.
It sets the \fIcutNewline\fP resource to \*(``true\*(''.
.TP 8
-.BI -cr " color"
+.BI \-cr " color"
This option specifies the color to use for text cursor.
The default is to
use the same foreground color that is used for text.
It sets the \fIcursorColor\fP resource according to the parameter.
.TP 8
-.B -cu
+.B \-cu
This option indicates that \fIxterm\fP should work around a bug in the
.IR more (1)
program that causes it
@@ -418,7 +418,7 @@
.IR more (1)
bug mentioned above.
.TP 8
-.B "-dc"
+.B "\-dc"
This option disables the escape sequence to change dynamic colors:
the vt100 foreground and background colors,
its text cursor color,
@@ -432,22 +432,22 @@
This option enables the escape sequence to change dynamic colors.
The option sets the \fIdynamicColors\fP option to \*(``true\*(''.
.TP 8
-.BI -e " program \fP[ \fIarguments \fP.\|.\|. ]\fI"
+.BI \-e " program \fP[ \fIarguments \fP.\|.\|. ]\fI"
This option specifies the program (and its command line arguments) to be
run in the \fIxterm\fP window.
It also sets the window title and icon
-name to be the basename of the program being executed if neither \fI-T\fP
-nor \fI-n\fP are given on the command line.
+name to be the basename of the program being executed if neither \fI\-T\fP
+nor \fI\-n\fP are given on the command line.
\fBThis must be the last option on the command line.\fP
.TP 8
-.BI -en " encoding"
+.BI \-en " encoding"
This option determines the encoding on which \fIxterm\fP runs.
It sets the \fBlocale\fR resource.
Encodings other than UTF-8 are supported by using \fIluit\fR.
-The \fB-lc\fR option should be used instead of \fB-en\fR for
+The \fB\-lc\fR option should be used instead of \fB\-en\fR for
systems with locale support.
.TP 8
-.BI -fb " font"
+.BI \-fb " font"
This option specifies a font to be used when displaying bold text.
It sets the \fBboldFont\fR resource.
.IP
@@ -457,7 +457,7 @@
.IP
See also the discussion of \fBboldMode\fP and \fBalwaysBoldMode\fP resources.
.TP 8
-.BI -fa " pattern"
+.BI \-fa " pattern"
This option sets the pattern for fonts selected from the FreeType
library if support for that library was compiled into \fIxterm\fP.
This corresponds to the \fBfaceName\fP resource.
@@ -469,7 +469,7 @@
which combines with this to determine whether FreeType fonts are
initially active.
.TP 8
-.BI -fbb
+.BI \-fbb
This option indicates that \fIxterm\fP should compare normal and bold fonts bounding
boxes to ensure they are compatible.
It sets the \fBfreeBoldBox\fP resource to \*(``false\*(''.
@@ -479,7 +479,7 @@
boxes to ensure they are compatible.
It sets the \fBfreeBoldBox\fP resource to \*(``true\*(''.
.TP 8
-.BI -fbx
+.BI \-fbx
This option indicates that \fIxterm\fP should not assume that the
normal and bold fonts have VT100 line-drawing characters.
If any are missing, \fIxterm\fP will draw the characters directly.
@@ -490,23 +490,23 @@
normal and bold fonts have VT100 line-drawing characters.
It sets the \fBforceBoxChars\fP resource to \*(``true\*(''.
.TP 8
-.BI -fd " pattern"
+.BI \-fd " pattern"
This option sets the pattern for double-width fonts selected from the FreeType
library if support for that library was compiled into \fIxterm\fP.
This corresponds to the \fBfaceNameDoublesize\fP resource.
.TP 8
-.BI -fi " font"
+.BI \-fi " font"
This option sets the font for active icons if that feature was compiled
into \fIxterm\fP.
.IP
See also the discussion of the \fBiconFont\fP resource.
.TP 8
-.BI -fs " size"
+.BI \-fs " size"
This option sets the pointsize for fonts selected from the FreeType
library if support for that library was compiled into \fIxterm\fP.
This corresponds to the \fBfaceSize\fP resource.
.TP 8
-.B -fw \fIfont\fP
+.B \-fw \fIfont\fP
This option specifies the font to be used for displaying wide text.
By default,
it will attempt to use a font twice as wide as the font that will be used to
@@ -515,7 +515,7 @@
the normal font.
This corresponds to the \fBwideFont\fP resource.
.TP 8
-.B -fwb \fIfont\fP
+.B \-fwb \fIfont\fP
This option specifies the font to be used for displaying bold wide text.
By default,
it will attempt to use a font twice as wide as the font that will be used to
@@ -524,16 +524,16 @@
the bold font.
This corresponds to the \fBwideBoldFont\fP resource.
.TP 8
-.B -fx \fIfont\fP
+.B \-fx \fIfont\fP
This option specifies the font to be used for displaying the preedit string
in the "OverTheSpot" input method.
.IP
See also the discussion of the \fBximFont\fP resource.
.TP 8
-.BI -hc " color"
-(see \fB-selbg\fP).
+.BI \-hc " color"
+(see \fB\-selbg\fP).
.TP 8
-.BI -hf
+.BI \-hf
This option indicates that HP Function Key escape codes should be generated
for function keys.
It sets the \fBhpFunctionKeys\fP resource to \*(``true\*(''.
@@ -543,7 +543,7 @@
for function keys.
It sets the \fBhpFunctionKeys\fP resource to \*(``false\*(''.
.TP 8
-.BI -hm
+.BI \-hm
Tells \fIxterm\fP to use
\fBhighlightTextColor\fP and \fBhighlightColor\fP
to override the reversed foreground/background colors in a selection.
@@ -555,7 +555,7 @@
to override the reversed foreground/background colors in a selection.
It sets the \fBhighlightColorMode\fP resource to \*(``false\*(''.
.TP 8
-.BI -hold
+.BI \-hold
Turn on the \fBhold\fP resource, i.e.,
\fIxterm\fP will not immediately destroy its window when the shell command completes.
It will wait until you use the window manager to destroy/kill the window, or
@@ -565,7 +565,7 @@
Turn off the \fBhold\fP resource, i.e.,
\fIxterm\fP will immediately destroy its window when the shell command completes.
.TP 8
-.B -ie
+.B \-ie
Turn on the \fBptyInitialErase\fP resource, i.e.,
use the pseudo-terminal's sense of the stty erase value.
.TP 8
@@ -574,7 +574,7 @@
set the stty erase value using the \fBkb\fP string from the termcap entry as
a reference, if available.
.TP 8
-.B -im
+.B \-im
Turn on the \fBuseInsertMode\fP resource,
which forces use of insert mode by adding appropriate entries to the TERMCAP
environment variable.
@@ -582,12 +582,12 @@
.B +im
Turn off the \fBuseInsertMode\fP resource.
.TP 8
-.BI -into " windowId"
+.BI \-into " windowId"
Given an X window identifier (a decimal integer),
\fIxterm\fP will reparent its top-level shell widget to that window.
This is used to embed \fIxterm\fP within other applications.
.TP 8
-.B -j
+.B \-j
This option indicates that \fIxterm\fP should do jump scrolling.
It corresponds to the \fBjumpScroll\fP resource.
Normally,
@@ -604,7 +604,7 @@
.B +j
This option indicates that \fIxterm\fP should not do jump scrolling.
.TP 8
-.B -k8
+.B \-k8
This option sets the \fBallowC1Printable\fP resource.
When \fBallowC1Printable\fP is set, \fIxterm\fP overrides the mapping
of C1 control characters (code 128-159) to treat them as printable.
@@ -612,7 +612,7 @@
.B +k8
This option resets the \fBallowC1Printable\fP resource.
.TP 8
-.BI -kt " keyboardtype"
+.BI \-kt " keyboardtype"
This option sets the \fBkeyboardType\fP resource.
Possible values include:
\*(``unknown\*('',
@@ -636,7 +636,7 @@
.BR sunKeyboard ,
using the Sun/PC keyboard layout.
.TP 8
-.B -l
+.B \-l
Turn logging on.
Normally logging is not supported, due to security concerns.
Some versions of \fIxterm\fP may have logging enabled.
@@ -655,7 +655,7 @@
.B +l
Turn logging off.
.TP 8
-.B -lc
+.B \-lc
Turn on support of various encodings according to the users'
locale setting, i.e., LC_ALL, LC_CTYPE, or LANG environment variables.
This is achieved by turning on UTF-8 mode and by invoking \fIluit\fR for
@@ -666,53 +666,53 @@
The actual list of encodings which are supported is determined by \fIluit\fR.
Consult the \fIluit\fR manual page for further details.
.IP
-See also the discussion of the \fB-u8\fP option which supports UTF-8 locales.
+See also the discussion of the \fB\-u8\fP option which supports UTF-8 locales.
.TP 8
.B +lc
Turn off support of automatic selection of locale encodings.
-Conventional 8bit mode or, in UTF-8 locales or with \fB-u8\fP option,
+Conventional 8bit mode or, in UTF-8 locales or with \fB\-u8\fP option,
UTF-8 mode will be used.
.TP 8
-.BI -lcc " path"
+.BI \-lcc " path"
File name for the encoding converter from/to locale encodings
-and UTF-8 which is used with \fB-lc\fP option or \fBlocale\fR resource.
+and UTF-8 which is used with \fB\-lc\fP option or \fBlocale\fR resource.
This corresponds to the \fBlocaleFilter\fR resource.
.TP 8
-.B -leftbar
+.B \-leftbar
Force scrollbar to the left side of VT100 screen.
This is the default, unless you have set the rightScrollBar resource.
.TP 8
-.BI -lf " filename"
+.BI \-lf " filename"
Specify the log-filename.
-See the \fB-l\fP option.
+See the \fB\-l\fP option.
.TP 8
-.B -ls
+.B \-ls
This option indicates that the shell that is started in the \fIxterm\fP window
will be a login shell (i.e., the first character of argv[0] will be a dash,
indicating to the shell that it should read the user's .login or .profile).
.IP
-The \fB-ls\fP flag and the \fBloginShell\fP resource
-are ignored if \fB-e\fP is also given,
+The \fB\-ls\fP flag and the \fBloginShell\fP resource
+are ignored if \fB\-e\fP is also given,
because \fIxterm\fP does not know how to make the shell
start the given command after whatever it does when it is a login
-shell - the user's shell of choice need not be a Bourne shell after all.
-Also, \fIxterm\ -e\fP is supposed to provide a consistent
+shell \- the user's shell of choice need not be a Bourne shell after all.
+Also, \fIxterm\ \-e\fP is supposed to provide a consistent
functionality for other applications that need to start text-mode
programs in a window, and if \fBloginShell\fP were not ignored, the
result of ~/.profile might interfere with that.
.IP
-If you do want the effect of \fB-ls\fP and \fB-e\fP simultaneously, you
+If you do want the effect of \fB\-ls\fP and \fB\-e\fP simultaneously, you
may get away with something like
.RS 15
-xterm -e /bin/bash -l -c "my command here"
+xterm \-e /bin/bash \-l \-c "my command here"
.RE
.IP
-Finally, \fB-ls\fP is not completely ignored,
-because \fIxterm\ -ls\ -e\fP does write a \fI/etc/wtmp\fP entry
+Finally, \fB\-ls\fP is not completely ignored,
+because \fIxterm\ \-ls\ \-e\fP does write a \fI/etc/wtmp\fP entry
(if configured to do so),
-whereas \fIxterm\ -e\fP does not.
+whereas \fIxterm\ \-e\fP does not.
.TP 8
-.B -maximized
+.B \-maximized
This option indicates that \fIxterm\fP should ask the window manager to
maximize its layout on startup.
This corresponds to the \fBmaximized\fP resource.
@@ -728,17 +728,17 @@
This option indicates that the shell that is started should not be a login
shell (i.e., it will be a normal \*(``subshell\*('').
.TP 8
-.B -mb
+.B \-mb
This option indicates that \fIxterm\fP should ring a margin bell when
the user types near the right end of a line.
.TP 8
.B +mb
This option indicates that margin bell should not be rung.
.TP 8
-.BI -mc " milliseconds"
+.BI \-mc " milliseconds"
This option specifies the maximum time between multi-click selections.
.TP 8
-.B -mesg
+.B \-mesg
Turn off the \fBmessages\fP resource, i.e.,
disallow write access to the terminal.
.TP 8
@@ -746,7 +746,7 @@
Turn on the \fBmessages\fP resource, i.e.,
allow write access to the terminal.
.TP 8
-.B "-mk_width"
+.B "\-mk_width"
Set the \fBmkWidth\fP resource to \*(``true\*(''.
This makes \fIxterm\fP use a built-in version of the wide-character width
calculation.
@@ -755,31 +755,31 @@
.B "+mk_width"
Reset the \fBmkWidth\fP resource.
.TP 8
-.BI -ms " color"
+.BI \-ms " color"
This option specifies the color to be used for the pointer cursor.
The default
is to use the foreground color.
This sets the \fIpointerColor\fP resource.
.TP 8
-.BI -nb " number"
+.BI \-nb " number"
This option specifies the number of characters from the right end of a line
at which the margin bell, if enabled, will ring.
The default is 10.
.TP 8
-.B "-nul"
+.B "\-nul"
This option disables the display of underlining.
.TP 8
.B "+nul"
This option enables the display of underlining.
.TP 8
-.B -pc
+.B \-pc
This option enables the PC-style use of bold colors (see boldColors
resource).
.TP 8
.B +pc
This option disables the PC-style use of bold colors.
.TP 8
-.B -pob
+.B \-pob
This option indicates that the window should be raised whenever a
Control-G is received.
.TP 8
@@ -787,16 +787,16 @@
This option indicates that the window should not be raised whenever a
Control-G is received.
.TP 8
-.B -rightbar
+.B \-rightbar
Force scrollbar to the right side of VT100 screen.
.TP 8
-.B "-rvc"
+.B "\-rvc"
This option disables the display of characters with reverse attribute as color.
.TP 8
.B "+rvc"
This option enables the display of characters with reverse attribute as color.
.TP 8
-.B -rw
+.B \-rw
This option indicates that reverse-wraparound should be allowed.
This allows
the cursor to back up from the leftmost column of one line to the rightmost
@@ -809,7 +809,7 @@
.B +rw
This option indicates that reverse-wraparound should not be allowed.
.TP 8
-.B -s
+.B \-s
This option indicates that \fIxterm\fP may scroll asynchronously, meaning that
the screen does not have to be kept completely up to date while scrolling.
This allows \fIxterm\fP to run faster when network latencies are very high
@@ -819,7 +819,7 @@
.B +s
This option indicates that \fIxterm\fP should scroll synchronously.
.TP 8
-.B -samename
+.B \-samename
Does not send title and icon name change requests when the request
would have no effect: the name is not changed.
This has the advantage
@@ -831,7 +831,7 @@
.B +samename
Always send title and icon name change requests.
.TP 8
-.B -sb
+.B \-sb
This option indicates that some number of lines that are scrolled off the top
of the window should be saved and that a scrollbar should be displayed so that
those lines can be viewed.
@@ -841,17 +841,17 @@
.B +sb
This option indicates that a scrollbar should not be displayed.
.TP 8
-.BI -selbg " color"
+.BI \-selbg " color"
This option specifies the color to use for the background of selected text.
If not specified, reverse video is used.
See the discussion of the \fBhighlightColor\fP resource.
.TP 8
-.BI -selfg " color"
+.BI \-selfg " color"
This option specifies the color to use for selected text.
If not specified, reverse video is used.
See the discussion of the \fBhighlightTextColor\fP resource.
.TP 8
-.B -sf
+.B \-sf
This option indicates that Sun Function Key escape codes should be generated
for function keys.
.TP 8
@@ -859,7 +859,7 @@
This option indicates that the standard escape codes should be generated for
function keys.
.TP 8
-.B -si
+.B \-si
This option indicates that output to a window should not automatically
reposition the screen to the bottom of the scrolling region.
This option can be turned on and off from the \*(``VT Options\*('' menu.
@@ -868,7 +868,7 @@
This option indicates that output to a window should cause it to
scroll to the bottom.
.TP 8
-.B -sk
+.B \-sk
This option indicates that pressing a key while
using the scrollbar to review previous lines of text should
cause the window to be repositioned automatically in the normal position at the
@@ -878,13 +878,13 @@
This option indicates that pressing a key while using the scrollbar
should not cause the window to be repositioned.
.TP 8
-.BI -sl " number"
+.BI \-sl " number"
This option specifies the number of lines to save that have been scrolled
off the top of the screen.
This corresponds to the \fBsaveLines\fP resource.
The default is 64.
.TP 8
-.B -sm
+.B \-sm
This option, corresponding to the \fBsessionMgt\fR resource,
indicates that \fIxterm\fR should
set up session manager callbacks.
@@ -893,7 +893,7 @@
This option indicates that \fIxterm\fR should
not set up session manager callbacks.
.TP 8
-.B -sp
+.B \-sp
This option indicates that Sun/PC keyboard should be assumed,
providing mapping for keypad \*(``+' to \*(``,', and
CTRL-F1 to F13, CTRL-F2 to F14, etc.
@@ -902,7 +902,7 @@
This option indicates that the standard escape codes should be generated for
keypad and function keys.
.TP 8
-.B -t
+.B \-t
This option indicates that \fIxterm\fP should start in Tektronix mode, rather
than in VT102 mode.
Switching between the two windows is done using the
@@ -923,7 +923,7 @@
.B +t
This option indicates that \fIxterm\fP should start in VT102 mode.
.TP 8
-.B -tb
+.B \-tb
This option, corresponding to the \fBtoolBar\fR resource,
indicates that \fIxterm\fR should display a toolbar (or menubar)
at the top of its window.
@@ -934,7 +934,7 @@
This option indicates that \fIxterm\fR should
not set up a toolbar.
.TP 8
-.BI -ti " term_id"
+.BI \-ti " term_id"
Specify the name used by \fIxterm\fP to select the
correct response to terminal ID queries.
It also specifies the emulation level,
@@ -944,14 +944,14 @@
The term_id argument specifies the terminal ID to use.
(This is the same as the \fBdecTerminalID\fP resource).
.TP 8
-.BI -tm " string"
+.BI \-tm " string"
This option specifies a series of terminal setting keywords followed by the
characters that should be bound to those functions, similar to the \fIstty\fP
program.
The keywords and their values are described in detail in the \fBttyModes\fP
resource.
.TP 8
-.BI -tn " name"
+.BI \-tn " name"
This option specifies the name of the terminal type to be set in the TERM
environment variable.
It corresponds to the \fBtermName\fP resource.
@@ -962,7 +962,7 @@
If the terminal type is not found, \fIxterm\fP uses the built-in list
\*(``xterm\*('', \*(``vt102\*('', etc.
.TP 8
-.B -u8
+.B \-u8
This option sets the \fButf8\fP resource.
When \fButf8\fP is set, \fIxterm\fP interprets incoming data as UTF-8.
This sets the \fBwideChars\fP resource as a side-effect,
@@ -970,26 +970,26 @@
If you must turn it on and off, use the \fBwideChars\fP resource.
.IP
This option and the \fButf8\fR resource are overridden by
-the \fB-lc\fP and \fB-en\fP options and \fBlocale\fR resource.
+the \fB\-lc\fP and \fB\-en\fP options and \fBlocale\fR resource.
That is, if \fIxterm\fP has been compiled to support \fIluit\fR,
and the \fBlocale\fP resource is not \*(``false\*(''
this option is ignored.
We recommend using
-the \fB-lc\fR option or the \*(``\fBlocale:\ true\fR\*('' resource
+the \fB\-lc\fR option or the \*(``\fBlocale:\ true\fR\*('' resource
in UTF-8 locales when your operating system supports locale,
-or \fB-en\ UTF-8\fP option or the \*(``\fBlocale:\ UTF-8\fR\*('' resource
+or \fB\-en\ UTF-8\fP option or the \*(``\fBlocale:\ UTF-8\fR\*('' resource
when your operating system does not support locale.
.TP 8
.B +u8
This option resets the \fButf8\fP resource.
.TP 8
-.B "-uc"
+.B "\-uc"
This option makes the cursor underlined instead of a box.
.TP 8
.B "+uc"
This option makes the cursor a box instead of underlined.
.TP 8
-.B "-ulc"
+.B "\-ulc"
This option disables the display of characters with underline attribute as
color rather than with underlining.
.TP 8
@@ -997,7 +997,7 @@
This option enables the display of characters with underline attribute as
color rather than with underlining.
.TP 8
-.B "-ulit"
+.B "\-ulit"
This option, corresponding to the \fBitalicULMode\fP resource,
disables the display of characters with underline attribute as
italics rather than with underlining.
@@ -1007,7 +1007,7 @@
enables the display of characters with underline attribute as
italics rather than with underlining.
.TP 8
-.B -ut
+.B \-ut
This option indicates that \fIxterm\fP should not write a record into the
the system \fIutmp\fP log file.
.TP 8
@@ -1015,7 +1015,7 @@
This option indicates that \fIxterm\fP should write a record into
the system \fIutmp\fP log file.
.TP 8
-.B -vb
+.B \-vb
This option indicates that a visual bell is preferred over an audible one.
Instead of ringing the terminal bell whenever a Control-G is received, the
window will be flashed.
@@ -1023,7 +1023,7 @@
.B +vb
This option indicates that a visual bell should not be used.
.TP 8
-.B -wc
+.B \-wc
This option sets the \fBwideChars\fP resource.
When \fBwideChars\fP is set, \fIxterm\fP maintains internal structures for 16-bit
characters.
@@ -1034,7 +1034,7 @@
.B +wc
This option resets the \fBwideChars\fP resource.
.TP 8
-.B -wf
+.B \-wf
This option indicates that \fIxterm\fP should wait for the window to be mapped
the first time before starting the subprocess so that the initial terminal
size settings and environment variables are correct.
@@ -1045,7 +1045,7 @@
This option indicates that \fIxterm\fP should not wait before starting the
subprocess.
.TP 8
-.B -ziconbeep \fIpercent\fP
+.B \-ziconbeep \fIpercent\fP
Same as \fBzIconBeep\fP resource.
If percent is non-zero, xterms that produce output while iconified
will cause an XBell sound at the given volume
@@ -1054,7 +1054,7 @@
which window has the output.
(A similar feature was in x10 \fIxterm\fP.)
.TP 8
-.B -C
+.B \-C
This option indicates that this window should receive console output.
This
is not supported on all systems.
@@ -1065,7 +1065,7 @@
need to have the session startup and reset programs explicitly change the
ownership of the console device in order to get this option to work.
.TP 8
-.B -S\fIccn\fP
+.B \-S\fIccn\fP
This option allows \fIxterm\fP to be used as an input and
output channel for an existing program and is sometimes used in specialized
applications.
@@ -1087,7 +1087,7 @@
which it did not open for its own use.
It is possible (though probably not portable) to have an application
which passes an open file descriptor down to \fIxterm\fP past the
-initialization or the \fB-S\fP option to a process running in the \fIxterm\fP.
+initialization or the \fB\-S\fP option to a process running in the \fIxterm\fP.
.PP
The following command line arguments are provided for compatibility with
older versions.
@@ -1102,41 +1102,41 @@
This option specifies the preferred position of the icon window.
It is shorthand for specifying the \*(``\fI*iconGeometry\fP\*('' resource.
.TP 8
-.BI -T " string"
+.BI \-T " string"
This option specifies the title for \fIxterm\fP's windows.
-It is equivalent to \fB-title\fP.
+It is equivalent to \fB\-title\fP.
.TP 8
-.BI -n " string"
+.BI \-n " string"
This option specifies the icon name for \fIxterm\fP's windows.
It is shorthand for specifying the \*(``\fI*iconName\fP\*('' resource.
-Note that this is not the same as the toolkit option \fB-name\fP (see below).
+Note that this is not the same as the toolkit option \fB\-name\fP (see below).
The default icon name is the application name.
.TP 8
-.B -r
+.B \-r
This option indicates that reverse video should be simulated by swapping
the foreground and background colors.
It is equivalent to
-\fB-rv\fP.
+\fB\-rv\fP.
.TP 8
-.BI -w " number"
+.BI \-w " number"
This option specifies the width in pixels of the border surrounding the window.
-It is equivalent to \fB-borderwidth\fP or \fB-bw\fP.
+It is equivalent to \fB\-borderwidth\fP or \fB\-bw\fP.
.
.PP
The following standard X Toolkit command line arguments are commonly used
with \fIxterm\fP:
.TP 8
-.B -bd \fIcolor\fP
+.B \-bd \fIcolor\fP
This option specifies the color to use for the border of the window.
The corresponding resource name is \fIborderColor\fP.
\fIxterm\fP uses the X Toolkit default, which is \*(``XtDefaultForeground\*(''.
.TP 8
-.B -bg \fIcolor\fP
+.B \-bg \fIcolor\fP
This option specifies the color to use for the background of the window.
The corresponding resource name is \fIbackground\fP.
The default is \*(``XtDefaultBackground.\*(''
.TP 8
-.B -bw \fInumber\fP
+.B \-bw \fInumber\fP
This option specifies the width in pixels of the border surrounding the window.
.IP
This appears to be a legacy of older X releases.
@@ -1144,41 +1144,41 @@
and may provide advice to your window manager to set the thickness of the
window frame.
Most window managers do not use this information.
-See the \fB-b\fP option, which controls the inner border of the \fIxterm\fP
+See the \fB\-b\fP option, which controls the inner border of the \fIxterm\fP
window.
.TP 8
-.B -display \fIdisplay\fP
+.B \-display \fIdisplay\fP
This option specifies the X server to contact; see \fIX(__miscmansuffix__)\fP.
.TP 8
-.B -fg \fIcolor\fP
+.B \-fg \fIcolor\fP
This option specifies the color to use for displaying text.
The corresponding resource name is \fIforeground\fP.
The default is
\*(``XtDefaultForeground.\*(''
.TP 8
-.B -fn \fIfont\fP
+.B \-fn \fIfont\fP
This option specifies the font to be used for displaying normal text.
The corresponding resource name is \fIfont\fP.
The resource value default is \fIfixed\fP.
.TP 8
-.B -font \fIfont\fP
-This is the same as \fB-fn\fP.
+.B \-font \fIfont\fP
+This is the same as \fB\-fn\fP.
.TP 8
-.B -geometry \fIgeometry\fP
+.B \-geometry \fIgeometry\fP
This option specifies the preferred size and position of the VT102 window;
see \fIX(__miscmansuffix__)\fP.
.TP 8
-.B -iconic
+.B \-iconic
This option indicates that \fIxterm\fP should ask the window manager to
start it as an icon rather than as the normal window.
The corresponding resource name is \fIiconic\fP.
.TP 8
-.B -name \fIname\fP
+.B \-name \fIname\fP
This option specifies the application name under which resources are to be
obtained, rather than the default executable file name.
\fIName\fP should not contain \*(``.\*('' or \*(``*\*('' characters.
.TP 8
-.B -rv
+.B \-rv
This option indicates that reverse video should be simulated by swapping
the foreground and background colors.
The corresponding resource name is \fIreverseVideo\fP.
@@ -1187,14 +1187,14 @@
Disable the simulation of reverse video by swapping foreground and background
colors.
.TP 8
-.B -title \fIstring\fP
+.B \-title \fIstring\fP
This option specifies the window title string, which may be displayed by
window managers if the user so chooses.
The default title is the command
-line specified after the \fB-e\fP option, if any, otherwise the application
+line specified after the \fB\-e\fP option, if any, otherwise the application
name.
.TP 8
-.B -xrm \fIresourcestring\fP
+.B \-xrm \fIresourcestring\fP
This option specifies a resource string to be used.
This is especially
useful for setting resources that do not have separate command line options.
@@ -1421,7 +1421,7 @@
weras.
Control characters may be specified as ^char (e.g., ^c or ^u)
and \fB^?\fP may be used to indicate delete (127).
-Use \fB^-\fP to denote \fIundef\fP.
+Use \fB^\-\fP to denote \fIundef\fP.
Use \fB\\034\fP to represent \fB^\\\fP, since a literal backslash in
an X resource escapes the next character.
.IP
@@ -1464,11 +1464,11 @@
it passes the terminal size from the display end of the pseudo-terminal
to the terminal I/O connection, e.g., according to the window manager.
Otherwise, it uses the size as given in resource values or command-line
-option \fB-geom\fP.
+option \fB\-geom\fP.
The default is \*(``false.\*(''
.TP 8
.B "zIconBeep (\fPclass\fB ZIconBeep)"
-Same as -ziconbeep command line argument.
+Same as \-ziconbeep command line argument.
If the value of this resource is non-zero, xterms that produce output
while iconified will cause an XBell sound at the given volume
and have "***" prepended to their icon titles.
@@ -2026,7 +2026,7 @@
Specifies whether or not the last column bug in
.IR more (1)
should be worked around.
-See the \fB-cu\fP option for details.
+See the \fB\-cu\fP option for details.
The default is \*(``false.\*(''
.TP 8
.B "cursorBlink (\fPclass\fB CursorBlink)"
@@ -2701,7 +2701,7 @@
.TP
.I false
\fIxterm\fR will use conventional 8bit mode
-or UTF-8 mode according to \fButf8\fR resource or \fB-u8\fP option.
+or UTF-8 mode according to \fButf8\fR resource or \fB\-u8\fP option.
.RE
.IP
Any other value, e.g., \*(``UTF-8\*('' or \*(``ISO8859-2\*('',
@@ -2727,8 +2727,8 @@
.TP 8
.B "localeFilter (\fPclass\fB LocaleFilter)"
Specifies the file name for the encoding converter from/to locale
-encodings and UTF-8 which is used with the \fB-lc\fR option or \fBlocale\fR resource.
-The help message shown by \*(``xterm -help\*('' lists the default value,
+encodings and UTF-8 which is used with the \fB\-lc\fR option or \fBlocale\fR resource.
+The help message shown by \*(``xterm \-help\*('' lists the default value,
which depends on your system configuration.
.IP
If the encoding converter requires command-line parameters,
@@ -2795,7 +2795,7 @@
the escape sequence returned by a cursor-key.
The default is \*(``2\*('':
.IP
-Set it to -1 to disable it.
+Set it to \-1 to disable it.
.br
Set it to 0 to use the old/obsolete behavior.
.br
@@ -2813,7 +2813,7 @@
The default is \*(``2\*(''.
The resource values are similar to \fBmodifyCursorKeys\fP:
.IP
-Set it to -1 to permit the user to use shift- and control-modifiers
+Set it to \-1 to permit the user to use shift- and control-modifiers
to construct function-key strings using the normal encoding scheme.
.br
Set it to 0 to use the old/obsolete behavior.
@@ -3190,6 +3190,12 @@
a character has been used that the font does not represent.
The default is \*(``false.\*(''
.TP 8
+.B "showWrapMarks (\fPclass\fB ShowWrapMarks)"
+For debugging \fIxterm\fP and applications that may manipulate the
+wrapped-line flag by writing text at the right margin,
+show a mark on the right inner-border of the window.
+The mark shows which lines have the flag set.
+.TP 8
.B "signalInhibit (\fPclass\fB SignalInhibit)"
Specifies whether or not the entries in the \*(``Main Options\*('' menu for sending
signals to \fIxterm\fP should be disallowed.
@@ -3313,7 +3319,7 @@
Escape sequences for turning UTF-8 mode on/off are allowed.
.TP
2
-The command-line option \fB-u8\fP sets the resource to this value.
+The command-line option \fB\-u8\fP sets the resource to this value.
Escape sequences for turning UTF-8 mode on/off are ignored.
.TP
3
@@ -3335,7 +3341,7 @@
If true,
allow an ISO-8859-1 \fInormal\fP
font to be combined with an ISO-10646 font if the latter is given
-via the \fB-fw\fP option or its corresponding resource value.
+via the \fB\-fw\fP option or its corresponding resource value.
The default is \*(``false.\*(''
.TP 8
.B "utf8SelectTypes (\fPclass\fB Utf8SelectTypes)"
@@ -3995,7 +4001,7 @@
.TP
Log to File (logging)
Captures text sent to the screen in a logfile,
-as in the \fB-l\fP logging option.
+as in the \fB\-l\fP logging option.
.TP
Print Window (print)
Sends the text of the current window to the program given in the
@@ -4105,7 +4111,7 @@
Enable Scrollbar (scrollbar)
Enable (or disable) the scrollbar.
This corresponds to the
-.B -sb
+.B \-sb
option and the
.B scrollBar
resource.
@@ -4114,7 +4120,7 @@
Enable Jump Scroll (jumpscroll)
Enable (or disable) jump scrolling.
This corresponds to the
-.B -j
+.B \-j
option and the
.B jumpScroll
resource.
@@ -4123,7 +4129,7 @@
Enable Reverse Video (reversevideo)
Enable (or disable) reverse-video.
This corresponds to the
-.B -rv
+.B \-rv
option and the
.B reverseVideo
resource.
@@ -4132,7 +4138,7 @@
Enable Auto Wraparound (autowrap)
Enable (or disable) auto-wraparound.
This corresponds to the
-.B -aw
+.B \-aw
option and the
.B autoWrap
resource.
@@ -4141,7 +4147,7 @@
Enable Reverse Wraparound (reversewrap)
Enable (or disable) reverse wraparound.
This corresponds to the
-.B -rw
+.B \-rw
option and the
.B reverseWrap
resource.
@@ -4173,7 +4179,7 @@
Scroll to Bottom on Key Press (scrollkey)
Enable (or disable) scrolling to the bottom of the scrolling region on a keypress.
This corresponds to the
-.B -sk
+.B \-sk
option and the
.B scrollKey
resource.
@@ -4184,7 +4190,7 @@
Scroll to Bottom on Tty Output (scrollttyoutput)
Enable (or disable) scrolling to the bottom of the scrolling region on output to the terminal.
This corresponds to the
-.B -si
+.B \-si
option and the
.B scrollTtyOutput
resource.
@@ -4193,7 +4199,7 @@
Allow 80/132 Column Switching (allow132)
Enable (or disable) switching between 80 and 132 columns.
This corresponds to the
-.B -132
+.B \-132
option and the
.B c132
resource.
@@ -4224,7 +4230,7 @@
Enable Visual Bell (visualbell)
Enable (or disable) visible bell (i.e., flashing) instead of an audible bell.
This corresponds to the
-.B -vb
+.B \-vb
option and the
.B visualBell
resource.
@@ -4240,7 +4246,7 @@
Enable Pop on Bell (poponbell)
Enable (or disable) raising of the window when Control-G is received.
This corresponds to the
-.B -pop
+.B \-pop
option and the
.B popOnBell
resource.
@@ -4249,7 +4255,7 @@
Enable Blinking Cursor (cursorblink)
Enable (or disable) the blinking-cursor feature.
This corresponds to the
-.B -bc
+.B \-bc
option and the
.B cursorBlink
resource.
@@ -4271,7 +4277,7 @@
Enable Active Icon (activeicon)
Enable (or disable) the active-icon feature.
This corresponds to the
-.B -ai
+.B \-ai
option and the
.B activeIcon
resource.
@@ -4601,7 +4607,7 @@
UTF-8 mode, only the first 256 bytes of this table will be used.
.
.PP
-The default table starts as follows -
+The default table starts as follows \-
.NS
static int charClass[256] = {
/\(** NUL SOH STX ETX EOT ENQ ACK BEL */
@@ -4615,7 +4621,7 @@
/\(** SP ! " # $ % & \*(AQ */
.\" " <- for emacs autocolor to work well :-)
32, 33, 34, 35, 36, 37, 38, 39,
-/\(** ( ) * + , - . / */
+/\(** ( ) * + , \- . / */
40, 41, 42, 43, 44, 45, 46, 47,
/\(** 0 1 2 3 4 5 6 7 */
48, 48, 48, 48, 48, 48, 48, 48,
@@ -4645,11 +4651,11 @@
1, 1, 1, 1, 1, 1, 1, 1,
/\(** x98 x99 x9A CSI ST OSC PM APC */
1, 1, 1, 1, 1, 1, 1, 1,
-/\(** - i c/ L ox Y- | So */
+/\(** \- i c/ L ox Y\- | So */
160, 161, 162, 163, 164, 165, 166, 167,
-/\(** .. c0 ip << _ R0 - */
+/\(** .. c0 ip << _ R0 \- */
168, 169, 170, 171, 172, 173, 174, 175,
-/\(** o +- 2 3 \*(AQ u q| . */
+/\(** o +\- 2 3 \*(AQ u q| . */
176, 177, 178, 179, 180, 181, 182, 183,
/\(** , 1 2 >> 1/4 1/2 3/4 ? */
184, 185, 186, 187, 188, 189, 190, 191,
@@ -4657,7 +4663,7 @@
48, 48, 48, 48, 48, 48, 48, 48,
/\(** E` E\*(AQ E^ E: I` I\*(AQ I^ I: */
48, 48, 48, 48, 48, 48, 48, 48,
-/\(** D- N~ O` O\*(AQ O^ O~ O: X */
+/\(** D\- N~ O` O\*(AQ O^ O~ O: X */
48, 48, 48, 48, 48, 48, 48, 215,
/\(** O/ U` U\*(AQ U^ U: Y\*(AQ P B */
48, 48, 48, 48, 48, 48, 48, 48,
@@ -4665,12 +4671,12 @@
48, 48, 48, 48, 48, 48, 48, 48,
/\(** e` e\*(AQ e^ e: i` i\*(AQ i^ i: */
48, 48, 48, 48, 48, 48, 48, 48,
-/\(** d n~ o` o\*(AQ o^ o~ o: -: */
+/\(** d n~ o` o\*(AQ o^ o~ o: \-: */
48, 48, 48, 48, 48, 48, 48, 247,
/\(** o/ u` u\*(AQ u^ u: y\*(AQ P y: */
48, 48, 48, 48, 48, 48, 48, 48};
.NE
-For example, the string \*(``33:48,37:48,45-47:48,38:48\*('' indicates that the
+For example, the string \*(``33:48,37:48,45\-47:48,38:48\*('' indicates that the
exclamation mark, percent sign, dash, period, slash, and ampersand characters
should be treated the same way as characters and numbers.
This is useful
@@ -4744,7 +4750,7 @@
Consecutive identical expansions are ignored.
The word here is defined as a sequence of non-whitespace characters.
This feature partially emulates the behavior
-of \*(``dynamic abbreviation\*('' expansion in Emacs (bound there to M-/).
+of \*(``dynamic abbreviation\*('' expansion in Emacs (bound there to M\-/).
Here is a resource setting for \fIxterm\fP which will do the same thing:
.NS
*VT100*translations: #override \\n\\\&
@@ -4932,9 +4938,9 @@
indicates the number of \fIunits\fP (which may be \fIpage\fP, \fIhalfpage\fP,
\fIpixel\fP, or \fIline\fP) by which to scroll.
.IP
-An adjustment can be specified for these values by appending a "+" or "-"
+An adjustment can be specified for these values by appending a "+" or "\-"
sign followed by a number,
-e.g., \fIpage-2\fP to specify 2 lines less than a page.
+e.g., \fIpage\-2\fP to specify 2 lines less than a page.
.IP
If the third parameter \fImouse\fP is given, the action is ignored when
mouse reporting is enabled.
@@ -4985,7 +4991,7 @@
.B "send-signal(\fIsigname\fP)"
This action sends the signal named by \fIsigname\fP
to the \fIxterm\fP subprocess (the shell or program specified with
-the \fI-e\fP command line option) and is also invoked by the
+the \fI\-e\fP command line option) and is also invoked by the
.BR suspend ,
.BR continue ,
.BR interrupt ,
@@ -5442,7 +5448,7 @@
it is distinct from \*(``SHELL\*(''.
.TP 5
XTERM_VERSION
-is set to the string displayed by the \fB-version\fP option.
+is set to the string displayed by the \fB\-version\fP option.
That is normally an identifier for the X Window libraries used to
build \fIxterm\fP, followed by
\fIxterm\fP's patch number in parenthesis.
@@ -5491,11 +5497,11 @@
.I __apploaddir__/XTerm
the \fIxterm\fP default application resources.
.TP 5
-.I __apploaddir__/XTerm-color
+.I __apploaddir__/XTerm\-color
the \fIxterm\fP color application resources.
If your display supports color, use this
.in +10
-*customization: -color
+*customization: \-color
.in -10
in your .Xdefaults file to
automatically use this resource file rather than
