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