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