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