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