ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.1
Revision: 1.7
Committed: Mon Mar 29 16:52:06 2004 UTC (20 years, 3 months ago) by pcg
Branch: MAIN
Changes since 1.6: +21 -7 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 pcg 1.7 .TH "RXVT" "1" "2004-03-28" "X Version 11" "X Tools"
5 pcg 1.1 .SH "NAME"
6 pcg 1.6 rxvt-unicode (ouR XVT, unicode) \- a VT102 emulator for the X window system
7 pcg 1.1 .PP
8     .SH "SYNOPSIS"
9     .PP
10     \fBrxvt\fP [options] [-e command [ args ]]
11     .PP
12     .SH "DESCRIPTION"
13     .PP
14 pcg 1.7 \fBrxvt-unicode\fP, version \fB2\&.5\fP, is a colour vt102 terminal emulator
15 pcg 1.1 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 pcg 1.6 As a result, \fBrxvt-unicode\fP uses much less swap space -- a significant
18 pcg 1.1 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 pcg 1.7 other fonts might be smaller, but not larger\&. A reasonable default font list
85     is always appended to it\&.
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.7 .IP "\fB-insecure\fP"
178     Enable "insecure" mode, which currently enables most of the escape
179     sequences that echo strings\&. See the resource \fBinsecure\fP for
180     more info\&.
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 pcg 1.7 other fonts might be smaller, but not larger\&. A reasonable default font list
289     is always appended to this list\&.
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 "\fBbackspacekey:\fP \fIstring\fP"
410     The string to send when the backspace key is pressed\&. If set to
411     \fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted,
412     \fBBackspace\fP (code 8) - which can be reversed with the appropriate
413     DEC private mode escape sequence\&.
414     .IP "\fBdeletekey:\fP \fIstring\fP"
415     The string to send when the delete key (not the keypad delete key) is
416     pressed\&. If unset it will send the sequence traditionally associated
417     with the \fBExecute\fP key\&.
418     .IP "\fBcutchars:\fP \fIstring\fP"
419     The characters used as delimiters for double-click word selection\&.
420     The built-in default:
421     .br
422     \fBBACKSLASH `"\&'&()*,;<=>?@[]{|}\fP
423     .IP "\fBpreeditType:\fP \fIstyle\fP"
424     \fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP;
425     option \fB-pt\fP\&.
426     .IP "\fBinputMethod:\fP \fIname\fP"
427     \fIname\fP of inputMethod to use;
428     option \fB-im\fP\&.
429 pcg 1.2 .IP "\fBimLocale:\fP \fIname\fP"
430     The locale to use for opening the IM\&. You can use an LC_CTYPE
431     of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP
432     for the input extension to be able to input japanese characters
433     while staying in another locale\&.
434     option \fB-imlocale\fP\&.
435 pcg 1.7 .IP "\fBinsecure\fP"
436     Enables "insecure" mode\&. Rxvt-unicode offers some escape sequences
437     that echo arbitrary strings like the icon name or the locale\&. This
438     could be abused if somebody gets 8-bit-clean access to your display,
439     wether throuh a mail client displaying mail bodies unfiltered or
440     though write(1)\&. Therefore, these sequences are disabled by default\&.
441     You can enable them by setting this boolean resource or specifying
442     \fB-insecure\fP as an option\&. At the moment, this enabled display-answer,
443     locale, findfont, icon label and window title requests as well as
444     dynamic menubar dispatch\&.
445 pcg 1.1 .IP "\fBmodifier:\fP \fImodifier\fP"
446     Set the key to be interpreted as the Meta key to:
447     \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP,
448     \fBmod4\fP, \fBmod5\fP;
449     option \fB-mod\fP\&.
450     .IP "\fBanswerbackString:\fP \fIstring\fP"
451     Specify the reply rxvt sends to the shell when an ENQ (control-E)
452     character is passed through\&. It may contain escape values as
453     described in the entry on \fBkeysym\fP following\&.
454     .IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP"
455     Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It
456     may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape,
457     \en: newline, \er: return, \et: tab, \e000: octal number) or control
458     characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with
459     double quotes so that it can start or end with whitespace\&. The
460     intervening resource name \fBkeysym\&.\fP cannot be omitted\&. This
461     resource is only available when compiled with KEYSYM_RESOURCE\&.
462     .SH "THE SCROLLBAR"
463     .PP
464     Lines of text that scroll off the top of the \fBrxvt\fP window (resource:
465     \fBsaveLines\fP) and can be scrolled back using the scrollbar or by keystrokes\&.
466     The normal \fBrxvt\fP scrollbar has arrows and its behaviour is fairly
467     intuitive\&. The \fBxterm-scrollbar\fP is without arrows and its behaviour
468     mimics that of \fIxterm\fP
469     .PP
470     Scroll down with \fBButton1\fP (\fBxterm-scrollbar\fP) or \fBShift-Next\fP\&.
471     Scroll up with \fBButton3\fP (\fBxterm-scrollbar\fP) or \fBShift-Prior\fP\&.
472     Continuous scroll with \fBButton2\fP\&.
473     .SH "MOUSE REPORTING"
474     .PP
475     To temporarily override mouse reporting, for either the scrollbar or the
476     normal text selection/insertion, hold either the Shift or the Meta (Alt) key
477     while performing the desired mouse action\&.
478     .PP
479     If mouse reporting mode is active, the normal scrollbar actions are disabled
480     -- on the assumption that we are using a fullscreen application\&.
481     Instead, pressing Button1 and Button3 sends
482     \fBESC[6~\fP (Next) and \fBESC[5~\fP (Prior), respectively\&.
483     Similarly, clicking on the up and down arrows sends \fBESC[A\fP (Up) and
484     \fBESC[B\fP (Down), respectively\&.
485     .SH "TEXT SELECTION AND INSERTION"
486     .PP
487     The behaviour of text selection and insertion mechanism is similar to
488     \fIxterm\fP(1)\&.
489     .PP
490     .IP "\fBSelection\fP:"
491     Left click at the beginning of the region, drag to the end of the
492     region and release; Right click to extend the marked region;
493     Left double-click to select a word; Left triple-click to select
494     the entire line\&.
495     .IP "\fBInsertion\fP:"
496     Pressing and releasing the Middle mouse button (or \fBShift-Insert\fP)
497     in an \fBrxvt\fP window causes the current text selection to be inserted
498     as if it had been typed on the keyboard\&.
499     .SH "CHANGING FONTS"
500     .PP
501     You can change fonts on-the-fly, which is to say cycle through the default
502     font and others of various sizes, by using \fBShift-KP_Add\fP and
503     \fBShift-KP_Subtract\fP\&. Or, alternatively (if enabled) with
504     \fBAlt->\fP and \fBAlt-<\fP, where the actual key
505     can be selected using resources \fBsmallfont_key\fP/\fBbigfont_key\fP\&.
506     .SH "LOGIN STAMP"
507     .PP
508     \fBrxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be
509     seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this
510     feature, \fBrxvt\fP must be installed setuid root on some systems\&.
511     .SH "COLORS AND GRAPHICS"
512     .PP
513     In addition to the default foreground and background colours, \fBrxvt\fP
514     can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink
515     versions of the same)\&.
516     Here is a list of the colours with their \fBrgb\&.txt\fP names\&.
517     .PP
518     .TS
519     .nr 3c \n(.C
520     .cp 0
521     .nr 3lps \n[.s]
522     .nr 3cent \n[.ce]
523     .de 3init
524     .ft \n[.f]
525     .ps \n[.s]
526     .vs \n[.v]u
527     .in \n[.i]u
528     .ll \n[.l]u
529     .ls \n[.L]
530     .ad \n[.j]
531     .ie \n[.u] .fi
532     .el .nf
533     .ce \n[.ce]
534     ..
535     .nr 3ind \n[.i]
536     .nr 3fnt \n[.f]
537     .nr 3sz \n[.s]
538     .nr 3fll \n[.u]
539     .nr T. 0
540     .nr 3crow 0-1
541     .nr 3passed 0-1
542     .nr 3sflag 0
543     .ds 3trans
544     .ds 3quote
545     .nr 3brule 1
546     .nr 3supbot 0
547     .eo
548     .de 3rmk
549     .mk \$1
550     .if !'\n(.z'' \!.3rmk "\$1"
551     ..
552     .de 3rvpt
553     .vpt \$1
554     .if !'\n(.z'' \!.3rvpt "\$1"
555     ..
556     .de 3keep
557     .if '\n[.z]'' \{.ds 3quote \\
558     .ds 3trans \!
559     .di 3section
560     .nr 3sflag 1
561     .in 0
562     .\}
563     ..
564     .de 3release
565     .if \n[3sflag] \{.di
566     .in \n[3ind]u
567     .nr 3dn \n[dn]
568     .ds 3quote
569     .ds 3trans
570     .nr 3sflag 0
571     .if \n[.t]<=\n[dn] \{.nr T. 1
572     .T#
573     .nr 3supbot 1
574     .sp \n[.t]u
575     .nr 3supbot 0
576     .mk #T
577     .\}
578     .if \n[.t]<=\n[3dn] .tm warning: page \n%: table text block will not fit on one page
579     .nf
580     .ls 1
581     .3section
582     .ls
583     .rm 3section
584     .\}
585     ..
586     .nr 3tflag 0
587     .de 3tkeep
588     .if '\n[.z]'' \{.di 3table
589     .nr 3tflag 1
590     .\}
591     ..
592     .de 3trelease
593     .if \n[3tflag] \{.br
594     .di
595     .nr 3dn \n[dn]
596     .ne \n[dn]u+\n[.V]u
597     .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
598     .el \{.in 0
599     .ls 1
600     .nf
601     .3table
602     .\}
603     .rm 3table
604     .\}
605     ..
606     .ec
607     .ce 0
608     .nf
609     .nr 3sep 1n
610     .nr 3w0 \n(.H
611     .nr 3aw0 0
612     .nr 3lnw0 0
613     .nr 3rnw0 0
614     .nr 3w1 \n(.H
615     .nr 3aw1 0
616     .nr 3lnw1 0
617     .nr 3rnw1 0
618     .nr 3w2 \n(.H
619     .nr 3aw2 0
620     .nr 3lnw2 0
621     .nr 3rnw2 0
622     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor0\fP \[tbl]
623     .nr 3w1 \n[3w1]>?\w\[tbl]\ (black) \[tbl]
624     .nr 3w2 \n[3w2]>?\w\[tbl]\ = Black \[tbl]
625     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor1\fP \[tbl]
626     .nr 3w1 \n[3w1]>?\w\[tbl]\ (red) \[tbl]
627     .nr 3w2 \n[3w2]>?\w\[tbl]\ = Red3 \[tbl]
628     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor2\fP \[tbl]
629     .nr 3w1 \n[3w1]>?\w\[tbl]\ (green) \[tbl]
630     .nr 3w2 \n[3w2]>?\w\[tbl]\ = Green3 \[tbl]
631     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor3\fP \[tbl]
632     .nr 3w1 \n[3w1]>?\w\[tbl]\ (yellow) \[tbl]
633     .nr 3w2 \n[3w2]>?\w\[tbl]\ = Yellow3 \[tbl]
634     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor4\fP \[tbl]
635     .nr 3w1 \n[3w1]>?\w\[tbl]\ (blue) \[tbl]
636     .nr 3w2 \n[3w2]>?\w\[tbl]\ = Blue3 \[tbl]
637     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor5\fP \[tbl]
638     .nr 3w1 \n[3w1]>?\w\[tbl]\ (magenta) \[tbl]
639     .nr 3w2 \n[3w2]>?\w\[tbl]\ = Magenta3 \[tbl]
640     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor6\fP \[tbl]
641     .nr 3w1 \n[3w1]>?\w\[tbl]\ (cyan) \[tbl]
642     .nr 3w2 \n[3w2]>?\w\[tbl]\ = Cyan3 \[tbl]
643     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor7\fP \[tbl]
644     .nr 3w1 \n[3w1]>?\w\[tbl]\ (white) \[tbl]
645     .nr 3w2 \n[3w2]>?\w\[tbl]\ = AntiqueWhite \[tbl]
646     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor8\fP \[tbl]
647     .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright black) \[tbl]
648     .nr 3w2 \n[3w2]>?\w\[tbl]\ = Grey25 \[tbl]
649     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor9\fP \[tbl]
650     .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright red) \[tbl]
651     .nr 3w2 \n[3w2]>?\w\[tbl]\ = Red \[tbl]
652     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor10\fP \[tbl]
653     .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright green) \[tbl]
654     .nr 3w2 \n[3w2]>?\w\[tbl]\ = Green \[tbl]
655     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor11\fP \[tbl]
656     .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright yellow) \[tbl]
657     .nr 3w2 \n[3w2]>?\w\[tbl]\ = Yellow \[tbl]
658     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor12\fP \[tbl]
659     .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright blue) \[tbl]
660     .nr 3w2 \n[3w2]>?\w\[tbl]\ = Blue \[tbl]
661     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor13\fP \[tbl]
662     .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright magenta) \[tbl]
663     .nr 3w2 \n[3w2]>?\w\[tbl]\ = Magenta \[tbl]
664     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor14\fP \[tbl]
665     .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright cyan) \[tbl]
666     .nr 3w2 \n[3w2]>?\w\[tbl]\ = Cyan \[tbl]
667     .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor15\fP \[tbl]
668     .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright white) \[tbl]
669     .nr 3w2 \n[3w2]>?\w\[tbl]\ = White \[tbl]
670     .nr 3w0 \n[3w0]>?\w\[tbl]\fBforeground\fP \[tbl]
671     .nr 3w1 \n[3w1]>?\w\[tbl]\ \[tbl]
672     .nr 3w2 \n[3w2]>?\w\[tbl]\ = Black \[tbl]
673     .nr 3w0 \n[3w0]>?\w\[tbl]\fBbackground\fP \[tbl]
674     .nr 3w1 \n[3w1]>?\w\[tbl]\ \[tbl]
675     .nr 3w2 \n[3w2]>?\w\[tbl]\ = White \[tbl]
676     .nr 3w0 \n[3w0]>?(\n[3lnw0]+\n[3rnw0])
677     .if \n[3aw0] .nr 3w0 \n[3w0]>?(\n[3aw0]+2n)
678     .nr 3w1 \n[3w1]>?(\n[3lnw1]+\n[3rnw1])
679     .if \n[3aw1] .nr 3w1 \n[3w1]>?(\n[3aw1]+2n)
680     .nr 3w2 \n[3w2]>?(\n[3lnw2]+\n[3rnw2])
681     .if \n[3aw2] .nr 3w2 \n[3w2]>?(\n[3aw2]+2n)
682     .nr 3cd0 0
683     .nr 3cl0 0*\n[3sep]
684     .nr 3ce0 \n[3cl0]+\n[3w0]
685     .nr 3cl1 \n[3ce0]+(3*\n[3sep])
686     .nr 3cd1 \n[3ce0]+\n[3cl1]/2
687     .nr 3ce1 \n[3cl1]+\n[3w1]
688     .nr 3cl2 \n[3ce1]+(3*\n[3sep])
689     .nr 3cd2 \n[3ce1]+\n[3cl2]/2
690     .nr 3ce2 \n[3cl2]+\n[3w2]
691     .nr 3cd3 \n[3ce2]+(0*\n[3sep])
692     .nr TW \n[3cd3]
693     .if \n[3cent] \{.in +(u;\n[.l]-\n[.i]-\n[TW]/2>?-\n[.i])
694     .nr 3ind \n[.i]
695     .\}
696     .eo
697     .de T#
698     .if !\n[3supbot] \{.3rvpt 0
699     .mk 3vert
700     .ls 1
701     .ls
702     .nr 3passed \n[3crow]
703     .sp |\n[3vert]u
704     .3rvpt 1
705     .\}
706     ..
707     .ec
708     .fc 
709     .3keep
710     .3rmk 3rt0
711     \*[3trans].nr 3crow 0
712     .3keep
713     .mk 3rs0
714     .mk 3bot
715     .3rvpt 0
716     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
717     \&\h'|\n[3cl0]u'\fBcolor0\fP \h'|\n[3cl1]u'\ (black) \h'|\n[3cl2]u'\ = Black
718     .nr 3bot \n[3bot]>?\n[.d]
719     .sp |\n[3rs0]u
720     .3rvpt 1
721     .sp |\n[3bot]u
722     \*[3trans].nr 3brule 1
723     .3release
724     .3keep
725     .3rmk 3rt1
726     \*[3trans].nr 3crow 1
727     .3keep
728     .mk 3rs1
729     .mk 3bot
730     .3rvpt 0
731     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
732     \&\h'|\n[3cl0]u'\fBcolor1\fP \h'|\n[3cl1]u'\ (red) \h'|\n[3cl2]u'\ = Red3
733     .nr 3bot \n[3bot]>?\n[.d]
734     .sp |\n[3rs1]u
735     .3rvpt 1
736     .sp |\n[3bot]u
737     \*[3trans].nr 3brule 1
738     .3release
739     .3keep
740     .3rmk 3rt2
741     \*[3trans].nr 3crow 2
742     .3keep
743     .mk 3rs2
744     .mk 3bot
745     .3rvpt 0
746     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
747     \&\h'|\n[3cl0]u'\fBcolor2\fP \h'|\n[3cl1]u'\ (green) \h'|\n[3cl2]u'\ = Green3
748     .nr 3bot \n[3bot]>?\n[.d]
749     .sp |\n[3rs2]u
750     .3rvpt 1
751     .sp |\n[3bot]u
752     \*[3trans].nr 3brule 1
753     .3release
754     .3keep
755     .3rmk 3rt3
756     \*[3trans].nr 3crow 3
757     .3keep
758     .mk 3rs3
759     .mk 3bot
760     .3rvpt 0
761     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
762     \&\h'|\n[3cl0]u'\fBcolor3\fP \h'|\n[3cl1]u'\ (yellow) \h'|\n[3cl2]u'\ = Yellow3
763     .nr 3bot \n[3bot]>?\n[.d]
764     .sp |\n[3rs3]u
765     .3rvpt 1
766     .sp |\n[3bot]u
767     \*[3trans].nr 3brule 1
768     .3release
769     .3keep
770     .3rmk 3rt4
771     \*[3trans].nr 3crow 4
772     .3keep
773     .mk 3rs4
774     .mk 3bot
775     .3rvpt 0
776     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
777     \&\h'|\n[3cl0]u'\fBcolor4\fP \h'|\n[3cl1]u'\ (blue) \h'|\n[3cl2]u'\ = Blue3
778     .nr 3bot \n[3bot]>?\n[.d]
779     .sp |\n[3rs4]u
780     .3rvpt 1
781     .sp |\n[3bot]u
782     \*[3trans].nr 3brule 1
783     .3release
784     .3keep
785     .3rmk 3rt5
786     \*[3trans].nr 3crow 5
787     .3keep
788     .mk 3rs5
789     .mk 3bot
790     .3rvpt 0
791     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
792     \&\h'|\n[3cl0]u'\fBcolor5\fP \h'|\n[3cl1]u'\ (magenta) \h'|\n[3cl2]u'\ = Magenta3
793     .nr 3bot \n[3bot]>?\n[.d]
794     .sp |\n[3rs5]u
795     .3rvpt 1
796     .sp |\n[3bot]u
797     \*[3trans].nr 3brule 1
798     .3release
799     .3keep
800     .3rmk 3rt6
801     \*[3trans].nr 3crow 6
802     .3keep
803     .mk 3rs6
804     .mk 3bot
805     .3rvpt 0
806     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
807     \&\h'|\n[3cl0]u'\fBcolor6\fP \h'|\n[3cl1]u'\ (cyan) \h'|\n[3cl2]u'\ = Cyan3
808     .nr 3bot \n[3bot]>?\n[.d]
809     .sp |\n[3rs6]u
810     .3rvpt 1
811     .sp |\n[3bot]u
812     \*[3trans].nr 3brule 1
813     .3release
814     .3keep
815     .3rmk 3rt7
816     \*[3trans].nr 3crow 7
817     .3keep
818     .mk 3rs7
819     .mk 3bot
820     .3rvpt 0
821     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
822     \&\h'|\n[3cl0]u'\fBcolor7\fP \h'|\n[3cl1]u'\ (white) \h'|\n[3cl2]u'\ = AntiqueWhite
823     .nr 3bot \n[3bot]>?\n[.d]
824     .sp |\n[3rs7]u
825     .3rvpt 1
826     .sp |\n[3bot]u
827     \*[3trans].nr 3brule 1
828     .3release
829     .3keep
830     .3rmk 3rt8
831     \*[3trans].nr 3crow 8
832     .3keep
833     .mk 3rs8
834     .mk 3bot
835     .3rvpt 0
836     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
837     \&\h'|\n[3cl0]u'\fBcolor8\fP \h'|\n[3cl1]u'\ (bright black) \h'|\n[3cl2]u'\ = Grey25
838     .nr 3bot \n[3bot]>?\n[.d]
839     .sp |\n[3rs8]u
840     .3rvpt 1
841     .sp |\n[3bot]u
842     \*[3trans].nr 3brule 1
843     .3release
844     .3keep
845     .3rmk 3rt9
846     \*[3trans].nr 3crow 9
847     .3keep
848     .mk 3rs9
849     .mk 3bot
850     .3rvpt 0
851     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
852     \&\h'|\n[3cl0]u'\fBcolor9\fP \h'|\n[3cl1]u'\ (bright red) \h'|\n[3cl2]u'\ = Red
853     .nr 3bot \n[3bot]>?\n[.d]
854     .sp |\n[3rs9]u
855     .3rvpt 1
856     .sp |\n[3bot]u
857     \*[3trans].nr 3brule 1
858     .3release
859     .3keep
860     .3rmk 3rt10
861     \*[3trans].nr 3crow 10
862     .3keep
863     .mk 3rs10
864     .mk 3bot
865     .3rvpt 0
866     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
867     \&\h'|\n[3cl0]u'\fBcolor10\fP \h'|\n[3cl1]u'\ (bright green) \h'|\n[3cl2]u'\ = Green
868     .nr 3bot \n[3bot]>?\n[.d]
869     .sp |\n[3rs10]u
870     .3rvpt 1
871     .sp |\n[3bot]u
872     \*[3trans].nr 3brule 1
873     .3release
874     .3keep
875     .3rmk 3rt11
876     \*[3trans].nr 3crow 11
877     .3keep
878     .mk 3rs11
879     .mk 3bot
880     .3rvpt 0
881     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
882     \&\h'|\n[3cl0]u'\fBcolor11\fP \h'|\n[3cl1]u'\ (bright yellow) \h'|\n[3cl2]u'\ = Yellow
883     .nr 3bot \n[3bot]>?\n[.d]
884     .sp |\n[3rs11]u
885     .3rvpt 1
886     .sp |\n[3bot]u
887     \*[3trans].nr 3brule 1
888     .3release
889     .3keep
890     .3rmk 3rt12
891     \*[3trans].nr 3crow 12
892     .3keep
893     .mk 3rs12
894     .mk 3bot
895     .3rvpt 0
896     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
897     \&\h'|\n[3cl0]u'\fBcolor12\fP \h'|\n[3cl1]u'\ (bright blue) \h'|\n[3cl2]u'\ = Blue
898     .nr 3bot \n[3bot]>?\n[.d]
899     .sp |\n[3rs12]u
900     .3rvpt 1
901     .sp |\n[3bot]u
902     \*[3trans].nr 3brule 1
903     .3release
904     .3keep
905     .3rmk 3rt13
906     \*[3trans].nr 3crow 13
907     .3keep
908     .mk 3rs13
909     .mk 3bot
910     .3rvpt 0
911     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
912     \&\h'|\n[3cl0]u'\fBcolor13\fP \h'|\n[3cl1]u'\ (bright magenta) \h'|\n[3cl2]u'\ = Magenta
913     .nr 3bot \n[3bot]>?\n[.d]
914     .sp |\n[3rs13]u
915     .3rvpt 1
916     .sp |\n[3bot]u
917     \*[3trans].nr 3brule 1
918     .3release
919     .3keep
920     .3rmk 3rt14
921     \*[3trans].nr 3crow 14
922     .3keep
923     .mk 3rs14
924     .mk 3bot
925     .3rvpt 0
926     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
927     \&\h'|\n[3cl0]u'\fBcolor14\fP \h'|\n[3cl1]u'\ (bright cyan) \h'|\n[3cl2]u'\ = Cyan
928     .nr 3bot \n[3bot]>?\n[.d]
929     .sp |\n[3rs14]u
930     .3rvpt 1
931     .sp |\n[3bot]u
932     \*[3trans].nr 3brule 1
933     .3release
934     .3keep
935     .3rmk 3rt15
936     \*[3trans].nr 3crow 15
937     .3keep
938     .mk 3rs15
939     .mk 3bot
940     .3rvpt 0
941     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
942     \&\h'|\n[3cl0]u'\fBcolor15\fP \h'|\n[3cl1]u'\ (bright white) \h'|\n[3cl2]u'\ = White
943     .nr 3bot \n[3bot]>?\n[.d]
944     .sp |\n[3rs15]u
945     .3rvpt 1
946     .sp |\n[3bot]u
947     \*[3trans].nr 3brule 1
948     .3release
949     .3keep
950     .3rmk 3rt16
951     \*[3trans].nr 3crow 16
952     .3keep
953     .mk 3rs16
954     .mk 3bot
955     .3rvpt 0
956     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
957     \&\h'|\n[3cl0]u'\fBforeground\fP \h'|\n[3cl1]u'\ \h'|\n[3cl2]u'\ = Black
958     .nr 3bot \n[3bot]>?\n[.d]
959     .sp |\n[3rs16]u
960     .3rvpt 1
961     .sp |\n[3bot]u
962     \*[3trans].nr 3brule 1
963     .3release
964     .3keep
965     .3rmk 3rt17
966     \*[3trans].nr 3crow 17
967     .3keep
968     .mk 3rs17
969     .mk 3bot
970     .3rvpt 0
971     .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u
972     \&\h'|\n[3cl0]u'\fBbackground\fP \h'|\n[3cl1]u'\ \h'|\n[3cl2]u'\ = White
973     .nr 3bot \n[3bot]>?\n[.d]
974     .sp |\n[3rs17]u
975     .3rvpt 1
976     .sp |\n[3bot]u
977     \*[3trans].nr 3brule 1
978     .3release
979     .mk 3rt18
980     .nr 3brule 1
981     .nr T. 1
982     .T#
983     .3init
984     .fc
985     .cp \n(3c
986     .TE
987     .PP
988     It is also possible to specify the colour values of \fBforeground\fP,
989     \fBbackground\fP, \fBcursorColor\fP, \fBcursorColor2\fP, \fBcolorBD\fP, \fBcolorUL\fP
990     as a number 0-15, as a convenient shorthand to reference the colour name of
991     color0-color15\&.
992     .PP
993     Note that \fB-rv\fP (\fB"reverseVideo: True"\fP) simulates reverse video by
994     always swapping the foreground/background colours\&. This is in contrast to
995     \fIxterm\fP(1) where the colours are only swapped if they have not otherwise been
996     specified\&.
997     For example,
998     .PP
999     .IP "\fBrxvt -fg Black -bg White -rv\fP"
1000     would yield White on Black, while on \fIxterm\fP(1) it would yield
1001     Black on White\&.
1002     .SH "ENVIRONMENT"
1003     .PP
1004     \fBrxvt\fP sets the environment variables \fBTERM\fP, \fBCOLORTERM\fP and
1005     \fBCOLORFGBG\fP\&. The environment variable \fBWINDOWID\fP is set to the X window
1006     id number of the \fBrxvt\fP window and it also uses and sets the environment
1007     variable \fBDISPLAY\fP to specify which display terminal to use\&. \fBrxvt\fP uses
1008     the environment variables \fBRXVTPATH\fP and \fBPATH\fP to find XPM files\&.
1009     .SH "FILES"
1010     .PP
1011     .IP "\fB/etc/utmp\fP"
1012     System file for login records\&.
1013     .IP "\fB/usr/lib/X11/rgb\&.txt\fP"
1014     Color names\&.
1015     .PP
1016     .SH "SEE ALSO"
1017     .PP
1018     \fIxterm\fP(1), \fIsh\fP(1), \fIresize\fP(1), \fIX\fP(1), \fIpty\fP(4), \fItty\fP(4),
1019     \fIutmp\fP(5)
1020     .PP
1021     See rxvtRef\&.html rxvtRef\&.txt for detailed information on recognized escape
1022     sequences and menuBar syntax, etc\&.
1023     .PP
1024     .SH "BUGS"
1025     .PP
1026     Check the BUGS file for an up-to-date list\&.
1027     .PP
1028     Cursor change support is not yet implemented\&.
1029     .PP
1030     Click-and-drag doesn\&'t work with X11 mouse report overriding\&.
1031     .PP
1032     .SH "FTP LOCATION"
1033     .PP
1034 pcg 1.7 rxvt-2\&.5\&.tar\&.gz can be found at the following ftp sites
1035 pcg 1.6 ftp://ftp\&.rxvt\&.org/pub/rxvt
1036 pcg 1.1 .PP
1037     .SH "CURRENT PROJECT COORDINATOR"
1038     .PP
1039     .IP "Project Coordinator"
1040 pcg 1.6 Marc A\&. Lehmann <rxvt@schmorp\&.de>
1041 pcg 1.1 .br
1042     .IP "Web page maintainter"
1043 pcg 1.6 Marc A\&. Lehmann <rxvt@schmorp\&.de>
1044 pcg 1.1 .br
1045 pcg 1.6 <http://www\&.sourceforge\&.net/projects/rxvt-unicode/>
1046 pcg 1.1 .br
1047     .PP
1048     .SH "AUTHORS"
1049     .PP
1050     .IP "John Bovey"
1051     University of Kent, 1992, wrote the original Xvt\&.
1052     .IP "Rob Nation <nation@rocket\&.sanders\&.lockheed\&.com>"
1053     very heavily modified Xvt and came up with Rxvt
1054     .IP "Angelo Haritsis <ah@doc\&.ic\&.ac\&.uk>"
1055 pcg 1.3 wrote the Greek Keyboard Input (no longer in code)
1056 pcg 1.1 .IP "mj olesen <olesen@me\&.QueensU\&.CA>"
1057     Wrote the menu system\&.
1058     .br
1059     Project Coordinator (changes\&.txt 2\&.11 to 2\&.21)
1060     .IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>"
1061     Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5)
1062     .IP "Geoff Wing <gcw@pobox\&.com>"
1063 pcg 1.3 Rewrote screen display and text selection routines\&.
1064     Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode)
1065     .IP "Marc Alexander Lehman <rxvt@schmorp\&.de>"
1066     Rewrote most of the display code and internal character handling
1067     to store text in unicode\&. Numerous other fixes and extensions\&.
1068 pcg 1.1 .br
1069 pcg 1.3 Project Coordinator (Changes 1\&.0 - )
1070     .PP