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