version 2, including all changes.
.
| Rev |
Author |
# |
Line |
| 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 |
---- |