1 | .if !\n(.g .ab GNU tbl requires GNU troff. |
1 | .if !\n(.g .ab GNU tbl requires GNU troff. |
2 | .if !dTS .ds TS |
2 | .if !dTS .ds TS |
3 | .if !dTE .ds TE |
3 | .if !dTE .ds TE |
4 | .TH "RXVT" "1" "2004-03-14" "X Version 11" "X Tools" |
4 | .TH "RXVT" "1" "2004-04-02" "X Version 11" "X Tools" |
5 | .SH "NAME" |
5 | .SH "NAME" |
6 | rxvt-unicode (ouR XVT, unicode) \- a VT102 emulator for the X window system |
6 | rxvt-unicode (ouR XVT, unicode) \- a VT102 emulator for the X window system |
7 | .PP |
7 | .PP |
8 | .SH "SYNOPSIS" |
8 | .SH "SYNOPSIS" |
9 | .PP |
9 | .PP |
10 | \fBrxvt\fP [options] [-e command [ args ]] |
10 | \fBrxvt\fP [options] [-e command [ args ]] |
11 | .PP |
11 | .PP |
12 | .SH "DESCRIPTION" |
12 | .SH "DESCRIPTION" |
13 | .PP |
13 | .PP |
14 | \fBrxvt-unicode\fP, version \fB2\&.4\fP, is a colour vt102 terminal emulator |
14 | \fBrxvt-unicode\fP, version \fB2\&.6\fP, is a colour vt102 terminal emulator |
15 | intended as an \fIxterm\fP(1) replacement for users who do not require |
15 | intended as an \fIxterm\fP(1) replacement for users who do not require |
16 | features such as Tektronix 4014 emulation and toolkit-style configurability\&. |
16 | features such as Tektronix 4014 emulation and toolkit-style configurability\&. |
17 | As a result, \fBrxvt-unicode\fP uses much less swap space -- a significant |
17 | As a result, \fBrxvt-unicode\fP uses much less swap space -- a significant |
18 | advantage on a machine serving many X sessions\&. |
18 | advantage on a machine serving many X sessions\&. |
19 | .PP |
19 | .PP |
… | |
… | |
54 | resource \fBjumpScroll\fP\&. |
54 | resource \fBjumpScroll\fP\&. |
55 | .IP "\fB-ip\fP|\fB+ip\fP" |
55 | .IP "\fB-ip\fP|\fB+ip\fP" |
56 | Turn on/off inheriting parent window\&'s pixmap\&. Alternative form |
56 | Turn on/off inheriting parent window\&'s pixmap\&. Alternative form |
57 | is \fB-tr\fP; |
57 | is \fB-tr\fP; |
58 | resource \fBinheritPixmap\fP\&. |
58 | resource \fBinheritPixmap\fP\&. |
|
|
59 | .IP "\fB-tint\fP \fIcolour\fP" |
|
|
60 | Tint the transparent background pixmap with the given colour\&. |
59 | .IP "\fB-bg\fP \fIcolour\fP" |
61 | .IP "\fB-bg\fP \fIcolour\fP" |
60 | Window background colour; |
62 | Window background colour; |
61 | resource \fBbackground\fP\&. |
63 | resource \fBbackground\fP\&. |
62 | .IP "\fB-fg\fP \fIcolour\fP" |
64 | .IP "\fB-fg\fP \fIcolour\fP" |
63 | Window foreground colour; |
65 | Window foreground colour; |
… | |
… | |
79 | resource \fBborderColor\fP\&. |
81 | resource \fBborderColor\fP\&. |
80 | .IP "\fB-fn\fP \fIfontname\fP" |
82 | .IP "\fB-fn\fP \fIfontname\fP" |
81 | Select the fonts to be used used\&. This is a comma seperated |
83 | Select the fonts to be used used\&. This is a comma seperated |
82 | list of font names that are used in turn when trying to display |
84 | list of font names that are used in turn when trying to display |
83 | unicode characters\&. The first font defines the cell size for characters, |
85 | unicode characters\&. The first font defines the cell size for characters, |
84 | pther fonts might be smaller, but not larger\&. A reasonable default list |
86 | other fonts might be smaller, but not larger\&. A reasonable default font list |
85 | is appended\&. |
87 | is always appended to it\&. |
86 | resource \fBfont\fP\&. |
88 | resource \fBfont\fP\&. |
87 | .IP "\fB-name\fP \fIname\fP" |
89 | .IP "\fB-name\fP \fIname\fP" |
88 | Specify the application name under which resources |
90 | Specify the application name under which resources |
89 | are to be obtained, rather than the default executable file name\&. |
91 | are to be obtained, rather than the default executable file name\&. |
90 | Name should not contain `\&.\&' or `*\&' characters\&. |
92 | Name should not contain `\&.\&' or `*\&' characters\&. |
… | |
… | |
172 | .IP "\fB-imlocale\fP \fIstring\fP" |
174 | .IP "\fB-imlocale\fP \fIstring\fP" |
173 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
175 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
174 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
176 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
175 | for the input extension to be able to input japanese characters |
177 | for the input extension to be able to input japanese characters |
176 | while staying in another locale\&. |
178 | while staying in another locale\&. |
|
|
179 | .IP "\fB-insecure\fP" |
|
|
180 | Enable "insecure" mode, which currently enables most of the escape |
|
|
181 | sequences that echo strings\&. See the resource \fBinsecure\fP for |
|
|
182 | more info\&. |
177 | .IP "\fB-mod\fP \fImodifier\fP" |
183 | .IP "\fB-mod\fP \fImodifier\fP" |
178 | Override detection of Meta modifier with specified key: |
184 | Override detection of Meta modifier with specified key: |
179 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
185 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
180 | \fBmod4\fP, \fBmod5\fP; |
186 | \fBmod4\fP, \fBmod5\fP; |
181 | resource \fImodifier\fP\&. |
187 | resource \fImodifier\fP\&. |
|
|
188 | .IP "\fB-ssc\fP|\fB+ssc\fP" |
|
|
189 | Turn on/off secondary screen (default enabled); |
|
|
190 | resource \fBsecondaryScreen\fP\&. |
|
|
191 | .IP "\fB-ssr\fP|\fB+ssr\fP" |
|
|
192 | Turn on/off secondary screen scroll (default enabled); |
|
|
193 | resource \fBsecondaryScroll\fP\&. |
182 | .IP "\fB-xrm\fP \fIresourcestring\fP" |
194 | .IP "\fB-xrm\fP \fIresourcestring\fP" |
183 | No effect on rxvt\&. Simply passes through an argument to be made |
195 | No effect on rxvt\&. Simply passes through an argument to be made |
184 | available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP |
196 | available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP |
185 | in some window managers\&. |
197 | in some window managers\&. |
186 | .SH "RESOURCES (available also as long-options)" |
198 | .SH "RESOURCES (available also as long-options)" |
… | |
… | |
252 | option \fB+j\fP\&. |
264 | option \fB+j\fP\&. |
253 | .IP "\fBinheritPixmap:\fP \fIboolean\fP" |
265 | .IP "\fBinheritPixmap:\fP \fIboolean\fP" |
254 | \fBTrue\fP: make the background inherit the parent windows\&' pixmap, |
266 | \fBTrue\fP: make the background inherit the parent windows\&' pixmap, |
255 | giving artificial transparency\&. |
267 | giving artificial transparency\&. |
256 | \fBFalse\fP: do not inherit the parent windows\&' pixmap\&. |
268 | \fBFalse\fP: do not inherit the parent windows\&' pixmap\&. |
|
|
269 | .IP "\fBtintColor\fP \fIcolour\fP" |
|
|
270 | Tint the transparent background pixmap with the given colour\&. |
257 | .IP "\fBscrollColor:\fP \fIcolour\fP" |
271 | .IP "\fBscrollColor:\fP \fIcolour\fP" |
258 | Use the specified colour for the scrollbar [default #B2B2B2]\&. |
272 | Use the specified colour for the scrollbar [default #B2B2B2]\&. |
259 | .IP "\fBtroughColor:\fP \fIcolour\fP" |
273 | .IP "\fBtroughColor:\fP \fIcolour\fP" |
260 | Use the specified colour for the scrollbar\&'s trough area [default |
274 | Use the specified colour for the scrollbar\&'s trough area [default |
261 | #969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. |
275 | #969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. |
… | |
… | |
279 | \fBPATH\fP environment variables\&. |
293 | \fBPATH\fP environment variables\&. |
280 | .IP "\fBfont:\fP \fIfontname\fP" |
294 | .IP "\fBfont:\fP \fIfontname\fP" |
281 | Select the fonts to be used used\&. This is a comma seperated |
295 | Select the fonts to be used used\&. This is a comma seperated |
282 | list of font names that are used in turn when trying to display |
296 | list of font names that are used in turn when trying to display |
283 | unicode characters\&. The first font defines the cell size for characters, |
297 | unicode characters\&. The first font defines the cell size for characters, |
284 | pther fonts might be smaller, but not larger\&. A reasonable default list |
298 | other fonts might be smaller, but not larger\&. A reasonable default font list |
285 | is appended\&. |
299 | is always appended to this list\&. |
286 | option \fB-fn\fP\&. |
300 | option \fB-fn\fP\&. |
287 | .IP "\fBselectstyle:\fP \fImode\fP" |
301 | .IP "\fBselectstyle:\fP \fImode\fP" |
288 | Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which |
302 | Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which |
289 | is xterm style with 2\&.20 old word selection, or anything else which |
303 | is xterm style with 2\&.20 old word selection, or anything else which |
290 | gives xterm style selection\&. |
304 | gives xterm style selection\&. |
… | |
… | |
426 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
440 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
427 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
441 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
428 | for the input extension to be able to input japanese characters |
442 | for the input extension to be able to input japanese characters |
429 | while staying in another locale\&. |
443 | while staying in another locale\&. |
430 | option \fB-imlocale\fP\&. |
444 | option \fB-imlocale\fP\&. |
|
|
445 | .IP "\fBinsecure\fP" |
|
|
446 | Enables "insecure" mode\&. Rxvt-unicode offers some escape sequences |
|
|
447 | that echo arbitrary strings like the icon name or the locale\&. This |
|
|
448 | could be abused if somebody gets 8-bit-clean access to your |
|
|
449 | display, wether throuh a mail client displaying mail bodies |
|
|
450 | unfiltered or though write(1)\&. Therefore, these sequences are |
|
|
451 | disabled by default\&. (Note that other terminals, including xterm, |
|
|
452 | have these sequences enabled by default)\&. You can enable them |
|
|
453 | by setting this boolean resource or specifying \fB-insecure\fP as |
|
|
454 | an option\&. At the moment, this enabled display-answer, locale, |
|
|
455 | findfont, icon label and window title requests as well as dynamic |
|
|
456 | menubar dispatch\&. |
431 | .IP "\fBmodifier:\fP \fImodifier\fP" |
457 | .IP "\fBmodifier:\fP \fImodifier\fP" |
432 | Set the key to be interpreted as the Meta key to: |
458 | Set the key to be interpreted as the Meta key to: |
433 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
459 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
434 | \fBmod4\fP, \fBmod5\fP; |
460 | \fBmod4\fP, \fBmod5\fP; |
435 | option \fB-mod\fP\&. |
461 | option \fB-mod\fP\&. |
436 | .IP "\fBanswerbackString:\fP \fIstring\fP" |
462 | .IP "\fBanswerbackString:\fP \fIstring\fP" |
437 | Specify the reply rxvt sends to the shell when an ENQ (control-E) |
463 | Specify the reply rxvt sends to the shell when an ENQ (control-E) |
438 | character is passed through\&. It may contain escape values as |
464 | character is passed through\&. It may contain escape values as |
439 | described in the entry on \fBkeysym\fP following\&. |
465 | described in the entry on \fBkeysym\fP following\&. |
|
|
466 | .IP "\fBsecondaryScreen:\fP \fIbool\fP" |
|
|
467 | Turn on/off secondary screen (default enabled)\&. |
|
|
468 | .IP "\fBsecondaryScroll:\fP \fIbool\fP" |
|
|
469 | Turn on/off secondary screen scroll (default enabled)\&. If |
|
|
470 | the this option is enabled, scrolls on the secondary screen will |
|
|
471 | change the scrollback buffer and switching to/from the secondary screen |
|
|
472 | will instead scroll the screen up\&. |
440 | .IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP" |
473 | .IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP" |
441 | Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It |
474 | Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It |
442 | may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, |
475 | may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, |
443 | \en: newline, \er: return, \et: tab, \e000: octal number) or control |
476 | \en: newline, \er: return, \et: tab, \e000: octal number) or control |
444 | characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with |
477 | characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with |
… | |
… | |
1015 | .PP |
1048 | .PP |
1016 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
1049 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
1017 | .PP |
1050 | .PP |
1018 | .SH "FTP LOCATION" |
1051 | .SH "FTP LOCATION" |
1019 | .PP |
1052 | .PP |
1020 | rxvt-2\&.4\&.tar\&.gz can be found at the following ftp sites |
1053 | rxvt-2\&.6\&.tar\&.gz can be found at the following ftp sites |
1021 | ftp://ftp\&.rxvt\&.org/pub/rxvt |
1054 | ftp://ftp\&.rxvt\&.org/pub/rxvt |
1022 | .PP |
1055 | .PP |
1023 | .SH "CURRENT PROJECT COORDINATOR" |
1056 | .SH "CURRENT PROJECT COORDINATOR" |
1024 | .PP |
1057 | .PP |
1025 | .IP "Project Coordinator" |
1058 | .IP "Project Coordinator" |