1 |
perry |
1 |
1 |
|
|
2 |
!!!1 |
|
|
3 |
NAME |
|
|
4 |
SYNOPSIS |
|
|
5 |
DESCRIPTION |
|
|
6 |
OPTIONS |
|
|
7 |
RESOURCES (available also as long-options) |
|
|
8 |
THE SCROLLBAR |
|
|
9 |
MOUSE REPORTING |
|
|
10 |
TEXT SELECTION AND INSERTION |
|
|
11 |
CHANGING FONTS |
|
|
12 |
LOGIN STAMP |
|
|
13 |
COLORS AND GRAPHICS |
|
|
14 |
ENVIRONMENT |
|
|
15 |
FILES |
|
|
16 |
DEBIAN NOTES |
|
|
17 |
SEE ALSO |
|
|
18 |
BUGS |
|
|
19 |
FTP LOCATION |
|
|
20 |
CURRENT PROJECT COORDINATOR |
|
|
21 |
AUTHORS |
|
|
22 |
---- |
|
|
23 |
!!NAME |
|
|
24 |
|
|
|
25 |
|
|
|
26 |
rxvt (ouR XVT) - a VT102 emulator for the X window system |
|
|
27 |
!!SYNOPSIS |
|
|
28 |
|
|
|
29 |
|
|
|
30 |
__rxvt__ [[options] [[-e command [[ args ]] |
|
|
31 |
!!DESCRIPTION |
|
|
32 |
|
|
|
33 |
|
|
|
34 |
__rxvt__, version __2.6.4__, is a colour vt102 |
|
|
35 |
terminal emulator intended as an xterm(1) replacement |
|
|
36 |
for users who do not require features such as Tektronix 4014 |
|
|
37 |
emulation and toolkit-style configurability. As a result, |
|
|
38 |
__rxvt__ uses much less swap space -- a significant |
|
|
39 |
advantage on a machine serving many X sessions. |
|
|
40 |
!!OPTIONS |
|
|
41 |
|
|
|
42 |
|
|
|
43 |
The __rxvt__ options (mostly a subset of ''xterm'''s) |
|
|
44 |
are listed below. In keeping with the smaller-is-better |
|
|
45 |
philosophy, options may be eliminated or default values |
|
|
46 |
chosen at compile-time, so options and defaults listed may |
|
|
47 |
not accurately reflect the version installed on your system. |
|
|
48 |
``rxvt -h'' gives a list of major compile-time options on |
|
|
49 |
the usage line. Option descriptions may be prefixed with |
|
|
50 |
which compile option each is dependent upon. e.g. ``Compile |
|
|
51 |
''XIM'':'' requires ''XIM'' on the usage line. Note: |
|
|
52 |
``rxvt -help'' gives a list of all options compiled into |
|
|
53 |
your version. |
|
|
54 |
|
|
|
55 |
|
|
|
56 |
Note that __rxvt__ permits the resource name to be used |
|
|
57 |
as a long-option (--/++ option) so the potential |
|
|
58 |
command-line options are far greater than those listed. For |
|
|
59 |
example: ``rxvt --loginShell --color1 Orange''. |
|
|
60 |
|
|
|
61 |
|
|
|
62 |
__-help__, __--help__ |
|
|
63 |
|
|
|
64 |
|
|
|
65 |
Print out a message describing available |
|
|
66 |
options. |
|
|
67 |
|
|
|
68 |
|
|
|
69 |
__-display__ ''displayname'' |
|
|
70 |
|
|
|
71 |
|
|
|
72 |
Attempt to open a window on the named X display (__-d__ |
|
|
73 |
still respected). In the absence of this option, the display |
|
|
74 |
specified by the __DISPLAY__ environment variable is |
|
|
75 |
used. |
|
|
76 |
|
|
|
77 |
|
|
|
78 |
__-geometry__ ''geom'' |
|
|
79 |
|
|
|
80 |
|
|
|
81 |
Window geometry (__-g__ still respected); resource |
|
|
82 |
__geometry__. |
|
|
83 |
|
|
|
84 |
|
|
|
85 |
__-rv__|__+rv__ |
|
|
86 |
|
|
|
87 |
|
|
|
88 |
Turn on/off simulated reverse video; resource |
|
|
89 |
__reverseVideo__. |
|
|
90 |
|
|
|
91 |
|
|
|
92 |
__-ip__|__+ip__ |
|
|
93 |
|
|
|
94 |
|
|
|
95 |
Turn on/off inheriting parent window's pixmap. Alternative |
|
|
96 |
form is __-tr__; resource |
|
|
97 |
__inheritPixmap__. |
|
|
98 |
|
|
|
99 |
|
|
|
100 |
__-bg__ ''colour'' |
|
|
101 |
|
|
|
102 |
|
|
|
103 |
Window background colour; resource |
|
|
104 |
__background__. |
|
|
105 |
|
|
|
106 |
|
|
|
107 |
__-fg__ ''colour'' |
|
|
108 |
|
|
|
109 |
|
|
|
110 |
Window foreground colour; resource |
|
|
111 |
__foreground__. |
|
|
112 |
|
|
|
113 |
|
|
|
114 |
__-pixmap:__ ''file[[;geom]'' |
|
|
115 |
|
|
|
116 |
|
|
|
117 |
Compile ''XPM'': Specify XPM file for the background and |
|
|
118 |
also optionally specify its scaling with a geometry string. |
|
|
119 |
Note you may need to add quotes to avoid special shell |
|
|
120 |
interpretation of the ``;'' in the command-line; resource |
|
|
121 |
__backgroundPixmap__. |
|
|
122 |
|
|
|
123 |
|
|
|
124 |
__-cr__ ''colour'' |
|
|
125 |
|
|
|
126 |
|
|
|
127 |
The cursor colour; resource __cursorColor__. |
|
|
128 |
|
|
|
129 |
|
|
|
130 |
__-pr__ ''colour'' |
|
|
131 |
|
|
|
132 |
|
|
|
133 |
The mouse pointer colour; resource |
|
|
134 |
__pointerColor__. |
|
|
135 |
|
|
|
136 |
|
|
|
137 |
__-bd__ ''colour'' |
|
|
138 |
|
|
|
139 |
|
|
|
140 |
The colour of the border between the xterm scrollbar and the |
|
|
141 |
text; resource __borderColor__. |
|
|
142 |
|
|
|
143 |
|
|
|
144 |
__-fn__ ''fontname'' |
|
|
145 |
|
|
|
146 |
|
|
|
147 |
Main normal text font; resource __font__. |
|
|
148 |
|
|
|
149 |
|
|
|
150 |
__-fb__ ''fontname'' |
|
|
151 |
|
|
|
152 |
|
|
|
153 |
Main bold text font; resource __boldFont__. |
|
|
154 |
|
|
|
155 |
|
|
|
156 |
__-fm__ ''fontname'' |
|
|
157 |
|
|
|
158 |
|
|
|
159 |
Main multicharacter font; resource |
|
|
160 |
__mfont__. |
|
|
161 |
|
|
|
162 |
|
|
|
163 |
__-km__ ''mode'' |
|
|
164 |
|
|
|
165 |
|
|
|
166 |
Multiple-character font-set encoding mode; __eucj__: EUC |
|
|
167 |
Japanese encoding. __sjis__: Shift JIS encoding; resource |
|
|
168 |
__multichar_encoding__. |
|
|
169 |
|
|
|
170 |
|
|
|
171 |
__-grk__ ''mode'' |
|
|
172 |
|
|
|
173 |
|
|
|
174 |
Greek keyboard translation; __iso__: ISO-8859 mapping. |
|
|
175 |
__ibm__: IBM-437 mapping; resource |
|
|
176 |
__greek_keyboard__. |
|
|
177 |
|
|
|
178 |
|
|
|
179 |
__-name__ ''name'' |
|
|
180 |
|
|
|
181 |
|
|
|
182 |
Specify the application name under which resources are to be |
|
|
183 |
obtained, rather than the default executable file name. Name |
|
|
184 |
should not contain ``.'' or ``*'' characters. Also sets the |
|
|
185 |
icon and title name. |
|
|
186 |
|
|
|
187 |
|
|
|
188 |
__-ls__|__+ls__ |
|
|
189 |
|
|
|
190 |
|
|
|
191 |
Start as a login-shell/sub-shell; resource |
|
|
192 |
__loginShell__. |
|
|
193 |
|
|
|
194 |
|
|
|
195 |
__-ut__|__+ut__ |
|
|
196 |
|
|
|
197 |
|
|
|
198 |
Compile ''utmp'': Inhibit/enable writing a utmp entry; |
|
|
199 |
resource __utmpInhibit__. |
|
|
200 |
|
|
|
201 |
|
|
|
202 |
__-vb__|__+vb__ |
|
|
203 |
|
|
|
204 |
|
|
|
205 |
Turn on/off visual bell on receipt of a bell character; |
|
|
206 |
resource __visualBell__. |
|
|
207 |
|
|
|
208 |
|
|
|
209 |
__-sb__|__+sb__ |
|
|
210 |
|
|
|
211 |
|
|
|
212 |
Turn on/off scrollbar; resource |
|
|
213 |
__scrollBar__. |
|
|
214 |
|
|
|
215 |
|
|
|
216 |
__-si__|__+si__ |
|
|
217 |
|
|
|
218 |
|
|
|
219 |
Turn on/off scroll-to-bottom on TTY output inhibit; resource |
|
|
220 |
__scrollTtyOutput__ has opposite effect. |
|
|
221 |
|
|
|
222 |
|
|
|
223 |
__-sk__|__+sk__ |
|
|
224 |
|
|
|
225 |
|
|
|
226 |
Turn on/off scroll-to-bottom on keypress; resource |
|
|
227 |
__scrollTtyKeypress__. |
|
|
228 |
|
|
|
229 |
|
|
|
230 |
__-sr__|__+sr__ |
|
|
231 |
|
|
|
232 |
|
|
|
233 |
Put scrollbar on right/left; resource |
|
|
234 |
__scrollBar_right__. |
|
|
235 |
|
|
|
236 |
|
|
|
237 |
__-st__|__+st__ |
|
|
238 |
|
|
|
239 |
|
|
|
240 |
Display normal (non XTerm/NeXT) scrollbar without/with a |
|
|
241 |
trough; resource __scrollBar_floating__. |
|
|
242 |
|
|
|
243 |
|
|
|
244 |
__-iconic__ |
|
|
245 |
|
|
|
246 |
|
|
|
247 |
Start iconified, if the window manager supports that option. |
|
|
248 |
Alternative form is __-ic__. |
|
|
249 |
|
|
|
250 |
|
|
|
251 |
__-sl__ ''number'' |
|
|
252 |
|
|
|
253 |
|
|
|
254 |
Save ''number'' lines in the scrollback buffer; resource |
|
|
255 |
__saveLines__. |
|
|
256 |
|
|
|
257 |
|
|
|
258 |
__-tn__ ''termname'' |
|
|
259 |
|
|
|
260 |
|
|
|
261 |
This option specifies the name of the terminal type to be |
|
|
262 |
set in the __TERM__ environment variable. This terminal |
|
|
263 |
type must exist in the ''termcap(5)'' database and should |
|
|
264 |
have ''li#'' and ''co#'' entries; resource |
|
|
265 |
__termName__. |
|
|
266 |
|
|
|
267 |
|
|
|
268 |
__-im__ ''method'' |
|
|
269 |
|
|
|
270 |
|
|
|
271 |
This option specifies the input method to use; resource |
|
|
272 |
__inputMethod__. |
|
|
273 |
|
|
|
274 |
|
|
|
275 |
__-e__ ''command [[arguments]'' |
|
|
276 |
|
|
|
277 |
|
|
|
278 |
Run the command with its command-line arguments in the |
|
|
279 |
__rxvt__ window; also sets the window title and icon name |
|
|
280 |
to be the basename of the program being executed if neither |
|
|
281 |
''-title'' (''-T'') nor ''-n'' are given on the |
|
|
282 |
command line. If this option is used, it must be the last on |
|
|
283 |
the command-line. If there is no __-e__ option then the |
|
|
284 |
default is to run the program specified by the __SHELL__ |
|
|
285 |
environment variable or, failing that, |
|
|
286 |
''sh(1)''. |
|
|
287 |
|
|
|
288 |
|
|
|
289 |
__-title__ ''text'' |
|
|
290 |
|
|
|
291 |
|
|
|
292 |
Window title (__-T__ still respected); the default title |
|
|
293 |
is the basename of the program specified after the __-e__ |
|
|
294 |
option, if any, otherwise the application name; resource |
|
|
295 |
__title__. |
|
|
296 |
|
|
|
297 |
|
|
|
298 |
__-n__ ''text'' |
|
|
299 |
|
|
|
300 |
|
|
|
301 |
Icon name; the default name is the basename of the program |
|
|
302 |
specified after the __-e__ option, if any, otherwise the |
|
|
303 |
application name; resource __iconName__. |
|
|
304 |
|
|
|
305 |
|
|
|
306 |
__-C__ |
|
|
307 |
|
|
|
308 |
|
|
|
309 |
Capture system console messages. |
|
|
310 |
|
|
|
311 |
|
|
|
312 |
__-pt__ ''style'' |
|
|
313 |
|
|
|
314 |
|
|
|
315 |
Compile ''XIM'': input style for input method; |
2 |
perry |
316 |
__!OverTheSpot__, __!OffTheSpot__, __Root__; resource |
1 |
perry |
317 |
__preeditType__. |
|
|
318 |
|
|
|
319 |
|
|
|
320 |
__-im__ ''text'' |
|
|
321 |
|
|
|
322 |
|
|
|
323 |
Compile ''XIM'': input method name. resource |
|
|
324 |
__inputMethod__. |
|
|
325 |
|
|
|
326 |
|
|
|
327 |
__-mod__ ''modifier'' |
|
|
328 |
|
|
|
329 |
|
|
|
330 |
Override detection of Meta modifier with specified key: |
|
|
331 |
__alt__, __meta__, __hyper__, __super__, |
|
|
332 |
__mod1__, __mod2__, __mod3__, __mod4__, |
|
|
333 |
__mod5__; resource ''modifier''. |
|
|
334 |
|
|
|
335 |
|
|
|
336 |
__-xrm__ ''resourcestring'' |
|
|
337 |
|
|
|
338 |
|
|
|
339 |
No effect on rxvt. Simply passes through an argument to be |
|
|
340 |
made available in the instance's argument list. Appears in |
|
|
341 |
''WM_COMMAND'' in some window managers. |
|
|
342 |
!!RESOURCES (available also as long-options) |
|
|
343 |
|
|
|
344 |
|
|
|
345 |
Note: ``rxvt --help'' gives a list of all resources (long |
|
|
346 |
options) compiled into your version. If compiled with |
|
|
347 |
internal Xresources support (i.e. __rxvt -h__ lists |
|
|
348 |
__.Xdefaults__) then __rxvt__ accepts application |
|
|
349 |
defaults set in XAPPLOADDIR/Rxvt (compile-time defined: |
|
|
350 |
usually __/usr/lib/X11/app-defaults/Rxvt__) and resources |
|
|
351 |
set in __~/.Xdefaults__, or __~/.Xresources__ if |
|
|
352 |
__~/.Xdefaults__ does not exist. Note that when reading X |
|
|
353 |
resources, __rxvt__ recognizes two class names: |
|
|
354 |
__XTerm__ and __Rxvt__. The class name __XTerm__ |
|
|
355 |
allows resources common to both __rxvt__ and ''xterm'' |
|
|
356 |
to be easily configured, while the class name __Rxvt__ |
|
|
357 |
allows resources unique to __rxvt__, notably colours and |
|
|
358 |
key-handling, to be shared between different __rxvt__ |
|
|
359 |
configurations. If no resources are specified, suitable |
|
|
360 |
defaults will be used. Command-line arguments can be used to |
|
|
361 |
override resource settings. The following resources are |
|
|
362 |
allowed: |
|
|
363 |
|
|
|
364 |
|
|
|
365 |
__geometry:__ ''geom'' |
|
|
366 |
|
|
|
367 |
|
|
|
368 |
Create the window with the specified X window geometry |
|
|
369 |
[[default 80x24]; option __-geometry__. |
|
|
370 |
|
|
|
371 |
|
|
|
372 |
__background:__ ''colour'' |
|
|
373 |
|
|
|
374 |
|
|
|
375 |
Use the specified colour as the window's background colour |
|
|
376 |
[[default White]; option __-bg__. |
|
|
377 |
|
|
|
378 |
|
|
|
379 |
__foreground:__ ''colour'' |
|
|
380 |
|
|
|
381 |
|
|
|
382 |
Use the specified colour as the window's foreground colour |
|
|
383 |
[[default Black]; option __-fg__. |
|
|
384 |
|
|
|
385 |
|
|
|
386 |
__color__''n''__:__ ''colour'' |
|
|
387 |
|
|
|
388 |
|
|
|
389 |
Use the specified colour for the colour value ''n'', |
|
|
390 |
where 0-7 corresponds to low-intensity (normal) colours and |
|
|
391 |
8-15 corresponds to high-intensity (bold = bright |
|
|
392 |
foreground, blink = bright background) colours. The |
|
|
393 |
canonical names are as follows: 0=black, 1=red, 2=green, |
|
|
394 |
3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white, but the actual |
|
|
395 |
colour names used are listed in the __COLORS AND |
|
|
396 |
GRAPHICS__ section. |
|
|
397 |
|
|
|
398 |
|
|
|
399 |
__colorBD:__ ''colour'' |
|
|
400 |
|
|
|
401 |
|
|
|
402 |
Use the specified colour to display bold characters when the |
|
|
403 |
foreground colour is the default. |
|
|
404 |
|
|
|
405 |
|
|
|
406 |
__colorUL:__ ''colour'' |
|
|
407 |
|
|
|
408 |
|
|
|
409 |
Use the specified colour to display underlined characters |
|
|
410 |
when the foreground colour is the default. |
|
|
411 |
|
|
|
412 |
|
|
|
413 |
__cursorColor:__ ''colour'' |
|
|
414 |
|
|
|
415 |
|
|
|
416 |
Use the specified colour for the cursor. The default is to |
|
|
417 |
use the foreground colour; option __-cr__. |
|
|
418 |
|
|
|
419 |
|
|
|
420 |
__cursorColor2:__ ''colour'' |
|
|
421 |
|
|
|
422 |
|
|
|
423 |
Use the specified colour for the colour of the cursor text. |
|
|
424 |
For this to take effect, __cursorColor__ must also be |
|
|
425 |
specified. The default is to use the background |
|
|
426 |
colour. |
|
|
427 |
|
|
|
428 |
|
|
|
429 |
__reverseVideo:__ ''boolean'' |
|
|
430 |
|
|
|
431 |
|
|
|
432 |
__True__: simulate reverse video by foreground and |
|
|
433 |
background colours; option __-rv__, __False__: regular |
|
|
434 |
screen colours [[default]; option __+rv__. See note in |
|
|
435 |
__COLORS AND GRAPHICS__ section. |
|
|
436 |
|
|
|
437 |
|
|
|
438 |
__inheritPixmap:__ ''boolean'' |
|
|
439 |
|
|
|
440 |
|
|
|
441 |
__True__: make the background inherit the parent windows' |
|
|
442 |
pixmap, giving artificial transparency. __False__: do not |
|
|
443 |
inherit the parent windows' pixmap. |
|
|
444 |
|
|
|
445 |
|
|
|
446 |
__scrollColor:__ ''colour'' |
|
|
447 |
|
|
|
448 |
|
|
|
449 |
Use the specified colour for the scrollbar [[default |
|
|
450 |
#B2B2B2]. |
|
|
451 |
|
|
|
452 |
|
|
|
453 |
__troughColor:__ ''colour'' |
|
|
454 |
|
|
|
455 |
|
|
|
456 |
Use the specified colour for the scrollbar's trough area |
|
|
457 |
[[default #969696]. Only relevant for normal (non XTerm/NeXT) |
|
|
458 |
scrollbar. |
|
|
459 |
|
|
|
460 |
|
|
|
461 |
__backgroundPixmap:__ ''file[[;geom]'' |
|
|
462 |
|
|
|
463 |
|
|
|
464 |
Use the specified XPM file (note the ``.xpm'' extension is |
|
|
465 |
optional) for the background and also optionally specify its |
|
|
466 |
scaling with a geometry string __WxH+X+Y__, in which |
|
|
467 |
__``W'' / ``H''__ specify the horizontal/vertical scale |
|
|
468 |
(percent) and __``X'' / ``Y''__ locate the image centre |
|
|
469 |
(percent). A scale of 0 displays the image with tiling. A |
|
|
470 |
scale of 1 displays the image without any scaling. A scale |
|
|
471 |
of 2 to 9 specifies an integer number of images in that |
|
|
472 |
direction. No image will be magnified beyond 10 times its |
|
|
473 |
original size. The maximum permitted scale is 1000. [[default |
|
|
474 |
0x0+50+50] |
|
|
475 |
|
|
|
476 |
|
|
|
477 |
__menu:__ ''file[[;tag]'' |
|
|
478 |
|
|
|
479 |
|
|
|
480 |
Read in the specified menu file (note the ``.menu'' |
|
|
481 |
extension is optional) and also optionally specify a |
|
|
482 |
starting tag to find. See the reference documentation for |
|
|
483 |
details on the syntax for the menuBar. |
|
|
484 |
|
|
|
485 |
|
|
|
486 |
__path:__ ''path'' |
|
|
487 |
|
|
|
488 |
|
|
|
489 |
Specify the colon-delimited search path for finding files |
|
|
490 |
(XPM and menus), in addition to the paths specified by the |
|
|
491 |
__RXVTPATH__ and __PATH__ environment |
|
|
492 |
variables. |
|
|
493 |
|
|
|
494 |
|
|
|
495 |
__font:__ ''fontname'' |
|
|
496 |
|
|
|
497 |
|
|
|
498 |
Select the main text font used [[default 7x14]; option |
|
|
499 |
__-fn__. |
|
|
500 |
|
|
|
501 |
|
|
|
502 |
__font__''n''__:__ ''fontname'' |
|
|
503 |
|
|
|
504 |
|
|
|
505 |
Specify the alternative font ''n''. The default font |
|
|
506 |
values: |
|
|
507 |
|
|
|
508 |
|
|
|
509 |
__boldFont:__ ''fontname'' |
|
|
510 |
|
|
|
511 |
|
|
|
512 |
Specify the name of the bold font to use if __colorBD__ |
|
|
513 |
has not been specified and it is not possible to map the |
|
|
514 |
default foreground colour to colour 8-15 [[default NONE]. |
|
|
515 |
This font must be the same height and width as the normal |
|
|
516 |
font; option __-fb__. |
|
|
517 |
|
|
|
518 |
|
|
|
519 |
__mfont:__ ''fontname'' |
|
|
520 |
|
|
|
521 |
|
|
|
522 |
Select the main multiple-character text font used [[default |
|
|
523 |
k14]; option __-fk__. |
|
|
524 |
|
|
|
525 |
|
|
|
526 |
__mfont__''n''__:__ ''fontname'' |
|
|
527 |
|
|
|
528 |
|
|
|
529 |
Specify the alternative multiple-character font ''n''. If |
|
|
530 |
compiled for multiple-character fonts, the Roman and |
|
|
531 |
multiple-character font sizes should match. |
|
|
532 |
|
|
|
533 |
|
|
|
534 |
__multichar_encoding:__ ''mode'' |
|
|
535 |
|
|
|
536 |
|
|
|
537 |
Set the encoding mode to be used when multicharacter |
|
|
538 |
encoding is received; __eucj__: EUC Japanese encoding |
|
|
539 |
[[default for Kanji]. __sjis__: Shift JIS encoding. |
|
|
540 |
__big5__: BIG5 encoding. __gb__: GB encoding; option |
|
|
541 |
__-km__. |
|
|
542 |
|
|
|
543 |
|
|
|
544 |
__greek_keyboard:__ ''mode'' |
|
|
545 |
|
|
|
546 |
|
|
|
547 |
Set the Greek keyboard translation mode to be used; |
|
|
548 |
__iso__: ISO-8859 mapping (elot-928) [[default]. |
|
|
549 |
__ibm__: IBM-437 mapping (DOS codepage 737); option |
|
|
550 |
__-grk__. Use __Mode_switch__ to toggle keyboard |
|
|
551 |
input. For more details, see the distributed file |
|
|
552 |
__README.greek__. |
|
|
553 |
|
|
|
554 |
|
|
|
555 |
__selectstyle:__ ''text'' |
|
|
556 |
|
|
|
557 |
|
|
|
558 |
Set mouse selection style to __old__ which is 2.20, |
|
|
559 |
__oldword__ which is xterm style with 2.20 old word |
|
|
560 |
selection, or anything else which gives xterm style |
|
|
561 |
selection. |
|
|
562 |
|
|
|
563 |
|
|
|
564 |
__title:__ ''text'' |
|
|
565 |
|
|
|
566 |
|
|
|
567 |
Set window title string, the default title is the |
|
|
568 |
command-line specified after the __-e__ option, if any, |
|
|
569 |
otherwise the application name; option |
|
|
570 |
__-title__. |
|
|
571 |
|
|
|
572 |
|
|
|
573 |
__iconName:__ ''text'' |
|
|
574 |
|
|
|
575 |
|
|
|
576 |
Set the name used to label the window's icon or displayed in |
|
|
577 |
an icon manager window, it also sets the window's title |
|
|
578 |
unless it is explicitly set; option __-n__. |
|
|
579 |
|
|
|
580 |
|
|
|
581 |
__mapAlert:__ ''boolean'' |
|
|
582 |
|
|
|
583 |
|
|
|
584 |
__True__: de-iconify (map) on receipt of a bell |
|
|
585 |
character. __False__: no de-iconify (map) on receipt of a |
|
|
586 |
bell character [[default]. |
|
|
587 |
|
|
|
588 |
|
|
|
589 |
__visualBell:__ ''boolean'' |
|
|
590 |
|
|
|
591 |
|
|
|
592 |
__True__: use visual bell on receipt of a bell character; |
|
|
593 |
option __-vb__. __False__: no visual bell [[default]; |
|
|
594 |
option __+vb__. |
|
|
595 |
|
|
|
596 |
|
|
|
597 |
__loginShell:__ ''boolean'' |
|
|
598 |
|
|
|
599 |
|
|
|
600 |
__True__: start as a login shell by prepending a ``-'' to |
|
|
601 |
__argv[[0]__ of the shell; option __-ls__. |
|
|
602 |
__False__: start as a normal sub-shell [[default]; option |
|
|
603 |
__+ls__. |
|
|
604 |
|
|
|
605 |
|
|
|
606 |
__utmpInhibit:__ ''boolean'' |
|
|
607 |
|
|
|
608 |
|
|
|
609 |
__True__: inhibit writing record into the system log file |
|
|
610 |
__utmp__; option __-ut__. __False__: write record |
|
|
611 |
into the system log file __utmp__ [[default]; option |
|
|
612 |
__+ut__. |
|
|
613 |
|
|
|
614 |
|
|
|
615 |
__print-pipe:__ ''string'' |
|
|
616 |
|
|
|
617 |
|
|
|
618 |
Specify a command pipe for vt100 printer [[default |
|
|
619 |
''lpr(1)'']. Use __Print__ to initiate a screen dump |
|
|
620 |
to the printer and __Ctrl-Print__ or __Shift-Print__ |
|
|
621 |
to include the scrollback as well. |
|
|
622 |
|
|
|
623 |
|
|
|
624 |
__scrollBar:__ ''boolean'' |
|
|
625 |
|
|
|
626 |
|
|
|
627 |
__True__: enable the scrollbar [[default]; option |
|
|
628 |
__-sb__. __False__: disable the scrollbar; option |
|
|
629 |
__+sb__. |
|
|
630 |
|
|
|
631 |
|
|
|
632 |
__scrollBar_right:__ ''boolean'' |
|
|
633 |
|
|
|
634 |
|
|
|
635 |
__True__: place the scrollbar on the right of the window; |
|
|
636 |
option __-sr__. __False__: place the scrollbar on the |
|
|
637 |
left of the window; option __+sr__. |
|
|
638 |
|
|
|
639 |
|
|
|
640 |
__scrollBar_floating:__ ''boolean'' |
|
|
641 |
|
|
|
642 |
|
|
|
643 |
__True__: display an rxvt scrollbar without a trough; |
|
|
644 |
option __-st__. __False__: display an rxvt scrollbar |
|
|
645 |
with a trough; option __+st__. |
|
|
646 |
|
|
|
647 |
|
|
|
648 |
__scrollTtyOutput:__ ''boolean'' |
|
|
649 |
|
|
|
650 |
|
|
|
651 |
__True__: scroll to bottom when tty receives output; |
|
|
652 |
option(+si). __False__: do not scroll to bottom when tty |
|
|
653 |
receives output; option(-si). |
|
|
654 |
|
|
|
655 |
|
|
|
656 |
__scrollTtyKeypress:__ ''boolean'' |
|
|
657 |
|
|
|
658 |
|
|
|
659 |
__True__: scroll to bottom when a non-special key is |
|
|
660 |
pressed. Special keys are those which are intercepted by |
|
|
661 |
rxvt for special handling and are not passed onto the shell; |
|
|
662 |
option(-sk). __False__: do not scroll to bottom when a |
|
|
663 |
non-special key is pressed; option(+sk). |
|
|
664 |
|
|
|
665 |
|
|
|
666 |
__smallfont_key:__ ''keysym'' |
|
|
667 |
|
|
|
668 |
|
|
|
669 |
If enabled, use __Alt-__''keysym'' to toggle to a |
|
|
670 |
smaller font [[default __Alt-__] |
|
|
671 |
|
|
|
672 |
|
|
|
673 |
__bigfont_key:__ ''keysym'' |
|
|
674 |
|
|
|
675 |
|
|
|
676 |
If enabled, use __Alt-__''keysym'' to toggle to a |
|
|
677 |
bigger font [[default __Alt-__] |
|
|
678 |
|
|
|
679 |
|
|
|
680 |
__saveLines:__ ''number'' |
|
|
681 |
|
|
|
682 |
|
|
|
683 |
Save ''number'' lines in the scrollback buffer [[default |
|
|
684 |
64]; option __-sl__. |
|
|
685 |
|
|
|
686 |
|
|
|
687 |
__termName:__ ''termname'' |
|
|
688 |
|
|
|
689 |
|
|
|
690 |
Specifies the terminal type name to be set in the |
|
|
691 |
__TERM__ environment variable; option |
|
|
692 |
__-tn__. |
|
|
693 |
|
|
|
694 |
|
|
|
695 |
__inputMethod:__ ''method'' |
|
|
696 |
|
|
|
697 |
|
|
|
698 |
Specifies the input method to use; option |
|
|
699 |
__-im__. |
|
|
700 |
|
|
|
701 |
|
|
|
702 |
__meta8:__ ''boolean'' |
|
|
703 |
|
|
|
704 |
|
|
|
705 |
__True__: handle Meta (Alt) + keypress to set the 8th |
|
|
706 |
bit. __False__: handle Meta (Alt) + keypress as an escape |
|
|
707 |
prefix [[default]. |
|
|
708 |
|
|
|
709 |
|
|
|
710 |
__backspacekey:__ ''string'' |
|
|
711 |
|
|
|
712 |
|
|
|
713 |
The string to send when the backspace key is pressed. If set |
|
|
714 |
to __DEC__ or unset it will send __Delete__ (code 127) |
|
|
715 |
or, if shifted, __Backspace__ (code 8) - which can be |
|
|
716 |
reversed with the appropriate DEC private mode escape |
|
|
717 |
sequence. |
|
|
718 |
|
|
|
719 |
|
|
|
720 |
__deletekey:__ ''string'' |
|
|
721 |
|
|
|
722 |
|
|
|
723 |
The string to send when the delete key (not the keypad |
|
|
724 |
delete key) is pressed. If unset it will send the sequence |
|
|
725 |
traditionally associated with the __Execute__ |
|
|
726 |
key. |
|
|
727 |
|
|
|
728 |
|
|
|
729 |
__cutchars:__ ''string'' |
|
|
730 |
|
|
|
731 |
|
|
|
732 |
The characters used as delimiters for double-click word |
|
|
733 |
selection. The built-in default:__ |
|
|
734 |
BACKSLASH |
|
|
735 |
` |
|
|
736 |
|
|
|
737 |
|
|
|
738 |
__preeditType:__ ''style'' |
|
|
739 |
|
|
|
740 |
|
2 |
perry |
741 |
__!OverTheSpot__, __!OffTheSpot__, __Root__; option |
1 |
perry |
742 |
__-pt__. |
|
|
743 |
|
|
|
744 |
|
|
|
745 |
__inputMethod:__ ''name'' |
|
|
746 |
|
|
|
747 |
|
|
|
748 |
''name'' of inputMethod to use; option |
|
|
749 |
__-im__. |
|
|
750 |
|
|
|
751 |
|
|
|
752 |
__modifier:__ ''modifier'' |
|
|
753 |
|
|
|
754 |
|
|
|
755 |
Set the key to be interpreted as the Meta key to: |
|
|
756 |
__alt__, __meta__, __hyper__, __super__, |
|
|
757 |
__mod1__, __mod2__, __mod3__, __mod4__, |
|
|
758 |
__mod5__; option __-mod__. |
|
|
759 |
|
|
|
760 |
|
|
|
761 |
__keysym.__''sym'': ''string'' |
|
|
762 |
|
|
|
763 |
|
|
|
764 |
Associate ''string'' with keysym ''sym'' (__0xFF00 - |
|
|
765 |
0xFFFF__). It may contain escape values (a: bell, b: |
|
|
766 |
backspace, e, E: escape, n: newline, r: return, t: tab, 000: |
|
|
767 |
octal number) or control characters (^?: delete, ^@: null, |
|
|
768 |
^A ...) and may enclosed with double quotes so that it can |
|
|
769 |
start or end with whitespace. The intervening resource name |
|
|
770 |
__keysym.__ cannot be omitted. This resource is only |
|
|
771 |
available when compiled with KEYSYM_RESOURCE. |
|
|
772 |
!!THE SCROLLBAR |
|
|
773 |
|
|
|
774 |
|
|
|
775 |
Lines of text that scroll off the top of the __rxvt__ |
|
|
776 |
window (resource: __saveLines__) and can be scrolled back |
|
|
777 |
using the scrollbar or by keystrokes. The normal __rxvt__ |
|
|
778 |
scrollbar has arrows and its behaviour is fairly intuitive. |
|
|
779 |
The __xterm-scrollbar__ is without arrows and its |
|
|
780 |
behaviour mimics that of ''xterm'' |
|
|
781 |
|
|
|
782 |
|
|
|
783 |
Scroll down with __Button1__ (__xterm-scrollbar__) or |
|
|
784 |
__Shift-Next__. Scroll up with __Button3__ |
|
|
785 |
(__xterm-scrollbar__) or __Shift-Prior__. Continuous |
|
|
786 |
scroll with __Button2__. |
|
|
787 |
!!MOUSE REPORTING |
|
|
788 |
|
|
|
789 |
|
|
|
790 |
To temporarily override mouse reporting, for either the |
|
|
791 |
scrollbar or the normal text selection/insertion, hold |
|
|
792 |
either the Shift or the Meta (Alt) key while performing the |
|
|
793 |
desired mouse action. |
|
|
794 |
|
|
|
795 |
|
|
|
796 |
If mouse reporting mode is active, the normal scrollbar |
|
|
797 |
actions are disabled -- on the assumption that we are using |
|
|
798 |
a fullscreen application. Instead, pressing Button1 and |
|
|
799 |
Button3 sends __ESC[[6~__ (Next) and __ESC[[5~__ |
|
|
800 |
(Prior), respectively. Similarly, clicking on the up and |
|
|
801 |
down arrows sends __ESC[[A__ (Up) and __ESC[[B__ (Down), |
|
|
802 |
respectively. |
|
|
803 |
!!TEXT SELECTION AND INSERTION |
|
|
804 |
|
|
|
805 |
|
|
|
806 |
The behaviour of text selection and insertion mechanism is |
|
|
807 |
similar to xterm(1). |
|
|
808 |
|
|
|
809 |
|
|
|
810 |
__Selection__: |
|
|
811 |
|
|
|
812 |
|
|
|
813 |
Left click at the beginning of the region, drag to the end |
|
|
814 |
of the region and release; Right click to extend the marked |
|
|
815 |
region; Left double-click to select a word; Left |
|
|
816 |
triple-click to select the entire line. |
|
|
817 |
|
|
|
818 |
|
|
|
819 |
__Insertion__: |
|
|
820 |
|
|
|
821 |
|
|
|
822 |
Pressing and releasing the Middle mouse button (or |
|
|
823 |
__Shift-Insert__) in an __rxvt__ window causes the |
|
|
824 |
current text selection to be inserted as if it had been |
|
|
825 |
typed on the keyboard. |
|
|
826 |
!!CHANGING FONTS |
|
|
827 |
|
|
|
828 |
|
|
|
829 |
You can change fonts on-the-fly, which is to say cycle |
|
|
830 |
through the default font and others of various sizes, by |
|
|
831 |
using __Shift-KP_Add__ and __Shift-KP_Subtract__. Or, |
|
|
832 |
alternatively (if enabled) with __Alt-__ and |
|
|
833 |
__Alt-__, where the actual key can be selected using |
|
|
834 |
resources |
|
|
835 |
__smallfont_key__/__bigfont_key__. |
|
|
836 |
!!LOGIN STAMP |
|
|
837 |
|
|
|
838 |
|
|
|
839 |
__rxvt__ tries to write an entry into the utmp(5) |
|
|
840 |
file so that it can be seen via the ''who(1)'' command, |
|
|
841 |
and can accept messages. To allow this feature, __rxvt__ |
|
|
842 |
must be installed setuid root on some systems. |
|
|
843 |
!!COLORS AND GRAPHICS |
|
|
844 |
|
|
|
845 |
|
|
|
846 |
If graphics support was enabled at compile-time, __rxvt__ |
|
|
847 |
can be queried with ANSI escape sequences and can address |
|
|
848 |
individual pixels instead of text characters. Note the |
|
|
849 |
graphics support is still considered beta code. |
|
|
850 |
|
|
|
851 |
|
|
|
852 |
In addition to the default foreground and background |
|
|
853 |
colours, __rxvt__ can display up to 16 colours (8 ANSI |
|
|
854 |
colours plus high-intensity bold/blink versions of the |
|
|
855 |
same). Here is a list of the colours with their |
|
|
856 |
__rgb.txt__ names. |
|
|
857 |
|
|
|
858 |
|
|
|
859 |
It is also possible to specify the colour values of __foreground__, __background__, __cursorColor__, __cursorColor2__, __colorBD__, __colorUL__ as a number 0-15, as a convenient shorthand to reference the colour name of color0-color15. |
|
|
860 |
|
|
|
861 |
|
|
|
862 |
Note that __-rv__ (__``reverseVideo: True''__) |
|
|
863 |
simulates reverse video by always swapping the |
|
|
864 |
foreground/background colours. This is in contrast to |
|
|
865 |
xterm(1) where the colours are only swapped if they |
|
|
866 |
have not otherwise been specified. For example, |
|
|
867 |
|
|
|
868 |
|
|
|
869 |
__rxvt -fg Black -bg White -rv__ |
|
|
870 |
|
|
|
871 |
|
|
|
872 |
would yield White on Black, while on xterm(1) it |
|
|
873 |
would yield Black on White. |
|
|
874 |
!!ENVIRONMENT |
|
|
875 |
|
|
|
876 |
|
|
|
877 |
__rxvt__ sets the environment variables __TERM__, |
|
|
878 |
__COLORTERM__ and __COLORFGBG__. The environment |
|
|
879 |
variable __WINDOWID__ is set to the X window id number of |
|
|
880 |
the __rxvt__ window and it also uses and sets the |
|
|
881 |
environment variable __DISPLAY__ to specify which display |
|
|
882 |
terminal to use. __rxvt__ uses the environment variables |
|
|
883 |
__RXVTPATH__ and __PATH__ to find XPM |
|
|
884 |
files. |
|
|
885 |
!!FILES |
|
|
886 |
|
|
|
887 |
|
|
|
888 |
__/etc/utmp__ |
|
|
889 |
|
|
|
890 |
|
|
|
891 |
System file for login records. |
|
|
892 |
|
|
|
893 |
|
|
|
894 |
__/usr/lib/X11/rgb.txt__ |
|
|
895 |
|
|
|
896 |
|
|
|
897 |
Color names. |
|
|
898 |
!!DEBIAN NOTES |
|
|
899 |
|
|
|
900 |
|
|
|
901 |
The standard Debian __rxvt__ package provides two |
|
|
902 |
versions of the __rxvt__ binary: |
|
|
903 |
|
|
|
904 |
|
|
|
905 |
__rxvt-xterm__ |
|
|
906 |
|
|
|
907 |
|
|
|
908 |
This version is compiled with no XPM support. It has been |
|
|
909 |
configured to be a smaller, more efficient xterm |
|
|
910 |
substitute. |
|
|
911 |
|
|
|
912 |
|
|
|
913 |
__rxvt-xpm__ |
|
|
914 |
|
|
|
915 |
|
|
|
916 |
This version is compiled with XPM and menu |
|
|
917 |
support. |
|
|
918 |
!!SEE ALSO |
|
|
919 |
|
|
|
920 |
|
|
|
921 |
xterm(1), sh(1), resize(1), |
|
|
922 |
''X''(1), pty(4), tty(4), |
|
|
923 |
utmp(5) |
|
|
924 |
|
|
|
925 |
|
|
|
926 |
See rxvtRef.html rxvtRef.txt for detailed information on |
|
|
927 |
recognized escape sequences and menuBar syntax, |
|
|
928 |
etc. |
|
|
929 |
!!BUGS |
|
|
930 |
|
|
|
931 |
|
|
|
932 |
Check the BUGS file for an up-to-date list. |
|
|
933 |
|
|
|
934 |
|
|
|
935 |
Cursor change support is not yet implemented. |
|
|
936 |
|
|
|
937 |
|
|
|
938 |
Click-and-drag doesn't work with X11 mouse report |
|
|
939 |
overriding. |
|
|
940 |
|
|
|
941 |
|
|
|
942 |
Graphics support is fairly crude. |
|
|
943 |
!!FTP LOCATION |
|
|
944 |
|
|
|
945 |
|
|
|
946 |
rxvt-2.6.4.tar.gz can be found at the following ftp sites |
|
|
947 |
ftp://ftp.rxvt.org/pub/rxvt |
|
|
948 |
!!CURRENT PROJECT COORDINATOR |
|
|
949 |
|
|
|
950 |
|
|
|
951 |
Project Coordinator |
|
|
952 |
|
|
|
953 |
|
|
|
954 |
Geoff Wing |
|
|
955 |
|
|
|
956 |
|
|
|
957 |
Web page maintainter |
|
|
958 |
|
|
|
959 |
|
|
|
960 |
Oezguer Kesim |
|
|
961 |
|
|
|
962 |
|
|
|
963 |
Mailing list |
|
|
964 |
|
|
|
965 |
|
|
|
966 |
The Rxvt Workers |
|
|
967 |
!!AUTHORS |
|
|
968 |
|
|
|
969 |
|
|
|
970 |
John Bovey |
|
|
971 |
|
|
|
972 |
|
|
|
973 |
University of Kent, 1992, wrote the original |
|
|
974 |
Xvt. |
|
|
975 |
|
|
|
976 |
|
|
|
977 |
Rob Nation |
|
|
978 |
|
|
|
979 |
|
|
|
980 |
very heavily modified Xvt and came up with Rxvt |
|
|
981 |
|
|
|
982 |
|
|
|
983 |
Angelo Haritsis |
|
|
984 |
|
|
|
985 |
|
|
|
986 |
wrote the Greek Keyboard Input |
|
|
987 |
|
|
|
988 |
|
|
|
989 |
mj olesen |
|
|
990 |
|
|
|
991 |
|
|
|
992 |
Wrote the menu system. |
|
|
993 |
Project Coordinator (changes.txt 2.11 to 2.21) |
|
|
994 |
|
|
|
995 |
|
|
|
996 |
Oezguer Kesim |
|
|
997 |
|
|
|
998 |
|
|
|
999 |
Project Coordinator (changes.txt 2.21a to |
|
|
1000 |
2.4.5) |
|
|
1001 |
|
|
|
1002 |
|
|
|
1003 |
Geoff Wing |
|
|
1004 |
|
|
|
1005 |
|
|
|
1006 |
Rewrote screen display and text selection routines. |
|
|
1007 |
Project Coordinator (changes.txt 2.4.6 - ) |
|
|
1008 |
---- |