ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.1
Revision: 1.7
Committed: Mon Mar 29 16:52:06 2004 UTC (20 years, 3 months ago) by pcg
Branch: MAIN
Changes since 1.6: +21 -7 lines
Log Message:
*** empty log message ***

File Contents

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