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