ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.1
Revision: 1.4
Committed: Sun Feb 22 12:58:01 2004 UTC (20 years, 4 months ago) by pcg
Branch: MAIN
CVS Tags: rel-1_9, rel-2_0, rxvt-2-0, rel-1-9
Changes since 1.3: +0 -2 lines
Log Message:
*** empty log message ***

File Contents

# Content
1 .if !\n(.g .ab GNU tbl requires GNU troff.
2 .if !dTS .ds TS
3 .if !dTE .ds TE
4 .TH "RXVT" "1" "RXVTDATE()" "X Version 11" "X Tools"
5 .SH "NAME"
6 rxvt (ouR XVT) \- a VT102 emulator for the X window system
7 .PP
8 .SH "SYNOPSIS"
9 .PP
10 \fBrxvt\fP [options] [-e command [ args ]]
11 .PP
12 .SH "DESCRIPTION"
13 .PP
14 \fBrxvt\fP, version \fBRXVTVERSION()\fP, is a colour vt102 terminal emulator
15 intended as an \fIxterm\fP(1) replacement for users who do not require
16 features such as Tektronix 4014 emulation and toolkit-style configurability\&.
17 As a result, \fBrxvt\fP uses much less swap space -- a significant
18 advantage on a machine serving many X sessions\&.
19 .PP
20 .PP
21 .SH "OPTIONS"
22 .PP
23 The \fBrxvt\fP options (mostly a subset of \fIxterm\fP\&'s) are listed below\&.
24 In keeping with the smaller-is-better philosophy, options may be eliminated
25 or default values chosen at compile-time, so options and defaults listed
26 may not accurately reflect the version installed on your system\&.
27 `rxvt -h\&' gives a list of major compile-time options on the \fIOptions\fP line\&.
28 Option descriptions may be prefixed with which compile option each is
29 dependent upon\&. e\&.g\&. `Compile \fIXIM\fP:\&' requires \fIXIM\fP on the \fIOptions\fP
30 line\&. Note: `rxvt -help\&' gives a list of all command-line options compiled
31 into your version\&.
32 .PP
33 Note that \fBrxvt\fP permits the resource name to be used as a long-option
34 (--/++ option) so the potential command-line options are far greater than
35 those listed\&.
36 For example: `rxvt --loginShell --color1 Orange\&'\&.
37 .PP
38 The following options are available:
39 .PP
40 .IP "\fB-help\fP, \fB--help\fP"
41 Print out a message describing available options\&.
42 .IP "\fB-display\fP \fIdisplayname\fP"
43 Attempt to open a window on the named X display (\fB-d\fP still
44 respected)\&. In the absence of this option, the display specified
45 by the \fBDISPLAY\fP environment variable is used\&.
46 .IP "\fB-geometry\fP \fIgeom\fP"
47 Window geometry (\fB-g\fP still respected);
48 resource \fBgeometry\fP\&.
49 .IP "\fB-rv\fP|\fB+rv\fP"
50 Turn on/off simulated reverse video;
51 resource \fBreverseVideo\fP\&.
52 .IP "\fB-j\fP|\fB+j\fP"
53 Turn on/off jump scrolling;
54 resource \fBjumpScroll\fP\&.
55 .IP "\fB-ip\fP|\fB+ip\fP"
56 Turn on/off inheriting parent window\&'s pixmap\&. Alternative form
57 is \fB-tr\fP;
58 resource \fBinheritPixmap\fP\&.
59 .IP "\fB-bg\fP \fIcolour\fP"
60 Window background colour;
61 resource \fBbackground\fP\&.
62 .IP "\fB-fg\fP \fIcolour\fP"
63 Window foreground colour;
64 resource \fBforeground\fP\&.
65 .IP "\fB-pixmap:\fP \fIfile[;geom]\fP"
66 Compile \fIXPM\fP: Specify XPM file for the background and also
67 optionally specify its scaling with a geometry string\&. Note you
68 may need to add quotes to avoid special shell interpretation of
69 the `;\&' in the command-line;
70 resource \fBbackgroundPixmap\fP\&.
71 .IP "\fB-cr\fP \fIcolour\fP"
72 The cursor colour;
73 resource \fBcursorColor\fP\&.
74 .IP "\fB-pr\fP \fIcolour\fP"
75 The mouse pointer colour;
76 resource \fBpointerColor\fP\&.
77 .IP "\fB-bd\fP \fIcolour\fP"
78 The colour of the border between the xterm scrollbar and the text;
79 resource \fBborderColor\fP\&.
80 .IP "\fB-fn\fP \fIfontname\fP"
81 Select the fonts to be used used\&. This is a comma seperated
82 list of font names that are used in turn when trying to display
83 unicode characters\&. The first font defines the cell size for characters,
84 pther fonts might be smaller, but not larger\&. A reasonable default list
85 is appended\&.
86 resource \fBfont\fP\&.
87 .IP "\fB-name\fP \fIname\fP"
88 Specify the application name under which resources
89 are to be obtained, rather than the default executable file name\&.
90 Name should not contain `\&.\&' or `*\&' characters\&.
91 Also sets the icon and title name\&.
92 .IP "\fB-ls\fP|\fB+ls\fP"
93 Start as a login-shell/sub-shell;
94 resource \fBloginShell\fP\&.
95 .IP "\fB-ut\fP|\fB+ut\fP"
96 Compile \fIutmp\fP: Inhibit/enable writing a utmp entry;
97 resource \fButmpInhibit\fP\&.
98 .IP "\fB-vb\fP|\fB+vb\fP"
99 Turn on/off visual bell on receipt of a bell character;
100 resource \fBvisualBell\fP\&.
101 .IP "\fB-sb\fP|\fB+sb\fP"
102 Turn on/off scrollbar;
103 resource \fBscrollBar\fP\&.
104 .IP "\fB-si\fP|\fB+si\fP"
105 Turn on/off scroll-to-bottom on TTY output inhibit;
106 resource \fBscrollTtyOutput\fP has opposite effect\&.
107 .IP "\fB-sk\fP|\fB+sk\fP"
108 Turn on/off scroll-to-bottom on keypress;
109 resource \fBscrollTtyKeypress\fP\&.
110 .IP "\fB-sw\fP|\fB+sw\fP"
111 Turn on/off scrolling with the scrollback buffer as new
112 lines appear\&. This only takes effect if \fB-si\fP is also given;
113 resource \fBscrollWithBuffer\fP\&.
114 .IP "\fB-sr\fP|\fB+sr\fP"
115 Put scrollbar on right/left;
116 resource \fBscrollBar_right\fP\&.
117 .IP "\fB-st\fP|\fB+st\fP"
118 Display normal (non XTerm/NeXT) scrollbar without/with a trough;
119 resource \fBscrollBar_floating\fP\&.
120 .IP "\fB-mcc\fP|\fB+mcc\fP"
121 Compile \fImultichar_languages\fP: treat multibyte glyphs as single
122 character for backspace, delete and cursor movement keys;
123 resource \fBmultibyte_cursor\fP\&.
124 .IP "\fB-bc\fP|\fB+bc\fP"
125 Blink the cursor; resource \fBcursorBlink\fP\&.
126 .IP "\fB-iconic\fP"
127 Start iconified, if the window manager supports that option\&.
128 Alternative form is \fB-ic\fP\&.
129 .IP "\fB-sl\fP \fInumber\fP"
130 Save \fInumber\fP lines in the scrollback buffer\&. See resource entry
131 for limits;
132 resource \fBsaveLines\fP\&.
133 .IP "\fB-b\fP \fInumber\fP"
134 Compile \fIfrills\fP: Internal border of \fInumber\fP pixels\&. See
135 resource entry for limits;
136 resource \fBinternalBorder\fP\&.
137 .IP "\fB-w\fP \fInumber\fP"
138 Compile \fIfrills\fP: External border of \fInumber\fP pixels\&.
139 Also, \fB-bw\fP and \fB-borderwidth\fP\&. See resource entry for limits;
140 resource \fBexternalBorder\fP\&.
141 .IP "\fB-lsp\fP \fInumber\fP"
142 Compile \fIlinespace\fP: Lines (pixel height) to insert between each
143 row of the display;
144 resource \fBlinespace\fP\&.
145 .IP "\fB-tn\fP \fItermname\fP"
146 This option specifies the name of the terminal type to be set in the
147 \fBTERM\fP environment variable\&. This terminal type must exist in the
148 \fItermcap(5)\fP database and should have \fIli#\fP and \fIco#\fP entries;
149 resource \fBtermName\fP\&.
150 .IP "\fB-e\fP \fIcommand [arguments]\fP"
151 Run the command with its command-line arguments in the \fBrxvt\fP
152 window; also sets the window title and icon name to be the basename
153 of the program being executed if neither \fI-title\fP (\fI-T\fP) nor
154 \fI-n\fP are given on the command line\&. If this option is used, it
155 must be the last on the command-line\&. If there is no \fB-e\fP option
156 then the default is to run the program specified by the \fBSHELL\fP
157 environment variable or, failing that, \fIsh(1)\fP\&.
158 .IP "\fB-title\fP \fItext\fP"
159 Window title (\fB-T\fP still respected); the default title is the
160 basename of the program specified after the \fB-e\fP option, if
161 any, otherwise the application name;
162 resource \fBtitle\fP\&.
163 .IP "\fB-n\fP \fItext\fP"
164 Icon name; the default name is the basename of the program specified
165 after the \fB-e\fP option, if any, otherwise the application name;
166 resource \fBiconName\fP\&.
167 .IP "\fB-C\fP"
168 Capture system console messages\&.
169 .IP "\fB-pt\fP \fIstyle\fP"
170 Compile \fIXIM\fP: input style for input method;
171 \fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP;
172 resource \fBpreeditType\fP\&.
173 .IP "\fB-im\fP \fItext\fP"
174 Compile \fIXIM\fP: input method name\&.
175 resource \fBinputMethod\fP\&.
176 .IP "\fB-imlocale\fP \fIstring\fP"
177 The locale to use for opening the IM\&. You can use an LC_CTYPE
178 of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP
179 for the input extension to be able to input japanese characters
180 while staying in another locale\&.
181 .IP "\fB-mod\fP \fImodifier\fP"
182 Override detection of Meta modifier with specified key:
183 \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP,
184 \fBmod4\fP, \fBmod5\fP;
185 resource \fImodifier\fP\&.
186 .IP "\fB-xrm\fP \fIresourcestring\fP"
187 No effect on rxvt\&. Simply passes through an argument to be made
188 available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP
189 in some window managers\&.
190 .SH "RESOURCES (available also as long-options)"
191 .PP
192 Note: `rxvt --help\&' gives a list of all resources (long options) compiled
193 into your version\&.
194 If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists
195 \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application defaults set in
196 XAPPLOADDIR/Rxvt (compile-time defined: usually
197 \fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP,
198 or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when
199 reading X resources, \fBrxvt\fP recognizes two class names: \fBXTerm\fP and
200 \fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both
201 \fBrxvt\fP and \fIxterm\fP to be easily configured, while the class name
202 \fBRxvt\fP allows resources unique to \fBrxvt\fP, notably colours and
203 key-handling, to be shared between different \fBrxvt\fP configurations\&.
204 If no resources are specified, suitable defaults will be used\&.
205 Command-line arguments can be used to override resource settings\&. The
206 following resources are allowed:
207 .PP
208 .IP "\fBgeometry:\fP \fIgeom\fP"
209 Create the window with the specified X window geometry [default
210 80x24];
211 option \fB-geometry\fP\&.
212 .IP "\fBbackground:\fP \fIcolour\fP"
213 Use the specified colour as the window\&'s background colour [default
214 White];
215 option \fB-bg\fP\&.
216 .IP "\fBforeground:\fP \fIcolour\fP"
217 Use the specified colour as the window\&'s foreground colour [default
218 Black];
219 option \fB-fg\fP\&.
220 .IP "\fBcolor\fP\fIn\fP\fB:\fP \fIcolour\fP"
221 Use the specified colour for the colour value \fIn\fP, where 0-7
222 corresponds to low-intensity (normal) colours and 8-15 corresponds to
223 high-intensity (bold = bright foreground, blink = bright
224 background) colours\&. The canonical names are as follows:
225 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white,
226 but the actual colour names used are listed in the
227 \fBCOLORS AND GRAPHICS\fP section\&.
228 .IP "\fBcolorBD:\fP \fIcolour\fP"
229 Use the specified colour to display bold characters when the
230 foreground colour is the default\&.
231 .IP "\fBcolorUL:\fP \fIcolour\fP"
232 Use the specified colour to display underlined characters when the
233 foreground colour is the default\&.
234 .IP "\fBcolorRV:\fP \fIcolour\fP"
235 Use the specified colour as the background for reverse video
236 characters\&.
237 .IP "\fBcursorColor:\fP \fIcolour\fP"
238 Use the specified colour for the cursor\&. The default is to use the
239 foreground colour;
240 option \fB-cr\fP\&.
241 .IP "\fBcursorColor2:\fP \fIcolour\fP"
242 Use the specified colour for the colour of the cursor text\&. For this
243 to take effect, \fBcursorColor\fP must also be specified\&. The default
244 is to use the background colour\&.
245 .IP "\fBreverseVideo:\fP \fIboolean\fP"
246 \fBTrue\fP: simulate reverse video by foreground and background colours;
247 option \fB-rv\fP\&.
248 \fBFalse\fP: regular screen colours [default];
249 option \fB+rv\fP\&.
250 See note in \fBCOLORS AND GRAPHICS\fP section\&.
251 .IP "\fBjumpScroll:\fP \fIboolean\fP"
252 \fBTrue\fP: specify that jump scrolling should be used\&. When scrolling
253 quickly, fewer screen updates are performed [default];
254 option \fB-j\fP\&.
255 \fBFalse\fP: specify that smooth scrolling should be used;
256 option \fB+j\fP\&.
257 .IP "\fBinheritPixmap:\fP \fIboolean\fP"
258 \fBTrue\fP: make the background inherit the parent windows\&' pixmap,
259 giving artificial transparency\&.
260 \fBFalse\fP: do not inherit the parent windows\&' pixmap\&.
261 .IP "\fBscrollColor:\fP \fIcolour\fP"
262 Use the specified colour for the scrollbar [default #B2B2B2]\&.
263 .IP "\fBtroughColor:\fP \fIcolour\fP"
264 Use the specified colour for the scrollbar\&'s trough area [default
265 #969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&.
266 .IP "\fBbackgroundPixmap:\fP \fIfile[;geom]\fP"
267 Use the specified XPM file (note the `\&.xpm\&' extension is optional)
268 for the background and also optionally specify its scaling with a
269 geometry string \fBWxH+X+Y\fP, in which \fB"W" / "H"\fP specify the
270 horizontal/vertical scale (percent) and \fB"X" / "Y"\fP locate the
271 image centre (percent)\&. A scale of 0 displays the image with tiling\&.
272 A scale of 1 displays the image without any scaling\&. A scale of 2 to
273 9 specifies an integer number of images in that direction\&. No image
274 will be magnified beyond 10 times its original size\&. The maximum
275 permitted scale is 1000\&. [default 0x0+50+50]
276 .IP "\fBmenu:\fP \fIfile[;tag]\fP"
277 Read in the specified menu file (note the `\&.menu\&' extension is
278 optional) and also optionally specify a starting tag to find\&. See
279 the reference documentation for details on the syntax for the menuBar\&.
280 .IP "\fBpath:\fP \fIpath\fP"
281 Specify the colon-delimited search path for finding files (XPM and
282 menus), in addition to the paths specified by the \fBRXVTPATH\fP and
283 \fBPATH\fP environment variables\&.
284 .IP "\fBfont:\fP \fIfontname\fP"
285 Select the fonts to be used used\&. This is a comma seperated
286 list of font names that are used in turn when trying to display
287 unicode characters\&. The first font defines the cell size for characters,
288 pther fonts might be smaller, but not larger\&. A reasonable default list
289 is appended\&.
290 option \fB-fn\fP\&.
291 .IP "\fBselectstyle:\fP \fImode\fP"
292 Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which
293 is xterm style with 2\&.20 old word selection, or anything else which
294 gives xterm style selection\&.
295 .IP "\fBscrollstyle:\fP \fImode\fP"
296 Set scrollbar style to \fBrxvt\fP, \fBnext\fP or \fBxterm\fP
297 .IP "\fBtitle:\fP \fIstring\fP"
298 Set window title string, the default title is the command-line
299 specified after the \fB-e\fP option, if any, otherwise the application
300 name;
301 option \fB-title\fP\&.
302 .IP "\fBiconName:\fP \fIstring\fP"
303 Set the name used to label the window\&'s icon or displayed in an icon
304 manager window, it also sets the window\&'s title unless it is
305 explicitly set;
306 option \fB-n\fP\&.
307 .IP "\fBmapAlert:\fP \fIboolean\fP"
308 \fBTrue\fP: de-iconify (map) on receipt of a bell character\&.
309 \fBFalse\fP: no de-iconify (map) on receipt of a bell character
310 [default]\&.
311 .IP "\fBvisualBell:\fP \fIboolean\fP"
312 \fBTrue\fP: use visual bell on receipt of a bell character;
313 option \fB-vb\fP\&.
314 \fBFalse\fP: no visual bell [default];
315 option \fB+vb\fP\&.
316 .IP "\fBloginShell:\fP \fIboolean\fP"
317 \fBTrue\fP: start as a login shell by prepending a `-\&' to \fBargv[0]\fP
318 of the shell;
319 option \fB-ls\fP\&.
320 \fBFalse\fP: start as a normal sub-shell [default];
321 option \fB+ls\fP\&.
322 .IP "\fButmpInhibit:\fP \fIboolean\fP"
323 \fBTrue\fP: inhibit writing record into the system log file \fButmp\fP;
324 option \fB-ut\fP\&.
325 \fBFalse\fP: write record into the system log file \fButmp\fP [default];
326 option \fB+ut\fP\&.
327 .IP "\fBprint-pipe:\fP \fIstring\fP"
328 Specify a command pipe for vt100 printer [default \fIlpr(1)\fP]\&. Use
329 \fBPrint\fP to initiate a screen dump to the printer and \fBCtrl-Print\fP
330 or \fBShift-Print\fP to include the scrollback as well\&.
331 .IP "\fBscrollBar:\fP \fIboolean\fP"
332 \fBTrue\fP: enable the scrollbar [default];
333 option \fB-sb\fP\&.
334 \fBFalse\fP: disable the scrollbar;
335 option \fB+sb\fP\&.
336 .IP "\fBscrollBar_right:\fP \fIboolean\fP"
337 \fBTrue\fP: place the scrollbar on the right of the window;
338 option \fB-sr\fP\&.
339 \fBFalse\fP: place the scrollbar on the left of the window;
340 option \fB+sr\fP\&.
341 .IP "\fBscrollBar_floating:\fP \fIboolean\fP"
342 \fBTrue\fP: display an rxvt scrollbar without a trough;
343 option \fB-st\fP\&.
344 \fBFalse\fP: display an rxvt scrollbar with a trough;
345 option \fB+st\fP\&.
346 .IP "\fBscrollBar_align:\fP \fImode\fP"
347 Align the \fBtop\fP, \fBbottom\fP or \fBcentre\fP [default] of
348 the scrollbar thumb with the pointer on middle button
349 press/drag\&.
350 .IP "\fBscrollTtyOutput:\fP \fIboolean\fP"
351 \fBTrue\fP: scroll to bottom when tty receives output;
352 option(+si)\&.
353 \fBFalse\fP: do not scroll to bottom when tty receives output;
354 option(-si)\&.
355 .IP "\fBscrollWithBuffer:\fP \fIboolean\fP"
356 \fBTrue\fP: scroll with scrollback buffer when tty recieves
357 new lines (and \fBscrollTtyOutput\fP is False);
358 option(+sw)\&.
359 \fBFalse\fP: do not scroll with scrollback buffer when tty
360 recieves new lines;
361 option(-sw)\&.
362 .IP "\fBscrollTtyKeypress:\fP \fIboolean\fP"
363 \fBTrue\fP: scroll to bottom when a non-special key is pressed\&.
364 Special keys are those which are intercepted by rxvt for special
365 handling and are not passed onto the shell;
366 option(-sk)\&.
367 \fBFalse\fP: do not scroll to bottom when a non-special key is pressed;
368 option(+sk)\&.
369 .IP "\fBsmallfont_key:\fP \fIkeysym\fP"
370 If enabled, use \fBAlt-\fP\fIkeysym\fP to toggle to a smaller font
371 [default \fBAlt-<\fP]
372 .IP "\fBbigfont_key:\fP \fIkeysym\fP"
373 If enabled, use \fBAlt-\fP\fIkeysym\fP to toggle to a bigger font
374 [default \fBAlt->\fP]
375 .IP "\fBsaveLines:\fP \fInumber\fP"
376 Save \fInumber\fP lines in the scrollback buffer [default 64]\&. This
377 resource is limited on most machines to 65535;
378 option \fB-sl\fP\&.
379 .IP "\fBinternalBorder:\fP \fInumber\fP"
380 Internal border of \fInumber\fP pixels\&. This resource is limited to 100;
381 option \fB-b\fP\&.
382 .IP "\fBexternalBorder:\fP \fInumber\fP"
383 External border of \fInumber\fP pixels\&. This resource is limited to 100;
384 option \fB-w\fP, \fB-bw\fP, \fB-borderwidth\fP\&.
385 .IP "\fBtermName:\fP \fItermname\fP"
386 Specifies the terminal type name to be set in the \fBTERM\fP
387 environment variable;
388 option \fB-tn\fP\&.
389 .IP "\fBlinespace:\fP \fInumber\fP"
390 Specifies number of lines (pixel height) to insert between each row
391 of the display [default 0];
392 option \fB-lsp\fP\&.
393 .IP "\fBmeta8:\fP \fIboolean\fP"
394 \fBTrue\fP: handle Meta (Alt) + keypress to set the 8th bit\&.
395 \fBFalse\fP: handle Meta (Alt) + keypress as an escape prefix [default]\&.
396 .IP "\fBmouseWheelScrollPage:\fP \fIboolean\fP"
397 \fBTrue\fP: the mouse wheel scrolls a page full\&.
398 \fBFalse\fP: the mouse wheel scrolls five lines [default]\&.
399 .IP "\fBcursorBlink:\fP \fIboolean\fP"
400 \fBTrue\fP: blink the cursor\&.
401 \fBFalse\fP: do not blink the cursor [default];
402 option \fB-bc\fP\&.
403 .IP "\fBpointerBlank:\fP \fIboolean\fP"
404 \fBTrue\fP: blank the pointer when a key is pressed or after a set number
405 of seconds of inactivity\&.
406 \fBFalse\fP: the pointer is always visible [default]\&.
407 .IP "\fBpointerBlankDelay:\fP \fInumber\fP"
408 Specifies number of seconds before blanking the pointer [default 2]\&.
409 .IP "\fBmultibyte_cursor:\fP \fIboolean\fP"
410 \fBTrue\fP: consider multibyte glyphs as single character for backspace,
411 delete and cursor movement keys;
412 option \fB-mcc\fP\&.
413 \fBFalse\fP: move through all components of all glyphs;
414 option \fB+mcc\fP\&.
415 .IP "\fBbackspacekey:\fP \fIstring\fP"
416 The string to send when the backspace key is pressed\&. If set to
417 \fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted,
418 \fBBackspace\fP (code 8) - which can be reversed with the appropriate
419 DEC private mode escape sequence\&.
420 .IP "\fBdeletekey:\fP \fIstring\fP"
421 The string to send when the delete key (not the keypad delete key) is
422 pressed\&. If unset it will send the sequence traditionally associated
423 with the \fBExecute\fP key\&.
424 .IP "\fBcutchars:\fP \fIstring\fP"
425 The characters used as delimiters for double-click word selection\&.
426 The built-in default:
427 .br
428 \fBBACKSLASH `"\&'&()*,;<=>?@[]{|}\fP
429 .IP "\fBpreeditType:\fP \fIstyle\fP"
430 \fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP;
431 option \fB-pt\fP\&.
432 .IP "\fBinputMethod:\fP \fIname\fP"
433 \fIname\fP of inputMethod to use;
434 option \fB-im\fP\&.
435 .IP "\fBimLocale:\fP \fIname\fP"
436 The locale to use for opening the IM\&. You can use an LC_CTYPE
437 of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP
438 for the input extension to be able to input japanese characters
439 while staying in another locale\&.
440 option \fB-imlocale\fP\&.
441 .IP "\fBmodifier:\fP \fImodifier\fP"
442 Set the key to be interpreted as the Meta key to:
443 \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP,
444 \fBmod4\fP, \fBmod5\fP;
445 option \fB-mod\fP\&.
446 .IP "\fBanswerbackString:\fP \fIstring\fP"
447 Specify the reply rxvt sends to the shell when an ENQ (control-E)
448 character is passed through\&. It may contain escape values as
449 described in the entry on \fBkeysym\fP following\&.
450 .IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP"
451 Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It
452 may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape,
453 \en: newline, \er: return, \et: tab, \e000: octal number) or control
454 characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with
455 double quotes so that it can start or end with whitespace\&. The
456 intervening resource name \fBkeysym\&.\fP cannot be omitted\&. This
457 resource is only available when compiled with KEYSYM_RESOURCE\&.
458 .SH "THE SCROLLBAR"
459 .PP
460 Lines of text that scroll off the top of the \fBrxvt\fP window (resource:
461 \fBsaveLines\fP) and can be scrolled back using the scrollbar or by keystrokes\&.
462 The normal \fBrxvt\fP scrollbar has arrows and its behaviour is fairly
463 intuitive\&. The \fBxterm-scrollbar\fP is without arrows and its behaviour
464 mimics that of \fIxterm\fP
465 .PP
466 Scroll down with \fBButton1\fP (\fBxterm-scrollbar\fP) or \fBShift-Next\fP\&.
467 Scroll up with \fBButton3\fP (\fBxterm-scrollbar\fP) or \fBShift-Prior\fP\&.
468 Continuous scroll with \fBButton2\fP\&.
469 .SH "MOUSE REPORTING"
470 .PP
471 To temporarily override mouse reporting, for either the scrollbar or the
472 normal text selection/insertion, hold either the Shift or the Meta (Alt) key
473 while performing the desired mouse action\&.
474 .PP
475 If mouse reporting mode is active, the normal scrollbar actions are disabled
476 -- on the assumption that we are using a fullscreen application\&.
477 Instead, pressing Button1 and Button3 sends
478 \fBESC[6~\fP (Next) and \fBESC[5~\fP (Prior), respectively\&.
479 Similarly, clicking on the up and down arrows sends \fBESC[A\fP (Up) and
480 \fBESC[B\fP (Down), respectively\&.
481 .SH "TEXT SELECTION AND INSERTION"
482 .PP
483 The behaviour of text selection and insertion mechanism is similar to
484 \fIxterm\fP(1)\&.
485 .PP
486 .IP "\fBSelection\fP:"
487 Left click at the beginning of the region, drag to the end of the
488 region and release; Right click to extend the marked region;
489 Left double-click to select a word; Left triple-click to select
490 the entire line\&.
491 .IP "\fBInsertion\fP:"
492 Pressing and releasing the Middle mouse button (or \fBShift-Insert\fP)
493 in an \fBrxvt\fP window causes the current text selection to be inserted
494 as if it had been typed on the keyboard\&.
495 .SH "CHANGING FONTS"
496 .PP
497 You can change fonts on-the-fly, which is to say cycle through the default
498 font and others of various sizes, by using \fBShift-KP_Add\fP and
499 \fBShift-KP_Subtract\fP\&. Or, alternatively (if enabled) with
500 \fBAlt->\fP and \fBAlt-<\fP, where the actual key
501 can be selected using resources \fBsmallfont_key\fP/\fBbigfont_key\fP\&.
502 .SH "LOGIN STAMP"
503 .PP
504 \fBrxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be
505 seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this
506 feature, \fBrxvt\fP must be installed setuid root on some systems\&.
507 .SH "COLORS AND GRAPHICS"
508 .PP
509 In addition to the default foreground and background colours, \fBrxvt\fP
510 can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink
511 versions of the same)\&.
512 Here is a list of the colours with their \fBrgb\&.txt\fP names\&.
513 .PP
514 .TS
515 .nr 3c \n(.C
516 .cp 0
517 .nr 3lps \n[.s]
518 .nr 3cent \n[.ce]
519 .de 3init
520 .ft \n[.f]
521 .ps \n[.s]
522 .vs \n[.v]u
523 .in \n[.i]u
524 .ll \n[.l]u
525 .ls \n[.L]
526 .ad \n[.j]
527 .ie \n[.u] .fi
528 .el .nf
529 .ce \n[.ce]
530 ..
531 .nr 3ind \n[.i]
532 .nr 3fnt \n[.f]
533 .nr 3sz \n[.s]
534 .nr 3fll \n[.u]
535 .nr T. 0
536 .nr 3crow 0-1
537 .nr 3passed 0-1
538 .nr 3sflag 0
539 .ds 3trans
540 .ds 3quote
541 .nr 3brule 1
542 .nr 3supbot 0
543 .eo
544 .de 3rmk
545 .mk \$1
546 .if !'\n(.z'' \!.3rmk "\$1"
547 ..
548 .de 3rvpt
549 .vpt \$1
550 .if !'\n(.z'' \!.3rvpt "\$1"
551 ..
552 .de 3keep
553 .if '\n[.z]'' \{.ds 3quote \\
554 .ds 3trans \!
555 .di 3section
556 .nr 3sflag 1
557 .in 0
558 .\}
559 ..
560 .de 3release
561 .if \n[3sflag] \{.di
562 .in \n[3ind]u
563 .nr 3dn \n[dn]
564 .ds 3quote
565 .ds 3trans
566 .nr 3sflag 0
567 .if \n[.t]<=\n[dn] \{.nr T. 1
568 .T#
569 .nr 3supbot 1
570 .sp \n[.t]u
571 .nr 3supbot 0
572 .mk #T
573 .\}
574 .if \n[.t]<=\n[3dn] .tm warning: page \n%: table text block will not fit on one page
575 .nf
576 .ls 1
577 .3section
578 .ls
579 .rm 3section
580 .\}
581 ..
582 .nr 3tflag 0
583 .de 3tkeep
584 .if '\n[.z]'' \{.di 3table
585 .nr 3tflag 1
586 .\}
587 ..
588 .de 3trelease
589 .if \n[3tflag] \{.br
590 .di
591 .nr 3dn \n[dn]
592 .ne \n[dn]u+\n[.V]u
593 .ie \n[.t]<=\n[3dn] .tm error: page \n%: table will not fit on one page; use .TS H/.TH with a supporting macro package
594 .el \{.in 0
595 .ls 1
596 .nf
597 .3table
598 .\}
599 .rm 3table
600 .\}
601 ..
602 .ec
603 .ce 0
604 .nf
605 .nr 3sep 1n
606 .nr 3w0 \n(.H
607 .nr 3aw0 0
608 .nr 3lnw0 0
609 .nr 3rnw0 0
610 .nr 3w1 \n(.H
611 .nr 3aw1 0
612 .nr 3lnw1 0
613 .nr 3rnw1 0
614 .nr 3w2 \n(.H
615 .nr 3aw2 0
616 .nr 3lnw2 0
617 .nr 3rnw2 0
618 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor0\fP \[tbl]
619 .nr 3w1 \n[3w1]>?\w\[tbl]\ (black) \[tbl]
620 .nr 3w2 \n[3w2]>?\w\[tbl]\ = Black \[tbl]
621 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor1\fP \[tbl]
622 .nr 3w1 \n[3w1]>?\w\[tbl]\ (red) \[tbl]
623 .nr 3w2 \n[3w2]>?\w\[tbl]\ = Red3 \[tbl]
624 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor2\fP \[tbl]
625 .nr 3w1 \n[3w1]>?\w\[tbl]\ (green) \[tbl]
626 .nr 3w2 \n[3w2]>?\w\[tbl]\ = Green3 \[tbl]
627 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor3\fP \[tbl]
628 .nr 3w1 \n[3w1]>?\w\[tbl]\ (yellow) \[tbl]
629 .nr 3w2 \n[3w2]>?\w\[tbl]\ = Yellow3 \[tbl]
630 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor4\fP \[tbl]
631 .nr 3w1 \n[3w1]>?\w\[tbl]\ (blue) \[tbl]
632 .nr 3w2 \n[3w2]>?\w\[tbl]\ = Blue3 \[tbl]
633 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor5\fP \[tbl]
634 .nr 3w1 \n[3w1]>?\w\[tbl]\ (magenta) \[tbl]
635 .nr 3w2 \n[3w2]>?\w\[tbl]\ = Magenta3 \[tbl]
636 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor6\fP \[tbl]
637 .nr 3w1 \n[3w1]>?\w\[tbl]\ (cyan) \[tbl]
638 .nr 3w2 \n[3w2]>?\w\[tbl]\ = Cyan3 \[tbl]
639 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor7\fP \[tbl]
640 .nr 3w1 \n[3w1]>?\w\[tbl]\ (white) \[tbl]
641 .nr 3w2 \n[3w2]>?\w\[tbl]\ = AntiqueWhite \[tbl]
642 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor8\fP \[tbl]
643 .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright black) \[tbl]
644 .nr 3w2 \n[3w2]>?\w\[tbl]\ = Grey25 \[tbl]
645 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor9\fP \[tbl]
646 .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright red) \[tbl]
647 .nr 3w2 \n[3w2]>?\w\[tbl]\ = Red \[tbl]
648 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor10\fP \[tbl]
649 .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright green) \[tbl]
650 .nr 3w2 \n[3w2]>?\w\[tbl]\ = Green \[tbl]
651 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor11\fP \[tbl]
652 .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright yellow) \[tbl]
653 .nr 3w2 \n[3w2]>?\w\[tbl]\ = Yellow \[tbl]
654 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor12\fP \[tbl]
655 .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright blue) \[tbl]
656 .nr 3w2 \n[3w2]>?\w\[tbl]\ = Blue \[tbl]
657 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor13\fP \[tbl]
658 .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright magenta) \[tbl]
659 .nr 3w2 \n[3w2]>?\w\[tbl]\ = Magenta \[tbl]
660 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor14\fP \[tbl]
661 .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright cyan) \[tbl]
662 .nr 3w2 \n[3w2]>?\w\[tbl]\ = Cyan \[tbl]
663 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor15\fP \[tbl]
664 .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright white) \[tbl]
665 .nr 3w2 \n[3w2]>?\w\[tbl]\ = White \[tbl]
666 .nr 3w0 \n[3w0]>?\w\[tbl]\fBforeground\fP \[tbl]
667 .nr 3w1 \n[3w1]>?\w\[tbl]\ \[tbl]
668 .nr 3w2 \n[3w2]>?\w\[tbl]\ = Black \[tbl]
669 .nr 3w0 \n[3w0]>?\w\[tbl]\fBbackground\fP \[tbl]
670 .nr 3w1 \n[3w1]>?\w\[tbl]\ \[tbl]
671 .nr 3w2 \n[3w2]>?\w\[tbl]\ = White \[tbl]
672 .nr 3w0 \n[3w0]>?(\n[3lnw0]+\n[3rnw0])
673 .if \n[3aw0] .nr 3w0 \n[3w0]>?(\n[3aw0]+2n)
674 .nr 3w1 \n[3w1]>?(\n[3lnw1]+\n[3rnw1])
675 .if \n[3aw1] .nr 3w1 \n[3w1]>?(\n[3aw1]+2n)
676 .nr 3w2 \n[3w2]>?(\n[3lnw2]+\n[3rnw2])
677 .if \n[3aw2] .nr 3w2 \n[3w2]>?(\n[3aw2]+2n)
678 .nr 3cd0 0
679 .nr 3cl0 0*\n[3sep]
680 .nr 3ce0 \n[3cl0]+\n[3w0]
681 .nr 3cl1 \n[3ce0]+(3*\n[3sep])
682 .nr 3cd1 \n[3ce0]+\n[3cl1]/2
683 .nr 3ce1 \n[3cl1]+\n[3w1]
684 .nr 3cl2 \n[3ce1]+(3*\n[3sep])
685 .nr 3cd2 \n[3ce1]+\n[3cl2]/2
686 .nr 3ce2 \n[3cl2]+\n[3w2]
687 .nr 3cd3 \n[3ce2]+(0*\n[3sep])
688 .nr TW \n[3cd3]
689 .if \n[3cent] \{.in +(u;\n[.l]-\n[.i]-\n[TW]/2>?-\n[.i])
690 .nr 3ind \n[.i]
691 .\}
692 .eo
693 .de T#
694 .if !\n[3supbot] \{.3rvpt 0
695 .mk 3vert
696 .ls 1
697 .ls
698 .nr 3passed \n[3crow]
699 .sp |\n[3vert]u
700 .3rvpt 1
701 .\}
702 ..
703 .ec
704 .fc 
705 .3keep
706 .3rmk 3rt0
707 \*[3trans].nr 3crow 0
708 .3keep
709 .mk 3rs0
710 .mk 3bot
711 .3rvpt 0
712 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
713 \&\h'|\n[3cl0]u'\fBcolor0\fP \h'|\n[3cl1]u'\ (black) \h'|\n[3cl2]u'\ = Black
714 .nr 3bot \n[3bot]>?\n[.d]
715 .sp |\n[3rs0]u
716 .3rvpt 1
717 .sp |\n[3bot]u
718 \*[3trans].nr 3brule 1
719 .3release
720 .3keep
721 .3rmk 3rt1
722 \*[3trans].nr 3crow 1
723 .3keep
724 .mk 3rs1
725 .mk 3bot
726 .3rvpt 0
727 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
728 \&\h'|\n[3cl0]u'\fBcolor1\fP \h'|\n[3cl1]u'\ (red) \h'|\n[3cl2]u'\ = Red3
729 .nr 3bot \n[3bot]>?\n[.d]
730 .sp |\n[3rs1]u
731 .3rvpt 1
732 .sp |\n[3bot]u
733 \*[3trans].nr 3brule 1
734 .3release
735 .3keep
736 .3rmk 3rt2
737 \*[3trans].nr 3crow 2
738 .3keep
739 .mk 3rs2
740 .mk 3bot
741 .3rvpt 0
742 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
743 \&\h'|\n[3cl0]u'\fBcolor2\fP \h'|\n[3cl1]u'\ (green) \h'|\n[3cl2]u'\ = Green3
744 .nr 3bot \n[3bot]>?\n[.d]
745 .sp |\n[3rs2]u
746 .3rvpt 1
747 .sp |\n[3bot]u
748 \*[3trans].nr 3brule 1
749 .3release
750 .3keep
751 .3rmk 3rt3
752 \*[3trans].nr 3crow 3
753 .3keep
754 .mk 3rs3
755 .mk 3bot
756 .3rvpt 0
757 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
758 \&\h'|\n[3cl0]u'\fBcolor3\fP \h'|\n[3cl1]u'\ (yellow) \h'|\n[3cl2]u'\ = Yellow3
759 .nr 3bot \n[3bot]>?\n[.d]
760 .sp |\n[3rs3]u
761 .3rvpt 1
762 .sp |\n[3bot]u
763 \*[3trans].nr 3brule 1
764 .3release
765 .3keep
766 .3rmk 3rt4
767 \*[3trans].nr 3crow 4
768 .3keep
769 .mk 3rs4
770 .mk 3bot
771 .3rvpt 0
772 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
773 \&\h'|\n[3cl0]u'\fBcolor4\fP \h'|\n[3cl1]u'\ (blue) \h'|\n[3cl2]u'\ = Blue3
774 .nr 3bot \n[3bot]>?\n[.d]
775 .sp |\n[3rs4]u
776 .3rvpt 1
777 .sp |\n[3bot]u
778 \*[3trans].nr 3brule 1
779 .3release
780 .3keep
781 .3rmk 3rt5
782 \*[3trans].nr 3crow 5
783 .3keep
784 .mk 3rs5
785 .mk 3bot
786 .3rvpt 0
787 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
788 \&\h'|\n[3cl0]u'\fBcolor5\fP \h'|\n[3cl1]u'\ (magenta) \h'|\n[3cl2]u'\ = Magenta3
789 .nr 3bot \n[3bot]>?\n[.d]
790 .sp |\n[3rs5]u
791 .3rvpt 1
792 .sp |\n[3bot]u
793 \*[3trans].nr 3brule 1
794 .3release
795 .3keep
796 .3rmk 3rt6
797 \*[3trans].nr 3crow 6
798 .3keep
799 .mk 3rs6
800 .mk 3bot
801 .3rvpt 0
802 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
803 \&\h'|\n[3cl0]u'\fBcolor6\fP \h'|\n[3cl1]u'\ (cyan) \h'|\n[3cl2]u'\ = Cyan3
804 .nr 3bot \n[3bot]>?\n[.d]
805 .sp |\n[3rs6]u
806 .3rvpt 1
807 .sp |\n[3bot]u
808 \*[3trans].nr 3brule 1
809 .3release
810 .3keep
811 .3rmk 3rt7
812 \*[3trans].nr 3crow 7
813 .3keep
814 .mk 3rs7
815 .mk 3bot
816 .3rvpt 0
817 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
818 \&\h'|\n[3cl0]u'\fBcolor7\fP \h'|\n[3cl1]u'\ (white) \h'|\n[3cl2]u'\ = AntiqueWhite
819 .nr 3bot \n[3bot]>?\n[.d]
820 .sp |\n[3rs7]u
821 .3rvpt 1
822 .sp |\n[3bot]u
823 \*[3trans].nr 3brule 1
824 .3release
825 .3keep
826 .3rmk 3rt8
827 \*[3trans].nr 3crow 8
828 .3keep
829 .mk 3rs8
830 .mk 3bot
831 .3rvpt 0
832 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
833 \&\h'|\n[3cl0]u'\fBcolor8\fP \h'|\n[3cl1]u'\ (bright black) \h'|\n[3cl2]u'\ = Grey25
834 .nr 3bot \n[3bot]>?\n[.d]
835 .sp |\n[3rs8]u
836 .3rvpt 1
837 .sp |\n[3bot]u
838 \*[3trans].nr 3brule 1
839 .3release
840 .3keep
841 .3rmk 3rt9
842 \*[3trans].nr 3crow 9
843 .3keep
844 .mk 3rs9
845 .mk 3bot
846 .3rvpt 0
847 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
848 \&\h'|\n[3cl0]u'\fBcolor9\fP \h'|\n[3cl1]u'\ (bright red) \h'|\n[3cl2]u'\ = Red
849 .nr 3bot \n[3bot]>?\n[.d]
850 .sp |\n[3rs9]u
851 .3rvpt 1
852 .sp |\n[3bot]u
853 \*[3trans].nr 3brule 1
854 .3release
855 .3keep
856 .3rmk 3rt10
857 \*[3trans].nr 3crow 10
858 .3keep
859 .mk 3rs10
860 .mk 3bot
861 .3rvpt 0
862 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
863 \&\h'|\n[3cl0]u'\fBcolor10\fP \h'|\n[3cl1]u'\ (bright green) \h'|\n[3cl2]u'\ = Green
864 .nr 3bot \n[3bot]>?\n[.d]
865 .sp |\n[3rs10]u
866 .3rvpt 1
867 .sp |\n[3bot]u
868 \*[3trans].nr 3brule 1
869 .3release
870 .3keep
871 .3rmk 3rt11
872 \*[3trans].nr 3crow 11
873 .3keep
874 .mk 3rs11
875 .mk 3bot
876 .3rvpt 0
877 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
878 \&\h'|\n[3cl0]u'\fBcolor11\fP \h'|\n[3cl1]u'\ (bright yellow) \h'|\n[3cl2]u'\ = Yellow
879 .nr 3bot \n[3bot]>?\n[.d]
880 .sp |\n[3rs11]u
881 .3rvpt 1
882 .sp |\n[3bot]u
883 \*[3trans].nr 3brule 1
884 .3release
885 .3keep
886 .3rmk 3rt12
887 \*[3trans].nr 3crow 12
888 .3keep
889 .mk 3rs12
890 .mk 3bot
891 .3rvpt 0
892 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
893 \&\h'|\n[3cl0]u'\fBcolor12\fP \h'|\n[3cl1]u'\ (bright blue) \h'|\n[3cl2]u'\ = Blue
894 .nr 3bot \n[3bot]>?\n[.d]
895 .sp |\n[3rs12]u
896 .3rvpt 1
897 .sp |\n[3bot]u
898 \*[3trans].nr 3brule 1
899 .3release
900 .3keep
901 .3rmk 3rt13
902 \*[3trans].nr 3crow 13
903 .3keep
904 .mk 3rs13
905 .mk 3bot
906 .3rvpt 0
907 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
908 \&\h'|\n[3cl0]u'\fBcolor13\fP \h'|\n[3cl1]u'\ (bright magenta) \h'|\n[3cl2]u'\ = Magenta
909 .nr 3bot \n[3bot]>?\n[.d]
910 .sp |\n[3rs13]u
911 .3rvpt 1
912 .sp |\n[3bot]u
913 \*[3trans].nr 3brule 1
914 .3release
915 .3keep
916 .3rmk 3rt14
917 \*[3trans].nr 3crow 14
918 .3keep
919 .mk 3rs14
920 .mk 3bot
921 .3rvpt 0
922 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
923 \&\h'|\n[3cl0]u'\fBcolor14\fP \h'|\n[3cl1]u'\ (bright cyan) \h'|\n[3cl2]u'\ = Cyan
924 .nr 3bot \n[3bot]>?\n[.d]
925 .sp |\n[3rs14]u
926 .3rvpt 1
927 .sp |\n[3bot]u
928 \*[3trans].nr 3brule 1
929 .3release
930 .3keep
931 .3rmk 3rt15
932 \*[3trans].nr 3crow 15
933 .3keep
934 .mk 3rs15
935 .mk 3bot
936 .3rvpt 0
937 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
938 \&\h'|\n[3cl0]u'\fBcolor15\fP \h'|\n[3cl1]u'\ (bright white) \h'|\n[3cl2]u'\ = White
939 .nr 3bot \n[3bot]>?\n[.d]
940 .sp |\n[3rs15]u
941 .3rvpt 1
942 .sp |\n[3bot]u
943 \*[3trans].nr 3brule 1
944 .3release
945 .3keep
946 .3rmk 3rt16
947 \*[3trans].nr 3crow 16
948 .3keep
949 .mk 3rs16
950 .mk 3bot
951 .3rvpt 0
952 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
953 \&\h'|\n[3cl0]u'\fBforeground\fP \h'|\n[3cl1]u'\ \h'|\n[3cl2]u'\ = Black
954 .nr 3bot \n[3bot]>?\n[.d]
955 .sp |\n[3rs16]u
956 .3rvpt 1
957 .sp |\n[3bot]u
958 \*[3trans].nr 3brule 1
959 .3release
960 .3keep
961 .3rmk 3rt17
962 \*[3trans].nr 3crow 17
963 .3keep
964 .mk 3rs17
965 .mk 3bot
966 .3rvpt 0
967 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
968 \&\h'|\n[3cl0]u'\fBbackground\fP \h'|\n[3cl1]u'\ \h'|\n[3cl2]u'\ = White
969 .nr 3bot \n[3bot]>?\n[.d]
970 .sp |\n[3rs17]u
971 .3rvpt 1
972 .sp |\n[3bot]u
973 \*[3trans].nr 3brule 1
974 .3release
975 .mk 3rt18
976 .nr 3brule 1
977 .nr T. 1
978 .T#
979 .3init
980 .fc
981 .cp \n(3c
982 .TE
983 .PP
984 It is also possible to specify the colour values of \fBforeground\fP,
985 \fBbackground\fP, \fBcursorColor\fP, \fBcursorColor2\fP, \fBcolorBD\fP, \fBcolorUL\fP
986 as a number 0-15, as a convenient shorthand to reference the colour name of
987 color0-color15\&.
988 .PP
989 Note that \fB-rv\fP (\fB"reverseVideo: True"\fP) simulates reverse video by
990 always swapping the foreground/background colours\&. This is in contrast to
991 \fIxterm\fP(1) where the colours are only swapped if they have not otherwise been
992 specified\&.
993 For example,
994 .PP
995 .IP "\fBrxvt -fg Black -bg White -rv\fP"
996 would yield White on Black, while on \fIxterm\fP(1) it would yield
997 Black on White\&.
998 .SH "ENVIRONMENT"
999 .PP
1000 \fBrxvt\fP sets the environment variables \fBTERM\fP, \fBCOLORTERM\fP and
1001 \fBCOLORFGBG\fP\&. The environment variable \fBWINDOWID\fP is set to the X window
1002 id number of the \fBrxvt\fP window and it also uses and sets the environment
1003 variable \fBDISPLAY\fP to specify which display terminal to use\&. \fBrxvt\fP uses
1004 the environment variables \fBRXVTPATH\fP and \fBPATH\fP to find XPM files\&.
1005 .SH "FILES"
1006 .PP
1007 .IP "\fB/etc/utmp\fP"
1008 System file for login records\&.
1009 .IP "\fB/usr/lib/X11/rgb\&.txt\fP"
1010 Color names\&.
1011 .PP
1012 .SH "SEE ALSO"
1013 .PP
1014 \fIxterm\fP(1), \fIsh\fP(1), \fIresize\fP(1), \fIX\fP(1), \fIpty\fP(4), \fItty\fP(4),
1015 \fIutmp\fP(5)
1016 .PP
1017 See rxvtRef\&.html rxvtRef\&.txt for detailed information on recognized escape
1018 sequences and menuBar syntax, etc\&.
1019 .PP
1020 .SH "BUGS"
1021 .PP
1022 Check the BUGS file for an up-to-date list\&.
1023 .PP
1024 Cursor change support is not yet implemented\&.
1025 .PP
1026 Click-and-drag doesn\&'t work with X11 mouse report overriding\&.
1027 .PP
1028 .SH "FTP LOCATION"
1029 .PP
1030 rxvt-+RXVTVERSION()\&.tar\&.gz can be found at the following ftp sites
1031 RXVTFTPSITE()
1032 .PP
1033 .SH "CURRENT PROJECT COORDINATOR"
1034 .PP
1035 .IP "Project Coordinator"
1036 RXVTMAINT() RXVTMAINTEMAIL()
1037 .br
1038 .IP "Web page maintainter"
1039 RXVTWEBMAINT() RXVTWEBMAINTEMAIL()
1040 .br
1041 RXVTWEBPAGE()
1042 .br
1043 .IP "Mailing list"
1044 The Rxvt Workers <rxvt-workers@rxvt\&.org>
1045 mailing list has also been established for rxvt development, to
1046 subscribe, email to
1047 <rxvt-workers-subscribe@rxvt\&.org>\&.
1048 There is also a mailing list for announcements of new releases of
1049 rxvt\&. To subscribe, email to
1050 <rxvt-announce-subscribe@rxvt\&.org>\&.
1051 .PP
1052 .SH "AUTHORS"
1053 .PP
1054 .IP "John Bovey"
1055 University of Kent, 1992, wrote the original Xvt\&.
1056 .IP "Rob Nation <nation@rocket\&.sanders\&.lockheed\&.com>"
1057 very heavily modified Xvt and came up with Rxvt
1058 .IP "Angelo Haritsis <ah@doc\&.ic\&.ac\&.uk>"
1059 wrote the Greek Keyboard Input (no longer in code)
1060 .IP "mj olesen <olesen@me\&.QueensU\&.CA>"
1061 Wrote the menu system\&.
1062 .br
1063 Project Coordinator (changes\&.txt 2\&.11 to 2\&.21)
1064 .IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>"
1065 Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5)
1066 .IP "Geoff Wing <gcw@pobox\&.com>"
1067 Rewrote screen display and text selection routines\&.
1068 Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode)
1069 .IP "Marc Alexander Lehman <rxvt@schmorp\&.de>"
1070 Rewrote most of the display code and internal character handling
1071 to store text in unicode\&. Numerous other fixes and extensions\&.
1072 .br
1073 Project Coordinator (Changes 1\&.0 - )
1074 .PP