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