ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.1
Revision: 1.2
Committed: Thu Dec 18 00:38:07 2003 UTC (20 years, 6 months ago) by pcg
Branch: MAIN
CVS Tags: stable, rel-1-3, rel-1-2
Changes since 1.1: +21 -274 lines
Log Message:
*** empty log message ***

File Contents

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