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

# User Rev Content
1 pcg 1.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 pcg 1.2 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 pcg 1.1 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 pcg 1.2 .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 pcg 1.1 .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 pcg 1.2 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 pcg 1.1 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 pcg 1.2 .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 pcg 1.1 .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 - )