| … | |
… | |
| 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 | \fBurxvt\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\&.6\fP, is a colour vt102 terminal emulator |
14 | \fBrxvt-unicode\fP, version \fB2\&.7\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 |
| 20 | .PP |
20 | .PP |
| 21 | .SH "OPTIONS" |
21 | .SH "OPTIONS" |
| 22 | .PP |
22 | .PP |
| 23 | The \fBrxvt\fP options (mostly a subset of \fIxterm\fP\&'s) are listed below\&. |
23 | The \fBurxvt\fP options (mostly a subset of \fIxterm\fP\&'s) are listed below\&. |
| 24 | In keeping with the smaller-is-better philosophy, options may be eliminated |
24 | In keeping with the smaller-is-better philosophy, options may be eliminated |
| 25 | or default values chosen at compile-time, so options and defaults listed |
25 | or default values chosen at compile-time, so options and defaults listed |
| 26 | may not accurately reflect the version installed on your system\&. |
26 | may not accurately reflect the version installed on your system\&. |
| 27 | `rxvt -h\&' gives a list of major compile-time options on the \fIOptions\fP line\&. |
27 | `rxvt -h\&' gives a list of major compile-time options on the \fIOptions\fP line\&. |
| 28 | Option descriptions may be prefixed with which compile option each is |
28 | Option descriptions may be prefixed with which compile option each is |
| 29 | dependent upon\&. e\&.g\&. `Compile \fIXIM\fP:\&' requires \fIXIM\fP on the \fIOptions\fP |
29 | dependent upon\&. e\&.g\&. `Compile \fIXIM\fP:\&' requires \fIXIM\fP on the \fIOptions\fP |
| 30 | line\&. Note: `rxvt -help\&' gives a list of all command-line options compiled |
30 | line\&. Note: `rxvt -help\&' gives a list of all command-line options compiled |
| 31 | into your version\&. |
31 | into your version\&. |
| 32 | .PP |
32 | .PP |
| 33 | Note that \fBrxvt\fP permits the resource name to be used as a long-option |
33 | Note that \fBurxvt\fP permits the resource name to be used as a long-option |
| 34 | (--/++ option) so the potential command-line options are far greater than |
34 | (--/++ option) so the potential command-line options are far greater than |
| 35 | those listed\&. |
35 | those listed\&. |
| 36 | For example: `rxvt --loginShell --color1 Orange\&'\&. |
36 | For example: `rxvt --loginShell --color1 Orange\&'\&. |
| 37 | .PP |
37 | .PP |
| 38 | The following options are available: |
38 | The following options are available: |
| … | |
… | |
| 144 | This option specifies the name of the terminal type to be set in the |
144 | This option specifies the name of the terminal type to be set in the |
| 145 | \fBTERM\fP environment variable\&. This terminal type must exist in the |
145 | \fBTERM\fP environment variable\&. This terminal type must exist in the |
| 146 | \fItermcap(5)\fP database and should have \fIli#\fP and \fIco#\fP entries; |
146 | \fItermcap(5)\fP database and should have \fIli#\fP and \fIco#\fP entries; |
| 147 | resource \fBtermName\fP\&. |
147 | resource \fBtermName\fP\&. |
| 148 | .IP "\fB-e\fP \fIcommand [arguments]\fP" |
148 | .IP "\fB-e\fP \fIcommand [arguments]\fP" |
| 149 | Run the command with its command-line arguments in the \fBrxvt\fP |
149 | Run the command with its command-line arguments in the \fBurxvt\fP |
| 150 | window; also sets the window title and icon name to be the basename |
150 | window; also sets the window title and icon name to be the basename |
| 151 | of the program being executed if neither \fI-title\fP (\fI-T\fP) nor |
151 | of the program being executed if neither \fI-title\fP (\fI-T\fP) nor |
| 152 | \fI-n\fP are given on the command line\&. If this option is used, it |
152 | \fI-n\fP are given on the command line\&. If this option is used, it |
| 153 | must be the last on the command-line\&. If there is no \fB-e\fP option |
153 | must be the last on the command-line\&. If there is no \fB-e\fP option |
| 154 | then the default is to run the program specified by the \fBSHELL\fP |
154 | then the default is to run the program specified by the \fBSHELL\fP |
| … | |
… | |
| 198 | .SH "RESOURCES (available also as long-options)" |
198 | .SH "RESOURCES (available also as long-options)" |
| 199 | .PP |
199 | .PP |
| 200 | Note: `rxvt --help\&' gives a list of all resources (long options) compiled |
200 | Note: `rxvt --help\&' gives a list of all resources (long options) compiled |
| 201 | into your version\&. |
201 | into your version\&. |
| 202 | If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists |
202 | If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists |
| 203 | \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application defaults set in |
203 | \fB\&.Xdefaults\fP) then \fBurxvt\fP accepts application defaults set in |
| 204 | XAPPLOADDIR/Rxvt (compile-time defined: usually |
204 | XAPPLOADDIR/Rxvt (compile-time defined: usually |
| 205 | \fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP, |
205 | \fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP, |
| 206 | or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when |
206 | or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when |
| 207 | reading X resources, \fBrxvt\fP recognizes two class names: \fBXTerm\fP and |
207 | reading X resources, \fBurxvt\fP recognizes two class names: \fBXTerm\fP and |
| 208 | \fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both |
208 | \fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both |
| 209 | \fBrxvt\fP and \fIxterm\fP to be easily configured, while the class name |
209 | \fBurxvt\fP and \fIxterm\fP to be easily configured, while the class name |
| 210 | \fBRxvt\fP allows resources unique to \fBrxvt\fP, notably colours and |
210 | \fBRxvt\fP allows resources unique to \fBurxvt\fP, notably colours and |
| 211 | key-handling, to be shared between different \fBrxvt\fP configurations\&. |
211 | key-handling, to be shared between different \fBurxvt\fP configurations\&. |
| 212 | If no resources are specified, suitable defaults will be used\&. |
212 | If no resources are specified, suitable defaults will be used\&. |
| 213 | Command-line arguments can be used to override resource settings\&. The |
213 | Command-line arguments can be used to override resource settings\&. The |
| 214 | following resources are allowed: |
214 | following resources are allowed: |
| 215 | .PP |
215 | .PP |
| 216 | .IP "\fBgeometry:\fP \fIgeom\fP" |
216 | .IP "\fBgeometry:\fP \fIgeom\fP" |
| … | |
… | |
| 301 | .IP "\fBselectstyle:\fP \fImode\fP" |
301 | .IP "\fBselectstyle:\fP \fImode\fP" |
| 302 | 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 |
| 303 | 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 |
| 304 | gives xterm style selection\&. |
304 | gives xterm style selection\&. |
| 305 | .IP "\fBscrollstyle:\fP \fImode\fP" |
305 | .IP "\fBscrollstyle:\fP \fImode\fP" |
| 306 | Set scrollbar style to \fBrxvt\fP, \fBnext\fP or \fBxterm\fP |
306 | Set scrollbar style to \fBurxvt\fP, \fBnext\fP or \fBxterm\fP |
| 307 | .IP "\fBtitle:\fP \fIstring\fP" |
307 | .IP "\fBtitle:\fP \fIstring\fP" |
| 308 | Set window title string, the default title is the command-line |
308 | Set window title string, the default title is the command-line |
| 309 | specified after the \fB-e\fP option, if any, otherwise the application |
309 | specified after the \fB-e\fP option, if any, otherwise the application |
| 310 | name; |
310 | name; |
| 311 | option \fB-title\fP\&. |
311 | option \fB-title\fP\&. |
| … | |
… | |
| 478 | double quotes so that it can start or end with whitespace\&. The |
478 | double quotes so that it can start or end with whitespace\&. The |
| 479 | intervening resource name \fBkeysym\&.\fP cannot be omitted\&. This |
479 | intervening resource name \fBkeysym\&.\fP cannot be omitted\&. This |
| 480 | resource is only available when compiled with KEYSYM_RESOURCE\&. |
480 | resource is only available when compiled with KEYSYM_RESOURCE\&. |
| 481 | .SH "THE SCROLLBAR" |
481 | .SH "THE SCROLLBAR" |
| 482 | .PP |
482 | .PP |
| 483 | Lines of text that scroll off the top of the \fBrxvt\fP window (resource: |
483 | Lines of text that scroll off the top of the \fBurxvt\fP window (resource: |
| 484 | \fBsaveLines\fP) and can be scrolled back using the scrollbar or by keystrokes\&. |
484 | \fBsaveLines\fP) and can be scrolled back using the scrollbar or by keystrokes\&. |
| 485 | The normal \fBrxvt\fP scrollbar has arrows and its behaviour is fairly |
485 | The normal \fBurxvt\fP scrollbar has arrows and its behaviour is fairly |
| 486 | intuitive\&. The \fBxterm-scrollbar\fP is without arrows and its behaviour |
486 | intuitive\&. The \fBxterm-scrollbar\fP is without arrows and its behaviour |
| 487 | mimics that of \fIxterm\fP |
487 | mimics that of \fIxterm\fP |
| 488 | .PP |
488 | .PP |
| 489 | Scroll down with \fBButton1\fP (\fBxterm-scrollbar\fP) or \fBShift-Next\fP\&. |
489 | Scroll down with \fBButton1\fP (\fBxterm-scrollbar\fP) or \fBShift-Next\fP\&. |
| 490 | Scroll up with \fBButton3\fP (\fBxterm-scrollbar\fP) or \fBShift-Prior\fP\&. |
490 | Scroll up with \fBButton3\fP (\fBxterm-scrollbar\fP) or \fBShift-Prior\fP\&. |
| … | |
… | |
| 511 | region and release; Right click to extend the marked region; |
511 | region and release; Right click to extend the marked region; |
| 512 | Left double-click to select a word; Left triple-click to select |
512 | Left double-click to select a word; Left triple-click to select |
| 513 | the entire line\&. |
513 | the entire line\&. |
| 514 | .IP "\fBInsertion\fP:" |
514 | .IP "\fBInsertion\fP:" |
| 515 | Pressing and releasing the Middle mouse button (or \fBShift-Insert\fP) |
515 | Pressing and releasing the Middle mouse button (or \fBShift-Insert\fP) |
| 516 | in an \fBrxvt\fP window causes the current text selection to be inserted |
516 | in an \fBurxvt\fP window causes the current text selection to be inserted |
| 517 | as if it had been typed on the keyboard\&. |
517 | as if it had been typed on the keyboard\&. |
| 518 | .SH "CHANGING FONTS" |
518 | .SH "CHANGING FONTS" |
| 519 | .PP |
519 | .PP |
| 520 | You can change fonts on-the-fly, which is to say cycle through the default |
520 | You can change fonts on-the-fly, which is to say cycle through the default |
| 521 | font and others of various sizes, by using \fBShift-KP_Add\fP and |
521 | font and others of various sizes, by using \fBShift-KP_Add\fP and |
| 522 | \fBShift-KP_Subtract\fP\&. Or, alternatively (if enabled) with |
522 | \fBShift-KP_Subtract\fP\&. Or, alternatively (if enabled) with |
| 523 | \fBAlt->\fP and \fBAlt-<\fP, where the actual key |
523 | \fBAlt->\fP and \fBAlt-<\fP, where the actual key |
| 524 | can be selected using resources \fBsmallfont_key\fP/\fBbigfont_key\fP\&. |
524 | can be selected using resources \fBsmallfont_key\fP/\fBbigfont_key\fP\&. |
| 525 | .SH "LOGIN STAMP" |
525 | .SH "LOGIN STAMP" |
| 526 | .PP |
526 | .PP |
| 527 | \fBrxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be |
527 | \fBurxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be |
| 528 | seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this |
528 | seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this |
| 529 | feature, \fBrxvt\fP must be installed setuid root on some systems\&. |
529 | feature, \fBurxvt\fP must be installed setuid root on some systems\&. |
| 530 | .SH "COLORS AND GRAPHICS" |
530 | .SH "COLORS AND GRAPHICS" |
| 531 | .PP |
531 | .PP |
| 532 | In addition to the default foreground and background colours, \fBrxvt\fP |
532 | In addition to the default foreground and background colours, \fBurxvt\fP |
| 533 | can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink |
533 | can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink |
| 534 | versions of the same)\&. |
534 | versions of the same)\&. |
| 535 | Here is a list of the colours with their \fBrgb\&.txt\fP names\&. |
535 | Here is a list of the colours with their \fBrgb\&.txt\fP names\&. |
| 536 | .PP |
536 | .PP |
| 537 | .TS |
537 | .TS |
| … | |
… | |
| 1018 | .IP "\fBrxvt -fg Black -bg White -rv\fP" |
1018 | .IP "\fBrxvt -fg Black -bg White -rv\fP" |
| 1019 | would yield White on Black, while on \fIxterm\fP(1) it would yield |
1019 | would yield White on Black, while on \fIxterm\fP(1) it would yield |
| 1020 | Black on White\&. |
1020 | Black on White\&. |
| 1021 | .SH "ENVIRONMENT" |
1021 | .SH "ENVIRONMENT" |
| 1022 | .PP |
1022 | .PP |
| 1023 | \fBrxvt\fP sets the environment variables \fBTERM\fP, \fBCOLORTERM\fP and |
1023 | \fBurxvt\fP sets the environment variables \fBTERM\fP, \fBCOLORTERM\fP and |
| 1024 | \fBCOLORFGBG\fP\&. The environment variable \fBWINDOWID\fP is set to the X window |
1024 | \fBCOLORFGBG\fP\&. The environment variable \fBWINDOWID\fP is set to the X window |
| 1025 | id number of the \fBrxvt\fP window and it also uses and sets the environment |
1025 | id number of the \fBurxvt\fP window and it also uses and sets the environment |
| 1026 | variable \fBDISPLAY\fP to specify which display terminal to use\&. \fBrxvt\fP uses |
1026 | variable \fBDISPLAY\fP to specify which display terminal to use\&. \fBurxvt\fP uses |
| 1027 | the environment variables \fBRXVTPATH\fP and \fBPATH\fP to find XPM files\&. |
1027 | the environment variables \fBRXVTPATH\fP and \fBPATH\fP to find XPM files\&. |
| 1028 | .SH "FILES" |
1028 | .SH "FILES" |
| 1029 | .PP |
1029 | .PP |
| 1030 | .IP "\fB/etc/utmp\fP" |
1030 | .IP "\fB/etc/utmp\fP" |
| 1031 | System file for login records\&. |
1031 | System file for login records\&. |
| … | |
… | |
| 1048 | .PP |
1048 | .PP |
| 1049 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
1049 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
| 1050 | .PP |
1050 | .PP |
| 1051 | .SH "FTP LOCATION" |
1051 | .SH "FTP LOCATION" |
| 1052 | .PP |
1052 | .PP |
| 1053 | rxvt-2\&.6\&.tar\&.gz can be found at the following ftp sites |
1053 | rxvt-2\&.7\&.tar\&.gz can be found at the following ftp sites |
| 1054 | ftp://ftp\&.rxvt\&.org/pub/rxvt |
1054 | ftp://ftp\&.rxvt\&.org/pub/rxvt |
| 1055 | .PP |
1055 | .PP |
| 1056 | .SH "CURRENT PROJECT COORDINATOR" |
1056 | .SH "CURRENT PROJECT COORDINATOR" |
| 1057 | .PP |
1057 | .PP |
| 1058 | .IP "Project Coordinator" |
1058 | .IP "Project Coordinator" |
| … | |
… | |
| 1079 | .IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>" |
1079 | .IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>" |
| 1080 | Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5) |
1080 | Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5) |
| 1081 | .IP "Geoff Wing <gcw@pobox\&.com>" |
1081 | .IP "Geoff Wing <gcw@pobox\&.com>" |
| 1082 | Rewrote screen display and text selection routines\&. |
1082 | Rewrote screen display and text selection routines\&. |
| 1083 | Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode) |
1083 | Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode) |
| 1084 | .IP "Marc Alexander Lehman <rxvt@schmorp\&.de>" |
1084 | .IP "Marc Alexander Lehmann <rxvt@schmorp\&.de>" |
| 1085 | Rewrote most of the display code and internal character handling |
1085 | Forked rxvt-unicode\&. Rewrote most of the display code and |
| 1086 | to store text in unicode\&. Numerous other fixes and extensions\&. |
1086 | internal character handling to store text in unicode, |
|
|
1087 | improve xterm compatibility and numerous other buffixes |
|
|
1088 | and extensions\&. |
| 1087 | .br |
1089 | .br |
| 1088 | Project Coordinator (Changes 1\&.0 - ) |
1090 | Project Coordinator (Changes 1\&.0 - ) |
| 1089 | .PP |
1091 | .PP |
