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