| 1 | .TH "RXVT" "1" "RXVTDATE()" "X Version 11" "X Tools" |
1 | .TH "RXVT" "1" "2004-04-02" "X Version 11" "X Tools" |
| 2 | .SH "NAME" |
2 | .SH "NAME" |
| 3 | rxvt (ouR XVT) \- a VT102 emulator for the X window system |
3 | rxvt-unicode (ouR XVT, unicode) \- a VT102 emulator for the X window system |
| 4 | .PP |
4 | .PP |
| 5 | .SH "SYNOPSIS" |
5 | .SH "SYNOPSIS" |
| 6 | .PP |
6 | .PP |
| 7 | \fBrxvt\fP [options] [-e command [ args ]] |
7 | \fBurxvt\fP [options] [-e command [ args ]] |
| 8 | .PP |
8 | .PP |
| 9 | .SH "DESCRIPTION" |
9 | .SH "DESCRIPTION" |
| 10 | .PP |
10 | .PP |
| 11 | \fBrxvt\fP, version \fBRXVTVERSION()\fP, is a colour vt102 terminal emulator |
11 | \fBrxvt-unicode\fP, version \fB2\&.7\fP, is a colour vt102 terminal emulator |
| 12 | intended as an \fIxterm\fP(1) replacement for users who do not require |
12 | intended as an \fIxterm\fP(1) replacement for users who do not require |
| 13 | features such as Tektronix 4014 emulation and toolkit-style configurability\&. |
13 | features such as Tektronix 4014 emulation and toolkit-style configurability\&. |
| 14 | As a result, \fBrxvt\fP uses much less swap space -- a significant |
14 | As a result, \fBrxvt-unicode\fP uses much less swap space -- a significant |
| 15 | advantage on a machine serving many X sessions\&. |
15 | advantage on a machine serving many X sessions\&. |
| 16 | .PP |
16 | .PP |
| 17 | .PP |
17 | .PP |
| 18 | .SH "OPTIONS" |
18 | .SH "OPTIONS" |
| 19 | .PP |
19 | .PP |
| 20 | The \fBrxvt\fP options (mostly a subset of \fIxterm\fP\&'s) are listed below\&. |
20 | The \fBurxvt\fP options (mostly a subset of \fIxterm\fP\&'s) are listed below\&. |
| 21 | In keeping with the smaller-is-better philosophy, options may be eliminated |
21 | In keeping with the smaller-is-better philosophy, options may be eliminated |
| 22 | or default values chosen at compile-time, so options and defaults listed |
22 | or default values chosen at compile-time, so options and defaults listed |
| 23 | may not accurately reflect the version installed on your system\&. |
23 | may not accurately reflect the version installed on your system\&. |
| 24 | `rxvt -h\&' gives a list of major compile-time options on the \fIOptions\fP line\&. |
24 | `rxvt -h\&' gives a list of major compile-time options on the \fIOptions\fP line\&. |
| 25 | Option descriptions may be prefixed with which compile option each is |
25 | Option descriptions may be prefixed with which compile option each is |
| 26 | dependent upon\&. e\&.g\&. `Compile \fIXIM\fP:\&' requires \fIXIM\fP on the \fIOptions\fP |
26 | dependent upon\&. e\&.g\&. `Compile \fIXIM\fP:\&' requires \fIXIM\fP on the \fIOptions\fP |
| 27 | line\&. Note: `rxvt -help\&' gives a list of all command-line options compiled |
27 | line\&. Note: `rxvt -help\&' gives a list of all command-line options compiled |
| 28 | into your version\&. |
28 | into your version\&. |
| 29 | .PP |
29 | .PP |
| 30 | Note that \fBrxvt\fP permits the resource name to be used as a long-option |
30 | Note that \fBurxvt\fP permits the resource name to be used as a long-option |
| 31 | (--/++ option) so the potential command-line options are far greater than |
31 | (--/++ option) so the potential command-line options are far greater than |
| 32 | those listed\&. |
32 | those listed\&. |
| 33 | For example: `rxvt --loginShell --color1 Orange\&'\&. |
33 | For example: `rxvt --loginShell --color1 Orange\&'\&. |
| 34 | .PP |
|
|
| 35 | Also note that if you do not explictly specify a font (\fB-fn\fP and \fB-fm\fP) |
|
|
| 36 | or a multichar encoding method (\fB-km\fP), rxvt will select a font for the |
|
|
| 37 | preferable encoding according to your locale\&. Supported encodings are: |
|
|
| 38 | \fBISO-8859-\fPn (n=\fB1\fP\&.\&.\&.\fB15\fP), \fBKOI8-R\fP, \fBKOI8-U\fP, \fBEUC-JP\fP, |
|
|
| 39 | \fBShift_JIS\fP, \fBEUC-KR\fP, \fBEUC-CN\fP (aka \fBGB\fP), and \fBBig5\fP\&. |
|
|
| 40 | .PP |
34 | .PP |
| 41 | The following options are available: |
35 | The following options are available: |
| 42 | .PP |
36 | .PP |
| 43 | .IP "\fB-help\fP, \fB--help\fP" |
37 | .IP "\fB-help\fP, \fB--help\fP" |
| 44 | Print out a message describing available options\&. |
38 | Print out a message describing available options\&. |
| … | |
… | |
| 57 | resource \fBjumpScroll\fP\&. |
51 | resource \fBjumpScroll\fP\&. |
| 58 | .IP "\fB-ip\fP|\fB+ip\fP" |
52 | .IP "\fB-ip\fP|\fB+ip\fP" |
| 59 | Turn on/off inheriting parent window\&'s pixmap\&. Alternative form |
53 | Turn on/off inheriting parent window\&'s pixmap\&. Alternative form |
| 60 | is \fB-tr\fP; |
54 | is \fB-tr\fP; |
| 61 | resource \fBinheritPixmap\fP\&. |
55 | resource \fBinheritPixmap\fP\&. |
|
|
56 | .IP "\fB-tint\fP \fIcolour\fP" |
|
|
57 | Tint the transparent background pixmap with the given colour\&. |
| 62 | .IP "\fB-bg\fP \fIcolour\fP" |
58 | .IP "\fB-bg\fP \fIcolour\fP" |
| 63 | Window background colour; |
59 | Window background colour; |
| 64 | resource \fBbackground\fP\&. |
60 | resource \fBbackground\fP\&. |
| 65 | .IP "\fB-fg\fP \fIcolour\fP" |
61 | .IP "\fB-fg\fP \fIcolour\fP" |
| 66 | Window foreground colour; |
62 | Window foreground colour; |
| … | |
… | |
| 79 | resource \fBpointerColor\fP\&. |
75 | resource \fBpointerColor\fP\&. |
| 80 | .IP "\fB-bd\fP \fIcolour\fP" |
76 | .IP "\fB-bd\fP \fIcolour\fP" |
| 81 | The colour of the border between the xterm scrollbar and the text; |
77 | The colour of the border between the xterm scrollbar and the text; |
| 82 | resource \fBborderColor\fP\&. |
78 | resource \fBborderColor\fP\&. |
| 83 | .IP "\fB-fn\fP \fIfontname\fP" |
79 | .IP "\fB-fn\fP \fIfontname\fP" |
| 84 | Main normal text font; |
80 | Select the fonts to be used used\&. This is a comma seperated |
|
|
81 | list of font names that are used in turn when trying to display |
|
|
82 | unicode characters\&. The first font defines the cell size for characters, |
|
|
83 | other fonts might be smaller, but not larger\&. A reasonable default font list |
|
|
84 | is always appended to it\&. |
| 85 | resource \fBfont\fP\&. |
85 | resource \fBfont\fP\&. |
| 86 | .IP "\fB-fb\fP \fIfontname\fP" |
|
|
| 87 | Main bold text font; |
|
|
| 88 | resource \fBboldFont\fP\&. |
|
|
| 89 | .IP "\fB-fm\fP \fIfontname\fP" |
|
|
| 90 | Main multicharacter font; |
|
|
| 91 | resource \fBmfont\fP\&. |
|
|
| 92 | .IP "\fB-km\fP \fImode\fP" |
|
|
| 93 | Compile \fImultichar_languages\fP: |
|
|
| 94 | Multiple-character font-set encoding mode; |
|
|
| 95 | \fBeucj\fP: EUC Japanese encoding\&. |
|
|
| 96 | \fBsjis\fP: Shift JIS encoding\&. |
|
|
| 97 | \fBbig5\fP: BIG5 encoding\&. |
|
|
| 98 | \fBgb\fP: GB encoding\&. |
|
|
| 99 | \fBkr\fP: EUC Korean encoding\&. |
|
|
| 100 | \fBnoenc\fP: no encoding; |
|
|
| 101 | resource \fBmultichar_encoding\fP\&. |
|
|
| 102 | .IP "\fB-grk\fP \fImode\fP" |
|
|
| 103 | Compile \fIGreek\fP: Greek keyboard translation; |
|
|
| 104 | \fBiso\fP: ISO-8859 mapping\&. |
|
|
| 105 | \fBibm\fP: IBM-437 mapping; |
|
|
| 106 | resource \fBgreek_keyboard\fP\&. |
|
|
| 107 | .IP "\fB-name\fP \fIname\fP" |
86 | .IP "\fB-name\fP \fIname\fP" |
| 108 | Specify the application name under which resources |
87 | Specify the application name under which resources |
| 109 | are to be obtained, rather than the default executable file name\&. |
88 | are to be obtained, rather than the default executable file name\&. |
| 110 | Name should not contain `\&.\&' or `*\&' characters\&. |
89 | Name should not contain `\&.\&' or `*\&' characters\&. |
| 111 | Also sets the icon and title name\&. |
90 | Also sets the icon and title name\&. |
| … | |
… | |
| 135 | Put scrollbar on right/left; |
114 | Put scrollbar on right/left; |
| 136 | resource \fBscrollBar_right\fP\&. |
115 | resource \fBscrollBar_right\fP\&. |
| 137 | .IP "\fB-st\fP|\fB+st\fP" |
116 | .IP "\fB-st\fP|\fB+st\fP" |
| 138 | Display normal (non XTerm/NeXT) scrollbar without/with a trough; |
117 | Display normal (non XTerm/NeXT) scrollbar without/with a trough; |
| 139 | resource \fBscrollBar_floating\fP\&. |
118 | resource \fBscrollBar_floating\fP\&. |
| 140 | .IP "\fB-mcc\fP|\fB+mcc\fP" |
|
|
| 141 | Compile \fImultichar_languages\fP: treat multibyte glyphs as single |
|
|
| 142 | character for backspace, delete and cursor movement keys; |
|
|
| 143 | resource \fBmultibyte_cursor\fP\&. |
|
|
| 144 | .IP "\fB-bc\fP|\fB+bc\fP" |
119 | .IP "\fB-bc\fP|\fB+bc\fP" |
| 145 | Blink the cursor; resource \fBcursorBlink\fP\&. |
120 | Blink the cursor; resource \fBcursorBlink\fP\&. |
| 146 | .IP "\fB-iconic\fP" |
121 | .IP "\fB-iconic\fP" |
| 147 | Start iconified, if the window manager supports that option\&. |
122 | Start iconified, if the window manager supports that option\&. |
| 148 | Alternative form is \fB-ic\fP\&. |
123 | Alternative form is \fB-ic\fP\&. |
| … | |
… | |
| 166 | This option specifies the name of the terminal type to be set in the |
141 | This option specifies the name of the terminal type to be set in the |
| 167 | \fBTERM\fP environment variable\&. This terminal type must exist in the |
142 | \fBTERM\fP environment variable\&. This terminal type must exist in the |
| 168 | \fItermcap(5)\fP database and should have \fIli#\fP and \fIco#\fP entries; |
143 | \fItermcap(5)\fP database and should have \fIli#\fP and \fIco#\fP entries; |
| 169 | resource \fBtermName\fP\&. |
144 | resource \fBtermName\fP\&. |
| 170 | .IP "\fB-e\fP \fIcommand [arguments]\fP" |
145 | .IP "\fB-e\fP \fIcommand [arguments]\fP" |
| 171 | Run the command with its command-line arguments in the \fBrxvt\fP |
146 | Run the command with its command-line arguments in the \fBurxvt\fP |
| 172 | window; also sets the window title and icon name to be the basename |
147 | window; also sets the window title and icon name to be the basename |
| 173 | of the program being executed if neither \fI-title\fP (\fI-T\fP) nor |
148 | of the program being executed if neither \fI-title\fP (\fI-T\fP) nor |
| 174 | \fI-n\fP are given on the command line\&. If this option is used, it |
149 | \fI-n\fP are given on the command line\&. If this option is used, it |
| 175 | must be the last on the command-line\&. If there is no \fB-e\fP option |
150 | must be the last on the command-line\&. If there is no \fB-e\fP option |
| 176 | then the default is to run the program specified by the \fBSHELL\fP |
151 | then the default is to run the program specified by the \fBSHELL\fP |
| … | |
… | |
| 191 | \fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP; |
166 | \fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP; |
| 192 | resource \fBpreeditType\fP\&. |
167 | resource \fBpreeditType\fP\&. |
| 193 | .IP "\fB-im\fP \fItext\fP" |
168 | .IP "\fB-im\fP \fItext\fP" |
| 194 | Compile \fIXIM\fP: input method name\&. |
169 | Compile \fIXIM\fP: input method name\&. |
| 195 | resource \fBinputMethod\fP\&. |
170 | resource \fBinputMethod\fP\&. |
|
|
171 | .IP "\fB-imlocale\fP \fIstring\fP" |
|
|
172 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
|
|
173 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
|
|
174 | for the input extension to be able to input japanese characters |
|
|
175 | while staying in another locale\&. |
|
|
176 | .IP "\fB-insecure\fP" |
|
|
177 | Enable "insecure" mode, which currently enables most of the escape |
|
|
178 | sequences that echo strings\&. See the resource \fBinsecure\fP for |
|
|
179 | more info\&. |
| 196 | .IP "\fB-mod\fP \fImodifier\fP" |
180 | .IP "\fB-mod\fP \fImodifier\fP" |
| 197 | Override detection of Meta modifier with specified key: |
181 | Override detection of Meta modifier with specified key: |
| 198 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
182 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
| 199 | \fBmod4\fP, \fBmod5\fP; |
183 | \fBmod4\fP, \fBmod5\fP; |
| 200 | resource \fImodifier\fP\&. |
184 | resource \fImodifier\fP\&. |
|
|
185 | .IP "\fB-ssc\fP|\fB+ssc\fP" |
|
|
186 | Turn on/off secondary screen (default enabled); |
|
|
187 | resource \fBsecondaryScreen\fP\&. |
|
|
188 | .IP "\fB-ssr\fP|\fB+ssr\fP" |
|
|
189 | Turn on/off secondary screen scroll (default enabled); |
|
|
190 | resource \fBsecondaryScroll\fP\&. |
| 201 | .IP "\fB-xrm\fP \fIresourcestring\fP" |
191 | .IP "\fB-xrm\fP \fIresourcestring\fP" |
| 202 | No effect on rxvt\&. Simply passes through an argument to be made |
192 | No effect on rxvt\&. Simply passes through an argument to be made |
| 203 | available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP |
193 | available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP |
| 204 | in some window managers\&. |
194 | in some window managers\&. |
| 205 | .SH "RESOURCES (available also as long-options)" |
195 | .SH "RESOURCES (available also as long-options)" |
| 206 | .PP |
196 | .PP |
| 207 | Note: `rxvt --help\&' gives a list of all resources (long options) compiled |
197 | Note: `rxvt --help\&' gives a list of all resources (long options) compiled |
| 208 | into your version\&. |
198 | into your version\&. |
| 209 | If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists |
199 | If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists |
| 210 | \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application defaults set in |
200 | \fB\&.Xdefaults\fP) then \fBurxvt\fP accepts application defaults set in |
| 211 | XAPPLOADDIR/Rxvt (compile-time defined: usually |
201 | XAPPLOADDIR/Rxvt (compile-time defined: usually |
| 212 | \fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP, |
202 | \fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP, |
| 213 | or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when |
203 | or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when |
| 214 | reading X resources, \fBrxvt\fP recognizes two class names: \fBXTerm\fP and |
204 | reading X resources, \fBurxvt\fP recognizes two class names: \fBXTerm\fP and |
| 215 | \fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both |
205 | \fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both |
| 216 | \fBrxvt\fP and \fIxterm\fP to be easily configured, while the class name |
206 | \fBurxvt\fP and \fIxterm\fP to be easily configured, while the class name |
| 217 | \fBRxvt\fP allows resources unique to \fBrxvt\fP, notably colours and |
207 | \fBRxvt\fP allows resources unique to \fBurxvt\fP, notably colours and |
| 218 | key-handling, to be shared between different \fBrxvt\fP configurations\&. |
208 | key-handling, to be shared between different \fBurxvt\fP configurations\&. |
| 219 | If no resources are specified, suitable defaults will be used\&. |
209 | If no resources are specified, suitable defaults will be used\&. |
| 220 | Command-line arguments can be used to override resource settings\&. The |
210 | Command-line arguments can be used to override resource settings\&. The |
| 221 | following resources are allowed: |
211 | following resources are allowed: |
| 222 | .PP |
212 | .PP |
| 223 | .IP "\fBgeometry:\fP \fIgeom\fP" |
213 | .IP "\fBgeometry:\fP \fIgeom\fP" |
| … | |
… | |
| 271 | option \fB+j\fP\&. |
261 | option \fB+j\fP\&. |
| 272 | .IP "\fBinheritPixmap:\fP \fIboolean\fP" |
262 | .IP "\fBinheritPixmap:\fP \fIboolean\fP" |
| 273 | \fBTrue\fP: make the background inherit the parent windows\&' pixmap, |
263 | \fBTrue\fP: make the background inherit the parent windows\&' pixmap, |
| 274 | giving artificial transparency\&. |
264 | giving artificial transparency\&. |
| 275 | \fBFalse\fP: do not inherit the parent windows\&' pixmap\&. |
265 | \fBFalse\fP: do not inherit the parent windows\&' pixmap\&. |
|
|
266 | .IP "\fBtintColor\fP \fIcolour\fP" |
|
|
267 | Tint the transparent background pixmap with the given colour\&. |
| 276 | .IP "\fBscrollColor:\fP \fIcolour\fP" |
268 | .IP "\fBscrollColor:\fP \fIcolour\fP" |
| 277 | Use the specified colour for the scrollbar [default #B2B2B2]\&. |
269 | Use the specified colour for the scrollbar [default #B2B2B2]\&. |
| 278 | .IP "\fBtroughColor:\fP \fIcolour\fP" |
270 | .IP "\fBtroughColor:\fP \fIcolour\fP" |
| 279 | Use the specified colour for the scrollbar\&'s trough area [default |
271 | Use the specified colour for the scrollbar\&'s trough area [default |
| 280 | #969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. |
272 | #969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. |
| … | |
… | |
| 295 | .IP "\fBpath:\fP \fIpath\fP" |
287 | .IP "\fBpath:\fP \fIpath\fP" |
| 296 | Specify the colon-delimited search path for finding files (XPM and |
288 | Specify the colon-delimited search path for finding files (XPM and |
| 297 | menus), in addition to the paths specified by the \fBRXVTPATH\fP and |
289 | menus), in addition to the paths specified by the \fBRXVTPATH\fP and |
| 298 | \fBPATH\fP environment variables\&. |
290 | \fBPATH\fP environment variables\&. |
| 299 | .IP "\fBfont:\fP \fIfontname\fP" |
291 | .IP "\fBfont:\fP \fIfontname\fP" |
| 300 | Select the main text font used [default 7x14]; |
292 | Select the fonts to be used used\&. This is a comma seperated |
|
|
293 | list of font names that are used in turn when trying to display |
|
|
294 | unicode characters\&. The first font defines the cell size for characters, |
|
|
295 | other fonts might be smaller, but not larger\&. A reasonable default font list |
|
|
296 | is always appended to this list\&. |
| 301 | option \fB-fn\fP\&. |
297 | option \fB-fn\fP\&. |
| 302 | .IP "\fBfont\fP\fIn\fP\fB:\fP \fIfontname\fP" |
|
|
| 303 | Specify the alternative font \fIn\fP\&. The default font values: |
|
|
| 304 | .br |
|
|
| 305 | .RS |
|
|
| 306 | .HP |
|
|
| 307 | .TS |
|
|
| 308 | tab(`); |
|
|
| 309 | l l . |
|
|
| 310 | \fBfont\fP: `\ 7x14 |
|
|
| 311 | \fBfont1\fP: `\ 6x10 |
|
|
| 312 | \fBfont2\fP: `\ 6x13 |
|
|
| 313 | \fBfont3\fP: `\ 8x13 |
|
|
| 314 | \fBfont4\fP: `\ 9x15 |
|
|
| 315 | .TE |
|
|
| 316 | .RE |
|
|
| 317 | .IP "\fBboldFont:\fP \fIfontname\fP" |
|
|
| 318 | Specify the name of the bold font to use if \fBcolorBD\fP has not been |
|
|
| 319 | specified and it is not possible to map the default foreground colour |
|
|
| 320 | to colour 8-15 [default NONE]\&. This font must be the same height and |
|
|
| 321 | width as the normal font; |
|
|
| 322 | option \fB-fb\fP\&. |
|
|
| 323 | .IP "\fBmfont:\fP \fIfontname\fP" |
|
|
| 324 | Select the main multiple-character text font used [default k14]; |
|
|
| 325 | option \fB-fk\fP\&. |
|
|
| 326 | .IP "\fBmfont\fP\fIn\fP\fB:\fP \fIfontname\fP" |
|
|
| 327 | Specify the alternative multiple-character font \fIn\fP\&. If compiled |
|
|
| 328 | for multiple-character fonts, the Roman and multiple-character font |
|
|
| 329 | sizes should match\&. |
|
|
| 330 | .IP "\fBmultichar_encoding:\fP \fImode\fP" |
|
|
| 331 | Set the encoding mode to be used when multicharacter encoding is |
|
|
| 332 | received; |
|
|
| 333 | \fBeucj\fP: EUC Japanese encoding [default for Kanji]\&. |
|
|
| 334 | \fBsjis\fP: Shift JIS encoding\&. |
|
|
| 335 | \fBbig5\fP: BIG5 encoding\&. |
|
|
| 336 | \fBgb\fP: GB encoding\&. |
|
|
| 337 | \fBkr\fP: EUC Korean encoding\&. |
|
|
| 338 | \fBnoenc\fP: no encoding; |
|
|
| 339 | option \fB-km\fP\&. |
|
|
| 340 | .IP "\fBgreek_keyboard:\fP \fImode\fP" |
|
|
| 341 | Set the Greek keyboard translation mode to be used; |
|
|
| 342 | \fBiso\fP: ISO-8859 mapping (elot-928) [default]\&. |
|
|
| 343 | \fBibm\fP: IBM-437 mapping (DOS codepage 737); |
|
|
| 344 | option \fB-grk\fP\&. |
|
|
| 345 | .IP "\fBgreektoggle_key:\fP \fIkeysym\fP" |
|
|
| 346 | Set the key to toggle keyboard input between no translation and |
|
|
| 347 | Greek translation [default \fBMode_switch\fP]\&. |
|
|
| 348 | For more details, see the distributed file \fBREADME\&.greek\fP\&. |
|
|
| 349 | .IP "\fBselectstyle:\fP \fImode\fP" |
298 | .IP "\fBselectstyle:\fP \fImode\fP" |
| 350 | Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which |
299 | Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which |
| 351 | is xterm style with 2\&.20 old word selection, or anything else which |
300 | is xterm style with 2\&.20 old word selection, or anything else which |
| 352 | gives xterm style selection\&. |
301 | gives xterm style selection\&. |
| 353 | .IP "\fBscrollstyle:\fP \fImode\fP" |
302 | .IP "\fBscrollstyle:\fP \fImode\fP" |
| 354 | Set scrollbar style to \fBrxvt\fP, \fBnext\fP or \fBxterm\fP |
303 | Set scrollbar style to \fBurxvt\fP, \fBnext\fP or \fBxterm\fP |
| 355 | .IP "\fBtitle:\fP \fIstring\fP" |
304 | .IP "\fBtitle:\fP \fIstring\fP" |
| 356 | Set window title string, the default title is the command-line |
305 | Set window title string, the default title is the command-line |
| 357 | specified after the \fB-e\fP option, if any, otherwise the application |
306 | specified after the \fB-e\fP option, if any, otherwise the application |
| 358 | name; |
307 | name; |
| 359 | option \fB-title\fP\&. |
308 | option \fB-title\fP\&. |
| … | |
… | |
| 462 | \fBTrue\fP: blank the pointer when a key is pressed or after a set number |
411 | \fBTrue\fP: blank the pointer when a key is pressed or after a set number |
| 463 | of seconds of inactivity\&. |
412 | of seconds of inactivity\&. |
| 464 | \fBFalse\fP: the pointer is always visible [default]\&. |
413 | \fBFalse\fP: the pointer is always visible [default]\&. |
| 465 | .IP "\fBpointerBlankDelay:\fP \fInumber\fP" |
414 | .IP "\fBpointerBlankDelay:\fP \fInumber\fP" |
| 466 | Specifies number of seconds before blanking the pointer [default 2]\&. |
415 | Specifies number of seconds before blanking the pointer [default 2]\&. |
| 467 | .IP "\fBmultibyte_cursor:\fP \fIboolean\fP" |
|
|
| 468 | \fBTrue\fP: consider multibyte glyphs as single character for backspace, |
|
|
| 469 | delete and cursor movement keys; |
|
|
| 470 | option \fB-mcc\fP\&. |
|
|
| 471 | \fBFalse\fP: move through all components of all glyphs; |
|
|
| 472 | option \fB+mcc\fP\&. |
|
|
| 473 | .IP "\fBbackspacekey:\fP \fIstring\fP" |
416 | .IP "\fBbackspacekey:\fP \fIstring\fP" |
| 474 | The string to send when the backspace key is pressed\&. If set to |
417 | The string to send when the backspace key is pressed\&. If set to |
| 475 | \fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted, |
418 | \fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted, |
| 476 | \fBBackspace\fP (code 8) - which can be reversed with the appropriate |
419 | \fBBackspace\fP (code 8) - which can be reversed with the appropriate |
| 477 | DEC private mode escape sequence\&. |
420 | DEC private mode escape sequence\&. |
| … | |
… | |
| 488 | \fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP; |
431 | \fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP; |
| 489 | option \fB-pt\fP\&. |
432 | option \fB-pt\fP\&. |
| 490 | .IP "\fBinputMethod:\fP \fIname\fP" |
433 | .IP "\fBinputMethod:\fP \fIname\fP" |
| 491 | \fIname\fP of inputMethod to use; |
434 | \fIname\fP of inputMethod to use; |
| 492 | option \fB-im\fP\&. |
435 | option \fB-im\fP\&. |
|
|
436 | .IP "\fBimLocale:\fP \fIname\fP" |
|
|
437 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
|
|
438 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
|
|
439 | for the input extension to be able to input japanese characters |
|
|
440 | while staying in another locale\&. |
|
|
441 | option \fB-imlocale\fP\&. |
|
|
442 | .IP "\fBinsecure\fP" |
|
|
443 | Enables "insecure" mode\&. Rxvt-unicode offers some escape sequences |
|
|
444 | that echo arbitrary strings like the icon name or the locale\&. This |
|
|
445 | could be abused if somebody gets 8-bit-clean access to your |
|
|
446 | display, wether throuh a mail client displaying mail bodies |
|
|
447 | unfiltered or though write(1)\&. Therefore, these sequences are |
|
|
448 | disabled by default\&. (Note that other terminals, including xterm, |
|
|
449 | have these sequences enabled by default)\&. You can enable them |
|
|
450 | by setting this boolean resource or specifying \fB-insecure\fP as |
|
|
451 | an option\&. At the moment, this enabled display-answer, locale, |
|
|
452 | findfont, icon label and window title requests as well as dynamic |
|
|
453 | menubar dispatch\&. |
| 493 | .IP "\fBmodifier:\fP \fImodifier\fP" |
454 | .IP "\fBmodifier:\fP \fImodifier\fP" |
| 494 | Set the key to be interpreted as the Meta key to: |
455 | Set the key to be interpreted as the Meta key to: |
| 495 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
456 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
| 496 | \fBmod4\fP, \fBmod5\fP; |
457 | \fBmod4\fP, \fBmod5\fP; |
| 497 | option \fB-mod\fP\&. |
458 | option \fB-mod\fP\&. |
| 498 | .IP "\fBanswerbackString:\fP \fIstring\fP" |
459 | .IP "\fBanswerbackString:\fP \fIstring\fP" |
| 499 | Specify the reply rxvt sends to the shell when an ENQ (control-E) |
460 | Specify the reply rxvt sends to the shell when an ENQ (control-E) |
| 500 | character is passed through\&. It may contain escape values as |
461 | character is passed through\&. It may contain escape values as |
| 501 | described in the entry on \fBkeysym\fP following\&. |
462 | described in the entry on \fBkeysym\fP following\&. |
|
|
463 | .IP "\fBsecondaryScreen:\fP \fIbool\fP" |
|
|
464 | Turn on/off secondary screen (default enabled)\&. |
|
|
465 | .IP "\fBsecondaryScroll:\fP \fIbool\fP" |
|
|
466 | Turn on/off secondary screen scroll (default enabled)\&. If |
|
|
467 | the this option is enabled, scrolls on the secondary screen will |
|
|
468 | change the scrollback buffer and switching to/from the secondary screen |
|
|
469 | will instead scroll the screen up\&. |
| 502 | .IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP" |
470 | .IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP" |
| 503 | Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It |
471 | Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It |
| 504 | may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, |
472 | may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, |
| 505 | \en: newline, \er: return, \et: tab, \e000: octal number) or control |
473 | \en: newline, \er: return, \et: tab, \e000: octal number) or control |
| 506 | characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with |
474 | characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with |
| 507 | double quotes so that it can start or end with whitespace\&. The |
475 | double quotes so that it can start or end with whitespace\&. The |
| 508 | intervening resource name \fBkeysym\&.\fP cannot be omitted\&. This |
476 | intervening resource name \fBkeysym\&.\fP cannot be omitted\&. This |
| 509 | resource is only available when compiled with KEYSYM_RESOURCE\&. |
477 | resource is only available when compiled with KEYSYM_RESOURCE\&. |
| 510 | .SH "THE SCROLLBAR" |
478 | .SH "THE SCROLLBAR" |
| 511 | .PP |
479 | .PP |
| 512 | Lines of text that scroll off the top of the \fBrxvt\fP window (resource: |
480 | Lines of text that scroll off the top of the \fBurxvt\fP window (resource: |
| 513 | \fBsaveLines\fP) and can be scrolled back using the scrollbar or by keystrokes\&. |
481 | \fBsaveLines\fP) and can be scrolled back using the scrollbar or by keystrokes\&. |
| 514 | The normal \fBrxvt\fP scrollbar has arrows and its behaviour is fairly |
482 | The normal \fBurxvt\fP scrollbar has arrows and its behaviour is fairly |
| 515 | intuitive\&. The \fBxterm-scrollbar\fP is without arrows and its behaviour |
483 | intuitive\&. The \fBxterm-scrollbar\fP is without arrows and its behaviour |
| 516 | mimics that of \fIxterm\fP |
484 | mimics that of \fIxterm\fP |
| 517 | .PP |
485 | .PP |
| 518 | Scroll down with \fBButton1\fP (\fBxterm-scrollbar\fP) or \fBShift-Next\fP\&. |
486 | Scroll down with \fBButton1\fP (\fBxterm-scrollbar\fP) or \fBShift-Next\fP\&. |
| 519 | Scroll up with \fBButton3\fP (\fBxterm-scrollbar\fP) or \fBShift-Prior\fP\&. |
487 | Scroll up with \fBButton3\fP (\fBxterm-scrollbar\fP) or \fBShift-Prior\fP\&. |
| … | |
… | |
| 540 | region and release; Right click to extend the marked region; |
508 | region and release; Right click to extend the marked region; |
| 541 | Left double-click to select a word; Left triple-click to select |
509 | Left double-click to select a word; Left triple-click to select |
| 542 | the entire line\&. |
510 | the entire line\&. |
| 543 | .IP "\fBInsertion\fP:" |
511 | .IP "\fBInsertion\fP:" |
| 544 | Pressing and releasing the Middle mouse button (or \fBShift-Insert\fP) |
512 | Pressing and releasing the Middle mouse button (or \fBShift-Insert\fP) |
| 545 | in an \fBrxvt\fP window causes the current text selection to be inserted |
513 | in an \fBurxvt\fP window causes the current text selection to be inserted |
| 546 | as if it had been typed on the keyboard\&. |
514 | as if it had been typed on the keyboard\&. |
| 547 | .SH "CHANGING FONTS" |
515 | .SH "CHANGING FONTS" |
| 548 | .PP |
516 | .PP |
| 549 | You can change fonts on-the-fly, which is to say cycle through the default |
517 | You can change fonts on-the-fly, which is to say cycle through the default |
| 550 | font and others of various sizes, by using \fBShift-KP_Add\fP and |
518 | font and others of various sizes, by using \fBShift-KP_Add\fP and |
| 551 | \fBShift-KP_Subtract\fP\&. Or, alternatively (if enabled) with |
519 | \fBShift-KP_Subtract\fP\&. Or, alternatively (if enabled) with |
| 552 | \fBAlt->\fP and \fBAlt-<\fP, where the actual key |
520 | \fBAlt->\fP and \fBAlt-<\fP, where the actual key |
| 553 | can be selected using resources \fBsmallfont_key\fP/\fBbigfont_key\fP\&. |
521 | can be selected using resources \fBsmallfont_key\fP/\fBbigfont_key\fP\&. |
| 554 | .SH "LOGIN STAMP" |
522 | .SH "LOGIN STAMP" |
| 555 | .PP |
523 | .PP |
| 556 | \fBrxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be |
524 | \fBurxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be |
| 557 | seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this |
525 | seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this |
| 558 | feature, \fBrxvt\fP must be installed setuid root on some systems\&. |
526 | feature, \fBurxvt\fP must be installed setuid root on some systems\&. |
| 559 | .SH "COLORS AND GRAPHICS" |
527 | .SH "COLORS AND GRAPHICS" |
| 560 | .PP |
528 | .PP |
| 561 | If graphics support was enabled at compile-time, \fBrxvt\fP can be queried |
|
|
| 562 | with ANSI escape sequences and can address individual pixels instead of |
|
|
| 563 | text characters\&. Note the graphics support is still considered beta code\&. |
|
|
| 564 | .PP |
|
|
| 565 | In addition to the default foreground and background colours, \fBrxvt\fP |
529 | In addition to the default foreground and background colours, \fBurxvt\fP |
| 566 | can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink |
530 | can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink |
| 567 | versions of the same)\&. |
531 | versions of the same)\&. |
| 568 | Here is a list of the colours with their \fBrgb\&.txt\fP names\&. |
532 | Here is a list of the colours with their \fBrgb\&.txt\fP names\&. |
| 569 | .PP |
533 | .PP |
| 570 | .TS |
534 | .TS |
| … | |
… | |
| 604 | .IP "\fBrxvt -fg Black -bg White -rv\fP" |
568 | .IP "\fBrxvt -fg Black -bg White -rv\fP" |
| 605 | would yield White on Black, while on \fIxterm\fP(1) it would yield |
569 | would yield White on Black, while on \fIxterm\fP(1) it would yield |
| 606 | Black on White\&. |
570 | Black on White\&. |
| 607 | .SH "ENVIRONMENT" |
571 | .SH "ENVIRONMENT" |
| 608 | .PP |
572 | .PP |
| 609 | \fBrxvt\fP sets the environment variables \fBTERM\fP, \fBCOLORTERM\fP and |
573 | \fBurxvt\fP sets the environment variables \fBTERM\fP, \fBCOLORTERM\fP and |
| 610 | \fBCOLORFGBG\fP\&. The environment variable \fBWINDOWID\fP is set to the X window |
574 | \fBCOLORFGBG\fP\&. The environment variable \fBWINDOWID\fP is set to the X window |
| 611 | id number of the \fBrxvt\fP window and it also uses and sets the environment |
575 | id number of the \fBurxvt\fP window and it also uses and sets the environment |
| 612 | variable \fBDISPLAY\fP to specify which display terminal to use\&. \fBrxvt\fP uses |
576 | variable \fBDISPLAY\fP to specify which display terminal to use\&. \fBurxvt\fP uses |
| 613 | the environment variables \fBRXVTPATH\fP and \fBPATH\fP to find XPM files\&. |
577 | the environment variables \fBRXVTPATH\fP and \fBPATH\fP to find XPM files\&. |
| 614 | .SH "FILES" |
578 | .SH "FILES" |
| 615 | .PP |
579 | .PP |
| 616 | .IP "\fB/etc/utmp\fP" |
580 | .IP "\fB/etc/utmp\fP" |
| 617 | System file for login records\&. |
581 | System file for login records\&. |
| … | |
… | |
| 632 | .PP |
596 | .PP |
| 633 | Cursor change support is not yet implemented\&. |
597 | Cursor change support is not yet implemented\&. |
| 634 | .PP |
598 | .PP |
| 635 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
599 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
| 636 | .PP |
600 | .PP |
| 637 | Graphics support is fairly crude\&. |
|
|
| 638 | .PP |
|
|
| 639 | .SH "FTP LOCATION" |
601 | .SH "FTP LOCATION" |
| 640 | .PP |
602 | .PP |
| 641 | rxvt-+RXVTVERSION()\&.tar\&.gz can be found at the following ftp sites |
603 | rxvt-2\&.7\&.tar\&.gz can be found at the following ftp sites |
| 642 | RXVTFTPSITE() |
604 | ftp://ftp\&.rxvt\&.org/pub/rxvt |
| 643 | .PP |
605 | .PP |
| 644 | .SH "CURRENT PROJECT COORDINATOR" |
606 | .SH "CURRENT PROJECT COORDINATOR" |
| 645 | .PP |
607 | .PP |
| 646 | .IP "Project Coordinator" |
608 | .IP "Project Coordinator" |
| 647 | RXVTMAINT() RXVTMAINTEMAIL() |
609 | Marc A\&. Lehmann <rxvt@schmorp\&.de> |
| 648 | .br |
610 | .br |
| 649 | .IP "Web page maintainter" |
611 | .IP "Web page maintainter" |
| 650 | RXVTWEBMAINT() RXVTWEBMAINTEMAIL() |
612 | Marc A\&. Lehmann <rxvt@schmorp\&.de> |
| 651 | .br |
613 | .br |
| 652 | RXVTWEBPAGE() |
614 | <http://www\&.sourceforge\&.net/projects/rxvt-unicode/> |
| 653 | .br |
615 | .br |
| 654 | .IP "Mailing list" |
|
|
| 655 | The Rxvt Workers <rxvt-workers@rxvt\&.org> |
|
|
| 656 | mailing list has also been established for rxvt development, to |
|
|
| 657 | subscribe, email to |
|
|
| 658 | <rxvt-workers-subscribe@rxvt\&.org>\&. |
|
|
| 659 | There is also a mailing list for announcements of new releases of |
|
|
| 660 | rxvt\&. To subscribe, email to |
|
|
| 661 | <rxvt-announce-subscribe@rxvt\&.org>\&. |
|
|
| 662 | .PP |
616 | .PP |
| 663 | .SH "AUTHORS" |
617 | .SH "AUTHORS" |
| 664 | .PP |
618 | .PP |
| 665 | .IP "John Bovey" |
619 | .IP "John Bovey" |
| 666 | University of Kent, 1992, wrote the original Xvt\&. |
620 | University of Kent, 1992, wrote the original Xvt\&. |
| 667 | .IP "Rob Nation <nation@rocket\&.sanders\&.lockheed\&.com>" |
621 | .IP "Rob Nation <nation@rocket\&.sanders\&.lockheed\&.com>" |
| 668 | very heavily modified Xvt and came up with Rxvt |
622 | very heavily modified Xvt and came up with Rxvt |
| 669 | .IP "Angelo Haritsis <ah@doc\&.ic\&.ac\&.uk>" |
623 | .IP "Angelo Haritsis <ah@doc\&.ic\&.ac\&.uk>" |
| 670 | wrote the Greek Keyboard Input |
624 | wrote the Greek Keyboard Input (no longer in code) |
| 671 | .IP "mj olesen <olesen@me\&.QueensU\&.CA>" |
625 | .IP "mj olesen <olesen@me\&.QueensU\&.CA>" |
| 672 | Wrote the menu system\&. |
626 | Wrote the menu system\&. |
| 673 | .br |
627 | .br |
| 674 | Project Coordinator (changes\&.txt 2\&.11 to 2\&.21) |
628 | Project Coordinator (changes\&.txt 2\&.11 to 2\&.21) |
| 675 | .IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>" |
629 | .IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>" |
| 676 | Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5) |
630 | Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5) |
| 677 | .IP "Geoff Wing <gcw@pobox\&.com>" |
631 | .IP "Geoff Wing <gcw@pobox\&.com>" |
| 678 | Rewrote screen display and text selection routines\&. |
632 | Rewrote screen display and text selection routines\&. |
|
|
633 | Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode) |
|
|
634 | .IP "Marc Alexander Lehmann <rxvt@schmorp\&.de>" |
|
|
635 | Forked rxvt-unicode\&. Rewrote most of the display code and |
|
|
636 | internal character handling to store text in unicode, |
|
|
637 | improve xterm compatibility and numerous other buffixes |
|
|
638 | and extensions\&. |
| 679 | .br |
639 | .br |
| 680 | Project Coordinator (changes\&.txt 2\&.4\&.6 - ) |
640 | Project Coordinator (Changes 1\&.0 - ) |
|
|
641 | .PP |
