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