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