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