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