1 | .TH "RXVT" "1" "2004-05-10" "X Version 11" "X Tools" |
1 | .TH "RXVT" "1" "2004-07-26" "X Version 11" "X Tools" |
2 | .SH "NAME" |
2 | .SH "NAME" |
3 | rxvt-unicode (ouR XVT, unicode) \- a VT102 emulator for the X window system |
3 | rxvt-unicode (ouR XVT, unicode) \- a VT102 emulator for the X window system |
4 | .PP |
4 | .PP |
5 | .SH "SYNOPSIS" |
5 | .SH "SYNOPSIS" |
6 | .PP |
6 | .PP |
7 | \fBrxvt\fP [options] [-e command [ args ]] |
7 | \fBrxvt\fP [options] [-e command [ args ]] |
8 | .PP |
8 | .PP |
9 | .SH "DESCRIPTION" |
9 | .SH "DESCRIPTION" |
10 | .PP |
10 | .PP |
11 | \fBrxvt-unicode\fP, version \fB3\&.1\fP, is a colour vt102 terminal emulator |
11 | \fBrxvt-unicode\fP, version \fB3\&.3\fP, is a colour vt102 terminal emulator |
12 | intended as an \fIxterm\fP(1) replacement for users who do not require |
12 | intended as an \fIxterm\fP(1) replacement for users who do not require |
13 | features such as Tektronix 4014 emulation and toolkit-style configurability\&. |
13 | features such as Tektronix 4014 emulation and toolkit-style configurability\&. |
14 | As a result, \fBrxvt-unicode\fP uses much less swap space -- a significant |
14 | As a result, \fBrxvt-unicode\fP uses much less swap space -- a significant |
15 | advantage on a machine serving many X sessions\&. |
15 | advantage on a machine serving many X sessions\&. |
16 | .PP |
16 | .PP |
… | |
… | |
51 | resource \fBjumpScroll\fP\&. |
51 | resource \fBjumpScroll\fP\&. |
52 | .IP "\fB-ip\fP|\fB+ip\fP" |
52 | .IP "\fB-ip\fP|\fB+ip\fP" |
53 | Turn on/off inheriting parent window\&'s pixmap\&. Alternative form |
53 | Turn on/off inheriting parent window\&'s pixmap\&. Alternative form |
54 | is \fB-tr\fP; |
54 | is \fB-tr\fP; |
55 | resource \fBinheritPixmap\fP\&. |
55 | resource \fBinheritPixmap\fP\&. |
|
|
56 | .IP "\fB-fade\fP \fInumber\fP" |
|
|
57 | Fade the text by the given percentage when focus is lost\&. |
56 | .IP "\fB-tint\fP \fIcolour\fP" |
58 | .IP "\fB-tint\fP \fIcolour\fP" |
57 | Tint the transparent background pixmap with the given colour\&. |
59 | Tint the transparent background pixmap with the given colour when |
|
|
60 | transparency is enabled with \fB-tr\fP or \fB-ip\fP\&. You can also |
|
|
61 | emulate the "shading" or "brigthness change" option known from |
|
|
62 | other terminal programs using gray10 (gray20, etc\&.) colour |
|
|
63 | strings\&. |
58 | .IP "\fB-bg\fP \fIcolour\fP" |
64 | .IP "\fB-bg\fP \fIcolour\fP" |
59 | Window background colour; |
65 | Window background colour; |
60 | resource \fBbackground\fP\&. |
66 | resource \fBbackground\fP\&. |
61 | .IP "\fB-fg\fP \fIcolour\fP" |
67 | .IP "\fB-fg\fP \fIcolour\fP" |
62 | Window foreground colour; |
68 | Window foreground colour; |
… | |
… | |
78 | resource \fBpointerColor2\fP\&. |
84 | resource \fBpointerColor2\fP\&. |
79 | .IP "\fB-bd\fP \fIcolour\fP" |
85 | .IP "\fB-bd\fP \fIcolour\fP" |
80 | The colour of the border between the xterm scrollbar and the text; |
86 | The colour of the border between the xterm scrollbar and the text; |
81 | resource \fBborderColor\fP\&. |
87 | resource \fBborderColor\fP\&. |
82 | .IP "\fB-fn\fP \fIfontname\fP" |
88 | .IP "\fB-fn\fP \fIfontname\fP" |
83 | Select the fonts to be used used\&. This is a comma seperated |
89 | Select the fonts to be used\&. |
84 | list of font names that are used in turn when trying to display |
90 | This is a comma seperated list of font names that are used in turn when |
85 | unicode characters\&. The first font defines the cell size for characters, |
91 | trying to display Unicode characters\&. |
86 | other fonts might be smaller, but not larger\&. A reasonable default font list |
92 | The first font defines the cell size for characters; other fonts might |
87 | is always appended to it\&. |
93 | be smaller, but not larger\&. |
|
|
94 | A reasonable default font list is always appended to it\&. |
88 | resource \fBfont\fP\&. |
95 | resource \fBfont\fP\&. |
|
|
96 | .IP "\fB-rb\fP|\fB+rb\fP" |
|
|
97 | Enable "real bold" support\&. |
|
|
98 | When this option is on, bold text will be displayed using the first |
|
|
99 | available bold font in the font list\&. |
|
|
100 | Bold fonts should thus be specified in the font list after their |
|
|
101 | corresponding regular fonts\&. |
|
|
102 | If no bold font can be found, a regular font will be used\&. |
|
|
103 | resource \fBrealBold\fP\&. |
89 | .IP "\fB-name\fP \fIname\fP" |
104 | .IP "\fB-name\fP \fIname\fP" |
90 | Specify the application name under which resources |
105 | Specify the application name under which resources |
91 | are to be obtained, rather than the default executable file name\&. |
106 | are to be obtained, rather than the default executable file name\&. |
92 | Name should not contain `\&.\&' or `*\&' characters\&. |
107 | Name should not contain `\&.\&' or `*\&' characters\&. |
93 | Also sets the icon and title name\&. |
108 | Also sets the icon and title name\&. |
… | |
… | |
197 | in some window managers\&. |
212 | in some window managers\&. |
198 | .SH "RESOURCES (available also as long-options)" |
213 | .SH "RESOURCES (available also as long-options)" |
199 | .PP |
214 | .PP |
200 | Note: `rxvt --help\&' gives a list of all resources (long options) compiled |
215 | Note: `rxvt --help\&' gives a list of all resources (long options) compiled |
201 | into your version\&. |
216 | into your version\&. |
|
|
217 | .PP |
|
|
218 | There are two different methods that rxvt can use to get the |
|
|
219 | Xresource data: using the X libraries (Xrm*-functions) or internal Xresources |
|
|
220 | reader (\fB~/\&.Xdefaults\fP)\&. For the first method (ie\&. \fBrxvt -h\fP lists |
|
|
221 | \fBXGetDefaults\fP), you can set and change the resources using X11 |
|
|
222 | tools like \fBxset\fP\&. Many distribution do also load settings from the |
|
|
223 | \fB~/\&.Xresources\fP file when X starts\&. |
|
|
224 | .PP |
202 | If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists |
225 | If compiled with internal Xresources support (i\&.e\&. \fBrxvt |
203 | \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application defaults set in |
226 | -h\fP lists \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application |
204 | XAPPLOADDIR/Rxvt (compile-time defined: usually |
227 | defaults set in XAPPLOADDIR/URxvt (compile-time defined: usually |
205 | \fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP, |
228 | \fB/usr/lib/X11/app-defaults/URxvt\fP) and resources set in |
206 | or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when |
229 | \fB~/\&.Xdefaults\fP, or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. |
207 | reading X resources, \fBrxvt\fP recognizes two class names: \fBXTerm\fP and |
230 | Note that when reading X resources, \fBrxvt\fP recognizes two class |
208 | \fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both |
231 | names: \fBXTerm\fP and \fBURxvt\fP\&. The class name \fBRxvt\fP allows resources |
209 | \fBrxvt\fP and \fIxterm\fP to be easily configured, while the class name |
232 | common to both \fBrxvt\fP and the original \fIrxvt\fP to be easily configured, |
210 | \fBRxvt\fP allows resources unique to \fBrxvt\fP, notably colours and |
233 | while the class name \fBURxvt\fP allows resources unique to \fBrxvt\fP, |
211 | key-handling, to be shared between different \fBrxvt\fP configurations\&. |
234 | notably colours and key-handling, to be shared between different |
212 | If no resources are specified, suitable defaults will be used\&. |
235 | \fBrxvt\fP configurations\&. If no resources are specified, suitable |
213 | Command-line arguments can be used to override resource settings\&. The |
236 | defaults will be used\&. Command-line arguments can be used to override |
214 | following resources are allowed: |
237 | resource settings\&. The following resources are allowed: |
215 | .PP |
238 | .PP |
216 | .IP "\fBgeometry:\fP \fIgeom\fP" |
239 | .IP "\fBgeometry:\fP \fIgeom\fP" |
217 | Create the window with the specified X window geometry [default |
240 | Create the window with the specified X window geometry [default |
218 | 80x24]; |
241 | 80x24]; |
219 | option \fB-geometry\fP\&. |
242 | option \fB-geometry\fP\&. |
… | |
… | |
234 | but the actual colour names used are listed in the |
257 | but the actual colour names used are listed in the |
235 | \fBCOLORS AND GRAPHICS\fP section\&. |
258 | \fBCOLORS AND GRAPHICS\fP section\&. |
236 | .IP "\fBcolorBD:\fP \fIcolour\fP" |
259 | .IP "\fBcolorBD:\fP \fIcolour\fP" |
237 | Use the specified colour to display bold characters when the |
260 | Use the specified colour to display bold characters when the |
238 | foreground colour is the default\&. |
261 | foreground colour is the default\&. |
|
|
262 | This option will be ignored if \fBrealBold\fP is enabled\&. |
239 | .IP "\fBcolorUL:\fP \fIcolour\fP" |
263 | .IP "\fBcolorUL:\fP \fIcolour\fP" |
240 | Use the specified colour to display underlined characters when the |
264 | Use the specified colour to display underlined characters when the |
241 | foreground colour is the default\&. |
265 | foreground colour is the default\&. |
242 | .IP "\fBcolorRV:\fP \fIcolour\fP" |
266 | .IP "\fBcolorRV:\fP \fIcolour\fP" |
243 | Use the specified colour as the background for reverse video |
267 | Use the specified colour as the background for reverse video |
… | |
… | |
264 | option \fB+j\fP\&. |
288 | option \fB+j\fP\&. |
265 | .IP "\fBinheritPixmap:\fP \fIboolean\fP" |
289 | .IP "\fBinheritPixmap:\fP \fIboolean\fP" |
266 | \fBTrue\fP: make the background inherit the parent windows\&' pixmap, |
290 | \fBTrue\fP: make the background inherit the parent windows\&' pixmap, |
267 | giving artificial transparency\&. |
291 | giving artificial transparency\&. |
268 | \fBFalse\fP: do not inherit the parent windows\&' pixmap\&. |
292 | \fBFalse\fP: do not inherit the parent windows\&' pixmap\&. |
269 | .IP "\fBtintColor\fP \fIcolour\fP" |
293 | .IP "\fBtintColor:\fP \fIcolour\fP" |
270 | Tint the transparent background pixmap with the given colour\&. |
294 | Tint the transparent background pixmap with the given colour\&. |
271 | .IP "\fBscrollColor:\fP \fIcolour\fP" |
295 | .IP "\fBscrollColor:\fP \fIcolour\fP" |
272 | Use the specified colour for the scrollbar [default #B2B2B2]\&. |
296 | Use the specified colour for the scrollbar [default #B2B2B2]\&. |
273 | .IP "\fBtroughColor:\fP \fIcolour\fP" |
297 | .IP "\fBtroughColor:\fP \fIcolour\fP" |
274 | Use the specified colour for the scrollbar\&'s trough area [default |
298 | Use the specified colour for the scrollbar\&'s trough area [default |
… | |
… | |
290 | .IP "\fBpath:\fP \fIpath\fP" |
314 | .IP "\fBpath:\fP \fIpath\fP" |
291 | Specify the colon-delimited search path for finding files (XPM and |
315 | Specify the colon-delimited search path for finding files (XPM and |
292 | menus), in addition to the paths specified by the \fBRXVTPATH\fP and |
316 | menus), in addition to the paths specified by the \fBRXVTPATH\fP and |
293 | \fBPATH\fP environment variables\&. |
317 | \fBPATH\fP environment variables\&. |
294 | .IP "\fBfont:\fP \fIfontname\fP" |
318 | .IP "\fBfont:\fP \fIfontname\fP" |
295 | Select the fonts to be used used\&. This is a comma seperated |
319 | Select the fonts to be used\&. |
296 | list of font names that are used in turn when trying to display |
320 | This is a comma seperated list of font names that are used in turn when |
297 | unicode characters\&. The first font defines the cell size for characters, |
321 | trying to display Unicode characters\&. |
298 | other fonts might be smaller, but not larger\&. A reasonable default font list |
322 | The first font defines the cell size for characters; other fonts might |
299 | is always appended to this list\&. |
323 | be smaller, but not larger\&. |
|
|
324 | A reasonable default font list is always appended to it\&. |
300 | option \fB-fn\fP\&. |
325 | option \fB-fn\fP\&. |
|
|
326 | .IP "\fBrealBold:\fP \fIboolean\fP" |
|
|
327 | \fBTrue\fP: Enable "real bold" support\&. |
|
|
328 | When this option is on, bold text will be displayed using the first |
|
|
329 | available bold font in the font list\&. |
|
|
330 | Bold fonts should thus be specified in the font list after their |
|
|
331 | corresponding regular fonts\&. |
|
|
332 | If no bold font can be found, a regular font will be used\&. |
|
|
333 | option \fB-rb\fP\&. |
|
|
334 | \fBFalse\fP: Display bold text in a regular font, using the color |
|
|
335 | specified with \fBcolorBD\fP; |
|
|
336 | option \fB+rb\fP\&. |
301 | .IP "\fBselectstyle:\fP \fImode\fP" |
337 | .IP "\fBselectstyle:\fP \fImode\fP" |
302 | Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which |
338 | Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which |
303 | is xterm style with 2\&.20 old word selection, or anything else which |
339 | is xterm style with 2\&.20 old word selection, or anything else which |
304 | gives xterm style selection\&. |
340 | gives xterm style selection\&. |
305 | .IP "\fBscrollstyle:\fP \fImode\fP" |
341 | .IP "\fBscrollstyle:\fP \fImode\fP" |
… | |
… | |
605 | .PP |
641 | .PP |
606 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
642 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
607 | .PP |
643 | .PP |
608 | .SH "FTP LOCATION" |
644 | .SH "FTP LOCATION" |
609 | .PP |
645 | .PP |
610 | rxvt-3\&.1\&.tar\&.gz can be found at the following ftp sites |
646 | rxvt-3\&.3\&.tar\&.gz can be found at the following ftp sites |
611 | ftp://ftp\&.rxvt\&.org/pub/rxvt |
647 | ftp://ftp\&.rxvt\&.org/pub/rxvt |
612 | .PP |
648 | .PP |
613 | .SH "CURRENT PROJECT COORDINATOR" |
649 | .SH "CURRENT PROJECT COORDINATOR" |
614 | .PP |
650 | .PP |
615 | .IP "Project Coordinator" |
651 | .IP "Project Coordinator" |