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