1 | .if !\n(.g .ab GNU tbl requires GNU troff. |
1 | .if !\n(.g .ab GNU tbl requires GNU troff. |
2 | .if !dTS .ds TS |
2 | .if !dTS .ds TS |
3 | .if !dTE .ds TE |
3 | .if !dTE .ds TE |
4 | .TH "RXVT" "1" "2004-07-26" "X Version 11" "X Tools" |
4 | .TH "RXVT" "1" "2004-08-11" "X Version 11" "X Tools" |
5 | .SH "NAME" |
5 | .SH "NAME" |
6 | rxvt-unicode (ouR XVT, unicode) \- a VT102 emulator for the X window system |
6 | rxvt-unicode (ouR XVT, unicode) \- a VT102 emulator for the X window system |
7 | .PP |
7 | .PP |
8 | .SH "SYNOPSIS" |
8 | .SH "SYNOPSIS" |
9 | .PP |
9 | .PP |
10 | \fBrxvt\fP [options] [-e command [ args ]] |
10 | \fBrxvt\fP [options] [-e command [ args ]] |
11 | .PP |
11 | .PP |
12 | .SH "DESCRIPTION" |
12 | .SH "DESCRIPTION" |
13 | .PP |
13 | .PP |
14 | \fBrxvt-unicode\fP, version \fB3\&.3\fP, is a colour vt102 terminal emulator |
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 |
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\&. |
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 |
17 | As a result, \fBrxvt-unicode\fP uses much less swap space -- a significant |
18 | advantage on a machine serving many X sessions\&. |
18 | advantage on a machine serving many X sessions\&. |
19 | .PP |
19 | .PP |
… | |
… | |
57 | is \fB-tr\fP; |
57 | is \fB-tr\fP; |
58 | resource \fBinheritPixmap\fP\&. |
58 | resource \fBinheritPixmap\fP\&. |
59 | .IP "\fB-fade\fP \fInumber\fP" |
59 | .IP "\fB-fade\fP \fInumber\fP" |
60 | Fade the text by the given percentage when focus is lost\&. |
60 | Fade the text by the given percentage when focus is lost\&. |
61 | .IP "\fB-tint\fP \fIcolour\fP" |
61 | .IP "\fB-tint\fP \fIcolour\fP" |
62 | Tint the transparent background pixmap with the given colour\&. |
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)\&. |
63 | .IP "\fB-bg\fP \fIcolour\fP" |
70 | .IP "\fB-bg\fP \fIcolour\fP" |
64 | Window background colour; |
71 | Window background colour; |
65 | resource \fBbackground\fP\&. |
72 | resource \fBbackground\fP\&. |
66 | .IP "\fB-fg\fP \fIcolour\fP" |
73 | .IP "\fB-fg\fP \fIcolour\fP" |
67 | Window foreground colour; |
74 | Window foreground colour; |
68 | resource \fBforeground\fP\&. |
75 | resource \fBforeground\fP\&. |
69 | .IP "\fB-pixmap:\fP \fIfile[;geom]\fP" |
76 | .IP "\fB-pixmap\fP \fIfile[;geom]\fP" |
70 | Compile \fIXPM\fP: Specify XPM file for the background and also |
77 | Compile \fIXPM\fP: Specify XPM file for the background and also |
71 | optionally specify its scaling with a geometry string\&. Note you |
78 | optionally specify its scaling with a geometry string\&. Note you |
72 | may need to add quotes to avoid special shell interpretation of |
79 | may need to add quotes to avoid special shell interpretation of |
73 | the `;\&' in the command-line; |
80 | the `;\&' in the command-line; |
74 | resource \fBbackgroundPixmap\fP\&. |
81 | resource \fBbackgroundPixmap\fP\&. |
… | |
… | |
148 | resource \fBinternalBorder\fP\&. |
155 | resource \fBinternalBorder\fP\&. |
149 | .IP "\fB-w\fP \fInumber\fP" |
156 | .IP "\fB-w\fP \fInumber\fP" |
150 | Compile \fIfrills\fP: External border of \fInumber\fP pixels\&. |
157 | Compile \fIfrills\fP: External border of \fInumber\fP pixels\&. |
151 | Also, \fB-bw\fP and \fB-borderwidth\fP\&. See resource entry for limits; |
158 | Also, \fB-bw\fP and \fB-borderwidth\fP\&. See resource entry for limits; |
152 | resource \fBexternalBorder\fP\&. |
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\&. |
153 | .IP "\fB-lsp\fP \fInumber\fP" |
164 | .IP "\fB-lsp\fP \fInumber\fP" |
154 | Compile \fIlinespace\fP: Lines (pixel height) to insert between each |
165 | Compile \fIlinespace\fP: Lines (pixel height) to insert between each |
155 | row of the display; |
166 | row of the display; |
156 | resource \fBlinespace\fP\&. |
167 | resource \fBlinespace\fP\&. |
157 | .IP "\fB-tn\fP \fItermname\fP" |
168 | .IP "\fB-tn\fP \fItermname\fP" |
… | |
… | |
211 | in some window managers\&. |
222 | in some window managers\&. |
212 | .SH "RESOURCES (available also as long-options)" |
223 | .SH "RESOURCES (available also as long-options)" |
213 | .PP |
224 | .PP |
214 | Note: `rxvt --help\&' gives a list of all resources (long options) compiled |
225 | Note: `rxvt --help\&' gives a list of all resources (long options) compiled |
215 | into your version\&. |
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 |
216 | If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists |
235 | If compiled with internal Xresources support (i\&.e\&. \fBrxvt |
217 | \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application defaults set in |
236 | -h\fP lists \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application |
218 | XAPPLOADDIR/Rxvt (compile-time defined: usually |
237 | defaults set in XAPPLOADDIR/URxvt (compile-time defined: usually |
219 | \fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP, |
238 | \fB/usr/lib/X11/app-defaults/URxvt\fP) and resources set in |
220 | or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when |
239 | \fB~/\&.Xdefaults\fP, or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. |
221 | reading X resources, \fBrxvt\fP recognizes two class names: \fBXTerm\fP and |
240 | Note that when reading X resources, \fBrxvt\fP recognizes two class |
222 | \fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both |
241 | names: \fBXTerm\fP and \fBURxvt\fP\&. The class name \fBRxvt\fP allows resources |
223 | \fBrxvt\fP and \fIxterm\fP to be easily configured, while the class name |
242 | common to both \fBrxvt\fP and the original \fIrxvt\fP to be easily configured, |
224 | \fBRxvt\fP allows resources unique to \fBrxvt\fP, notably colours and |
243 | while the class name \fBURxvt\fP allows resources unique to \fBrxvt\fP, |
225 | key-handling, to be shared between different \fBrxvt\fP configurations\&. |
244 | notably colours and key-handling, to be shared between different |
226 | If no resources are specified, suitable defaults will be used\&. |
245 | \fBrxvt\fP configurations\&. If no resources are specified, suitable |
227 | Command-line arguments can be used to override resource settings\&. The |
246 | defaults will be used\&. Command-line arguments can be used to override |
228 | following resources are allowed: |
247 | resource settings\&. The following resources are allowed: |
229 | .PP |
248 | .PP |
230 | .IP "\fBgeometry:\fP \fIgeom\fP" |
249 | .IP "\fBgeometry:\fP \fIgeom\fP" |
231 | Create the window with the specified X window geometry [default |
250 | Create the window with the specified X window geometry [default |
232 | 80x24]; |
251 | 80x24]; |
233 | option \fB-geometry\fP\&. |
252 | option \fB-geometry\fP\&. |
… | |
… | |
279 | option \fB+j\fP\&. |
298 | option \fB+j\fP\&. |
280 | .IP "\fBinheritPixmap:\fP \fIboolean\fP" |
299 | .IP "\fBinheritPixmap:\fP \fIboolean\fP" |
281 | \fBTrue\fP: make the background inherit the parent windows\&' pixmap, |
300 | \fBTrue\fP: make the background inherit the parent windows\&' pixmap, |
282 | giving artificial transparency\&. |
301 | giving artificial transparency\&. |
283 | \fBFalse\fP: do not inherit the parent windows\&' pixmap\&. |
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\&. |
284 | .IP "\fBtintColor:\fP \fIcolour\fP" |
305 | .IP "\fBtintColor:\fP \fIcolour\fP" |
285 | Tint the transparent background pixmap with the given colour\&. |
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\&. |
286 | .IP "\fBscrollColor:\fP \fIcolour\fP" |
312 | .IP "\fBscrollColor:\fP \fIcolour\fP" |
287 | Use the specified colour for the scrollbar [default #B2B2B2]\&. |
313 | Use the specified colour for the scrollbar [default #B2B2B2]\&. |
288 | .IP "\fBtroughColor:\fP \fIcolour\fP" |
314 | .IP "\fBtroughColor:\fP \fIcolour\fP" |
289 | Use the specified colour for the scrollbar\&'s trough area [default |
315 | Use the specified colour for the scrollbar\&'s trough area [default |
290 | #969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. |
316 | #969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. |
… | |
… | |
417 | Internal border of \fInumber\fP pixels\&. This resource is limited to 100; |
443 | Internal border of \fInumber\fP pixels\&. This resource is limited to 100; |
418 | option \fB-b\fP\&. |
444 | option \fB-b\fP\&. |
419 | .IP "\fBexternalBorder:\fP \fInumber\fP" |
445 | .IP "\fBexternalBorder:\fP \fInumber\fP" |
420 | External border of \fInumber\fP pixels\&. This resource is limited to 100; |
446 | External border of \fInumber\fP pixels\&. This resource is limited to 100; |
421 | option \fB-w\fP, \fB-bw\fP, \fB-borderwidth\fP\&. |
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\&. |
422 | .IP "\fBtermName:\fP \fItermname\fP" |
452 | .IP "\fBtermName:\fP \fItermname\fP" |
423 | Specifies the terminal type name to be set in the \fBTERM\fP |
453 | Specifies the terminal type name to be set in the \fBTERM\fP |
424 | environment variable; |
454 | environment variable; |
425 | option \fB-tn\fP\&. |
455 | option \fB-tn\fP\&. |
426 | .IP "\fBlinespace:\fP \fInumber\fP" |
456 | .IP "\fBlinespace:\fP \fInumber\fP" |
… | |
… | |
1079 | .PP |
1109 | .PP |
1080 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
1110 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
1081 | .PP |
1111 | .PP |
1082 | .SH "FTP LOCATION" |
1112 | .SH "FTP LOCATION" |
1083 | .PP |
1113 | .PP |
1084 | rxvt-3\&.3\&.tar\&.gz can be found at the following ftp sites |
1114 | rxvt-3\&.5\&.tar\&.gz can be found at the following ftp sites |
1085 | ftp://ftp\&.rxvt\&.org/pub/rxvt |
1115 | ftp://ftp\&.rxvt\&.org/pub/rxvt |
1086 | .PP |
1116 | .PP |
1087 | .SH "CURRENT PROJECT COORDINATOR" |
1117 | .SH "CURRENT PROJECT COORDINATOR" |
1088 | .PP |
1118 | .PP |
1089 | .IP "Project Coordinator" |
1119 | .IP "Project Coordinator" |