1 | .TH "RXVT" "1" "2004-07-26" "X Version 11" "X Tools" |
1 | .TH "RXVT" "1" "2004-07-31" "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\&.3\fP, is a colour vt102 terminal emulator |
11 | \fBrxvt-unicode\fP, version \fB3\&.4\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\&. See also |
|
|
61 | the \fB-sh\fP option that can be used to brighten or darken |
|
|
62 | the image in addition to tinting it\&. |
|
|
63 | .IP "\fB-sh\fP" |
|
|
64 | \fInumber\fP |
|
|
65 | Darken (0 \&.\&. 100) or lighten (-1 \&.\&. -100) the transparent background |
|
|
66 | image in addition to tinting it (i\&.e\&. \fB-tint\fP must be specified, too)\&. |
58 | .IP "\fB-bg\fP \fIcolour\fP" |
67 | .IP "\fB-bg\fP \fIcolour\fP" |
59 | Window background colour; |
68 | Window background colour; |
60 | resource \fBbackground\fP\&. |
69 | resource \fBbackground\fP\&. |
61 | .IP "\fB-fg\fP \fIcolour\fP" |
70 | .IP "\fB-fg\fP \fIcolour\fP" |
62 | Window foreground colour; |
71 | Window foreground colour; |
63 | resource \fBforeground\fP\&. |
72 | resource \fBforeground\fP\&. |
64 | .IP "\fB-pixmap:\fP \fIfile[;geom]\fP" |
73 | .IP "\fB-pixmap\fP \fIfile[;geom]\fP" |
65 | Compile \fIXPM\fP: Specify XPM file for the background and also |
74 | Compile \fIXPM\fP: Specify XPM file for the background and also |
66 | optionally specify its scaling with a geometry string\&. Note you |
75 | optionally specify its scaling with a geometry string\&. Note you |
67 | may need to add quotes to avoid special shell interpretation of |
76 | may need to add quotes to avoid special shell interpretation of |
68 | the `;\&' in the command-line; |
77 | the `;\&' in the command-line; |
69 | resource \fBbackgroundPixmap\fP\&. |
78 | resource \fBbackgroundPixmap\fP\&. |
… | |
… | |
206 | in some window managers\&. |
215 | in some window managers\&. |
207 | .SH "RESOURCES (available also as long-options)" |
216 | .SH "RESOURCES (available also as long-options)" |
208 | .PP |
217 | .PP |
209 | Note: `rxvt --help\&' gives a list of all resources (long options) compiled |
218 | Note: `rxvt --help\&' gives a list of all resources (long options) compiled |
210 | into your version\&. |
219 | into your version\&. |
|
|
220 | .PP |
|
|
221 | There are two different methods that rxvt can use to get the |
|
|
222 | Xresource data: using the X libraries (Xrm*-functions) or internal Xresources |
|
|
223 | reader (\fB~/\&.Xdefaults\fP)\&. For the first method (ie\&. \fBrxvt -h\fP lists |
|
|
224 | \fBXGetDefaults\fP), you can set and change the resources using X11 |
|
|
225 | tools like \fBxset\fP\&. Many distribution do also load settings from the |
|
|
226 | \fB~/\&.Xresources\fP file when X starts\&. |
|
|
227 | .PP |
211 | If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists |
228 | If compiled with internal Xresources support (i\&.e\&. \fBrxvt |
212 | \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application defaults set in |
229 | -h\fP lists \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application |
213 | XAPPLOADDIR/Rxvt (compile-time defined: usually |
230 | defaults set in XAPPLOADDIR/URxvt (compile-time defined: usually |
214 | \fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP, |
231 | \fB/usr/lib/X11/app-defaults/URxvt\fP) and resources set in |
215 | or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when |
232 | \fB~/\&.Xdefaults\fP, or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. |
216 | reading X resources, \fBrxvt\fP recognizes two class names: \fBXTerm\fP and |
233 | Note that when reading X resources, \fBrxvt\fP recognizes two class |
217 | \fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both |
234 | names: \fBXTerm\fP and \fBURxvt\fP\&. The class name \fBRxvt\fP allows resources |
218 | \fBrxvt\fP and \fIxterm\fP to be easily configured, while the class name |
235 | common to both \fBrxvt\fP and the original \fIrxvt\fP to be easily configured, |
219 | \fBRxvt\fP allows resources unique to \fBrxvt\fP, notably colours and |
236 | while the class name \fBURxvt\fP allows resources unique to \fBrxvt\fP, |
220 | key-handling, to be shared between different \fBrxvt\fP configurations\&. |
237 | notably colours and key-handling, to be shared between different |
221 | If no resources are specified, suitable defaults will be used\&. |
238 | \fBrxvt\fP configurations\&. If no resources are specified, suitable |
222 | Command-line arguments can be used to override resource settings\&. The |
239 | defaults will be used\&. Command-line arguments can be used to override |
223 | following resources are allowed: |
240 | resource settings\&. The following resources are allowed: |
224 | .PP |
241 | .PP |
225 | .IP "\fBgeometry:\fP \fIgeom\fP" |
242 | .IP "\fBgeometry:\fP \fIgeom\fP" |
226 | Create the window with the specified X window geometry [default |
243 | Create the window with the specified X window geometry [default |
227 | 80x24]; |
244 | 80x24]; |
228 | option \fB-geometry\fP\&. |
245 | option \fB-geometry\fP\&. |
… | |
… | |
274 | option \fB+j\fP\&. |
291 | option \fB+j\fP\&. |
275 | .IP "\fBinheritPixmap:\fP \fIboolean\fP" |
292 | .IP "\fBinheritPixmap:\fP \fIboolean\fP" |
276 | \fBTrue\fP: make the background inherit the parent windows\&' pixmap, |
293 | \fBTrue\fP: make the background inherit the parent windows\&' pixmap, |
277 | giving artificial transparency\&. |
294 | giving artificial transparency\&. |
278 | \fBFalse\fP: do not inherit the parent windows\&' pixmap\&. |
295 | \fBFalse\fP: do not inherit the parent windows\&' pixmap\&. |
|
|
296 | .IP "\fBfading:\fP \fInumber\fP" |
|
|
297 | Fade the text by the given percentage when focus is lost\&. |
279 | .IP "\fBtintColor:\fP \fIcolour\fP" |
298 | .IP "\fBtintColor:\fP \fIcolour\fP" |
280 | Tint the transparent background pixmap with the given colour\&. |
299 | Tint the transparent background pixmap with the given colour\&. |
|
|
300 | .IP "\fBshading:\fP \fInumber\fP" |
|
|
301 | Darken (0 \&.\&. 100) or lighten (-1 \&.\&. -100) the transparent background |
|
|
302 | image in addition to tinting it\&. |
|
|
303 | .IP "\fBfading:\fP \fInumber\fP" |
|
|
304 | Scale the tint colour by the given percentage\&. |
281 | .IP "\fBscrollColor:\fP \fIcolour\fP" |
305 | .IP "\fBscrollColor:\fP \fIcolour\fP" |
282 | Use the specified colour for the scrollbar [default #B2B2B2]\&. |
306 | Use the specified colour for the scrollbar [default #B2B2B2]\&. |
283 | .IP "\fBtroughColor:\fP \fIcolour\fP" |
307 | .IP "\fBtroughColor:\fP \fIcolour\fP" |
284 | Use the specified colour for the scrollbar\&'s trough area [default |
308 | Use the specified colour for the scrollbar\&'s trough area [default |
285 | #969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. |
309 | #969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. |
… | |
… | |
627 | .PP |
651 | .PP |
628 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
652 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
629 | .PP |
653 | .PP |
630 | .SH "FTP LOCATION" |
654 | .SH "FTP LOCATION" |
631 | .PP |
655 | .PP |
632 | rxvt-3\&.3\&.tar\&.gz can be found at the following ftp sites |
656 | rxvt-3\&.4\&.tar\&.gz can be found at the following ftp sites |
633 | ftp://ftp\&.rxvt\&.org/pub/rxvt |
657 | ftp://ftp\&.rxvt\&.org/pub/rxvt |
634 | .PP |
658 | .PP |
635 | .SH "CURRENT PROJECT COORDINATOR" |
659 | .SH "CURRENT PROJECT COORDINATOR" |
636 | .PP |
660 | .PP |
637 | .IP "Project Coordinator" |
661 | .IP "Project Coordinator" |