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" "RXVTDATE()" "X Version 11" "X Tools" |
4 | .TH "RXVT" "1" "2004-03-28" "X Version 11" "X Tools" |
5 | .SH "NAME" |
5 | .SH "NAME" |
6 | rxvt (ouR XVT) \- 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\fP, version \fBRXVTVERSION()\fP, is a colour vt102 terminal emulator |
14 | \fBrxvt-unicode\fP, version \fB2\&.5\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\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 |
20 | .PP |
20 | .PP |
21 | .SH "OPTIONS" |
21 | .SH "OPTIONS" |
22 | .PP |
22 | .PP |
… | |
… | |
79 | resource \fBborderColor\fP\&. |
79 | resource \fBborderColor\fP\&. |
80 | .IP "\fB-fn\fP \fIfontname\fP" |
80 | .IP "\fB-fn\fP \fIfontname\fP" |
81 | Select the fonts to be used used\&. This is a comma seperated |
81 | 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 |
82 | 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, |
83 | unicode characters\&. The first font defines the cell size for characters, |
84 | pther fonts might be smaller, but not larger\&. A reasonable default list |
84 | other fonts might be smaller, but not larger\&. A reasonable default font list |
85 | is appended\&. |
85 | is always appended to it\&. |
86 | resource \fBfont\fP\&. |
86 | resource \fBfont\fP\&. |
87 | .IP "\fB-name\fP \fIname\fP" |
87 | .IP "\fB-name\fP \fIname\fP" |
88 | Specify the application name under which resources |
88 | Specify the application name under which resources |
89 | are to be obtained, rather than the default executable file name\&. |
89 | are to be obtained, rather than the default executable file name\&. |
90 | Name should not contain `\&.\&' or `*\&' characters\&. |
90 | Name should not contain `\&.\&' or `*\&' characters\&. |
… | |
… | |
115 | Put scrollbar on right/left; |
115 | Put scrollbar on right/left; |
116 | resource \fBscrollBar_right\fP\&. |
116 | resource \fBscrollBar_right\fP\&. |
117 | .IP "\fB-st\fP|\fB+st\fP" |
117 | .IP "\fB-st\fP|\fB+st\fP" |
118 | Display normal (non XTerm/NeXT) scrollbar without/with a trough; |
118 | Display normal (non XTerm/NeXT) scrollbar without/with a trough; |
119 | resource \fBscrollBar_floating\fP\&. |
119 | resource \fBscrollBar_floating\fP\&. |
120 | .IP "\fB-mcc\fP|\fB+mcc\fP" |
|
|
121 | Compile \fImultichar_languages\fP: treat multibyte glyphs as single |
|
|
122 | character for backspace, delete and cursor movement keys; |
|
|
123 | resource \fBmultibyte_cursor\fP\&. |
|
|
124 | .IP "\fB-bc\fP|\fB+bc\fP" |
120 | .IP "\fB-bc\fP|\fB+bc\fP" |
125 | Blink the cursor; resource \fBcursorBlink\fP\&. |
121 | Blink the cursor; resource \fBcursorBlink\fP\&. |
126 | .IP "\fB-iconic\fP" |
122 | .IP "\fB-iconic\fP" |
127 | Start iconified, if the window manager supports that option\&. |
123 | Start iconified, if the window manager supports that option\&. |
128 | Alternative form is \fB-ic\fP\&. |
124 | Alternative form is \fB-ic\fP\&. |
… | |
… | |
176 | .IP "\fB-imlocale\fP \fIstring\fP" |
172 | .IP "\fB-imlocale\fP \fIstring\fP" |
177 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
173 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
178 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
174 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
179 | for the input extension to be able to input japanese characters |
175 | for the input extension to be able to input japanese characters |
180 | while staying in another locale\&. |
176 | while staying in another locale\&. |
|
|
177 | .IP "\fB-insecure\fP" |
|
|
178 | Enable "insecure" mode, which currently enables most of the escape |
|
|
179 | sequences that echo strings\&. See the resource \fBinsecure\fP for |
|
|
180 | more info\&. |
181 | .IP "\fB-mod\fP \fImodifier\fP" |
181 | .IP "\fB-mod\fP \fImodifier\fP" |
182 | Override detection of Meta modifier with specified key: |
182 | Override detection of Meta modifier with specified key: |
183 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
183 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
184 | \fBmod4\fP, \fBmod5\fP; |
184 | \fBmod4\fP, \fBmod5\fP; |
185 | resource \fImodifier\fP\&. |
185 | resource \fImodifier\fP\&. |
… | |
… | |
283 | \fBPATH\fP environment variables\&. |
283 | \fBPATH\fP environment variables\&. |
284 | .IP "\fBfont:\fP \fIfontname\fP" |
284 | .IP "\fBfont:\fP \fIfontname\fP" |
285 | Select the fonts to be used used\&. This is a comma seperated |
285 | Select the fonts to be used used\&. This is a comma seperated |
286 | list of font names that are used in turn when trying to display |
286 | list of font names that are used in turn when trying to display |
287 | unicode characters\&. The first font defines the cell size for characters, |
287 | unicode characters\&. The first font defines the cell size for characters, |
288 | pther fonts might be smaller, but not larger\&. A reasonable default list |
288 | other fonts might be smaller, but not larger\&. A reasonable default font list |
289 | is appended\&. |
289 | is always appended to this list\&. |
290 | option \fB-fn\fP\&. |
290 | option \fB-fn\fP\&. |
291 | .IP "\fBselectstyle:\fP \fImode\fP" |
291 | .IP "\fBselectstyle:\fP \fImode\fP" |
292 | Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which |
292 | Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which |
293 | is xterm style with 2\&.20 old word selection, or anything else which |
293 | is xterm style with 2\&.20 old word selection, or anything else which |
294 | gives xterm style selection\&. |
294 | gives xterm style selection\&. |
… | |
… | |
404 | \fBTrue\fP: blank the pointer when a key is pressed or after a set number |
404 | \fBTrue\fP: blank the pointer when a key is pressed or after a set number |
405 | of seconds of inactivity\&. |
405 | of seconds of inactivity\&. |
406 | \fBFalse\fP: the pointer is always visible [default]\&. |
406 | \fBFalse\fP: the pointer is always visible [default]\&. |
407 | .IP "\fBpointerBlankDelay:\fP \fInumber\fP" |
407 | .IP "\fBpointerBlankDelay:\fP \fInumber\fP" |
408 | Specifies number of seconds before blanking the pointer [default 2]\&. |
408 | Specifies number of seconds before blanking the pointer [default 2]\&. |
409 | .IP "\fBmultibyte_cursor:\fP \fIboolean\fP" |
|
|
410 | \fBTrue\fP: consider multibyte glyphs as single character for backspace, |
|
|
411 | delete and cursor movement keys; |
|
|
412 | option \fB-mcc\fP\&. |
|
|
413 | \fBFalse\fP: move through all components of all glyphs; |
|
|
414 | option \fB+mcc\fP\&. |
|
|
415 | .IP "\fBbackspacekey:\fP \fIstring\fP" |
409 | .IP "\fBbackspacekey:\fP \fIstring\fP" |
416 | The string to send when the backspace key is pressed\&. If set to |
410 | The string to send when the backspace key is pressed\&. If set to |
417 | \fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted, |
411 | \fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted, |
418 | \fBBackspace\fP (code 8) - which can be reversed with the appropriate |
412 | \fBBackspace\fP (code 8) - which can be reversed with the appropriate |
419 | DEC private mode escape sequence\&. |
413 | DEC private mode escape sequence\&. |
… | |
… | |
436 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
430 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
437 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
431 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
438 | for the input extension to be able to input japanese characters |
432 | for the input extension to be able to input japanese characters |
439 | while staying in another locale\&. |
433 | while staying in another locale\&. |
440 | option \fB-imlocale\fP\&. |
434 | option \fB-imlocale\fP\&. |
|
|
435 | .IP "\fBinsecure\fP" |
|
|
436 | Enables "insecure" mode\&. Rxvt-unicode offers some escape sequences |
|
|
437 | that echo arbitrary strings like the icon name or the locale\&. This |
|
|
438 | could be abused if somebody gets 8-bit-clean access to your display, |
|
|
439 | wether throuh a mail client displaying mail bodies unfiltered or |
|
|
440 | though write(1)\&. Therefore, these sequences are disabled by default\&. |
|
|
441 | You can enable them by setting this boolean resource or specifying |
|
|
442 | \fB-insecure\fP as an option\&. At the moment, this enabled display-answer, |
|
|
443 | locale, findfont, icon label and window title requests as well as |
|
|
444 | dynamic menubar dispatch\&. |
441 | .IP "\fBmodifier:\fP \fImodifier\fP" |
445 | .IP "\fBmodifier:\fP \fImodifier\fP" |
442 | Set the key to be interpreted as the Meta key to: |
446 | Set the key to be interpreted as the Meta key to: |
443 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
447 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
444 | \fBmod4\fP, \fBmod5\fP; |
448 | \fBmod4\fP, \fBmod5\fP; |
445 | option \fB-mod\fP\&. |
449 | option \fB-mod\fP\&. |
… | |
… | |
1025 | .PP |
1029 | .PP |
1026 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
1030 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
1027 | .PP |
1031 | .PP |
1028 | .SH "FTP LOCATION" |
1032 | .SH "FTP LOCATION" |
1029 | .PP |
1033 | .PP |
1030 | rxvt-+RXVTVERSION()\&.tar\&.gz can be found at the following ftp sites |
1034 | rxvt-2\&.5\&.tar\&.gz can be found at the following ftp sites |
1031 | RXVTFTPSITE() |
1035 | ftp://ftp\&.rxvt\&.org/pub/rxvt |
1032 | .PP |
1036 | .PP |
1033 | .SH "CURRENT PROJECT COORDINATOR" |
1037 | .SH "CURRENT PROJECT COORDINATOR" |
1034 | .PP |
1038 | .PP |
1035 | .IP "Project Coordinator" |
1039 | .IP "Project Coordinator" |
1036 | RXVTMAINT() RXVTMAINTEMAIL() |
1040 | Marc A\&. Lehmann <rxvt@schmorp\&.de> |
1037 | .br |
1041 | .br |
1038 | .IP "Web page maintainter" |
1042 | .IP "Web page maintainter" |
1039 | RXVTWEBMAINT() RXVTWEBMAINTEMAIL() |
1043 | Marc A\&. Lehmann <rxvt@schmorp\&.de> |
1040 | .br |
1044 | .br |
1041 | RXVTWEBPAGE() |
1045 | <http://www\&.sourceforge\&.net/projects/rxvt-unicode/> |
1042 | .br |
1046 | .br |
1043 | .IP "Mailing list" |
|
|
1044 | The Rxvt Workers <rxvt-workers@rxvt\&.org> |
|
|
1045 | mailing list has also been established for rxvt development, to |
|
|
1046 | subscribe, email to |
|
|
1047 | <rxvt-workers-subscribe@rxvt\&.org>\&. |
|
|
1048 | There is also a mailing list for announcements of new releases of |
|
|
1049 | rxvt\&. To subscribe, email to |
|
|
1050 | <rxvt-announce-subscribe@rxvt\&.org>\&. |
|
|
1051 | .PP |
1047 | .PP |
1052 | .SH "AUTHORS" |
1048 | .SH "AUTHORS" |
1053 | .PP |
1049 | .PP |
1054 | .IP "John Bovey" |
1050 | .IP "John Bovey" |
1055 | University of Kent, 1992, wrote the original Xvt\&. |
1051 | University of Kent, 1992, wrote the original Xvt\&. |