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