ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.1.man.in
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.1.man.in (file contents):
Revision 1.56 by root, Sun Jan 29 22:38:43 2006 UTC vs.
Revision 1.57 by root, Tue Jan 31 00:25:16 2006 UTC

127.\} 127.\}
128.rm #[ #] #H #V #F C 128.rm #[ #] #H #V #F C
129.\" ======================================================================== 129.\" ========================================================================
130.\" 130.\"
131.IX Title "rxvt 1" 131.IX Title "rxvt 1"
132.TH rxvt 1 "2006-01-29" "7.4" "RXVT-UNICODE" 132.TH rxvt 1 "2006-01-31" "7.5" "RXVT-UNICODE"
133.SH "NAME" 133.SH "NAME"
134rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) 134rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system)
135.SH "SYNOPSIS" 135.SH "SYNOPSIS"
136.IX Header "SYNOPSIS" 136.IX Header "SYNOPSIS"
137\&\fB@@RXVT_NAME@@\fR [options] [\-e command [ args ]] 137\&\fB@@RXVT_NAME@@\fR [options] [\-e command [ args ]]
1342It is also possible to specify the colour values of \fBforeground\fR, 1342It is also possible to specify the colour values of \fBforeground\fR,
1343\&\fBbackground\fR, \fBcursorColor\fR, \fBcursorColor2\fR, \fBcolorBD\fR, \fBcolorUL\fR as 1343\&\fBbackground\fR, \fBcursorColor\fR, \fBcursorColor2\fR, \fBcolorBD\fR, \fBcolorUL\fR as
1344a number 0\-15, as a convenient shorthand to reference the colour name of 1344a number 0\-15, as a convenient shorthand to reference the colour name of
1345color0\-color15. 1345color0\-color15.
1346.PP 1346.PP
1347If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1348their act together, rxvt-unicode will support \f(CW\*(C`rgba:rrrr/gggg/bbbb/aaaa\*(C'\fR
1349(recommended, but \fB\s-1MUST\s0\fR have 4 digits/component), \f(CW\*(C`#ARGB\*(C'\fR, \f(CW\*(C`#AARRGGBB\*(C'\fR
1350and \f(CW\*(C`#AAAARRRRGGGGBBBB\*(C'\fR colour specifications, in addition to the ones
1351provided by X, where the additional A component specifies alpha (opacity)
1352values (0 is completely transparent and the maximum is opaque). You
1353probably need to specify \fB\*(L"\-depth 32\*(R"\fR, too, and have the luck that your
1354X\-server uses \s-1ARGB\s0 pixel layout, as X is far from just supporting \s-1ARGB\s0
1355visuals out of the box, and rxvt-unicode just fudges around.
1356.PP
1357\&\fIPlease note that transparency of any kind if completely unsupported by
1358the author. Don't bug him with installation questions!\fR
1359.PP
1360Note that \fB\-rv\fR (\fB\*(L"reverseVideo: True\*(R"\fR) simulates reverse video by 1347Note that \fB\-rv\fR (\fB\*(L"reverseVideo: True\*(R"\fR) simulates reverse video by
1361always swapping the foreground/background colours. This is in contrast to 1348always swapping the foreground/background colours. This is in contrast to
1362\&\fIxterm\fR(1) where the colours are only swapped if they have not otherwise 1349\&\fIxterm\fR(1) where the colours are only swapped if they have not otherwise
1363been specified. For example, 1350been specified. For example,
1364.IP "\fB@@RXVT_NAME@@ \-fg Black \-bg White \-rv\fR" 4 1351.IP "\fB@@RXVT_NAME@@ \-fg Black \-bg White \-rv\fR" 4
1365.IX Item "@@RXVT_NAME@@ -fg Black -bg White -rv" 1352.IX Item "@@RXVT_NAME@@ -fg Black -bg White -rv"
1366would yield White on Black, while on \fIxterm\fR(1) it would yield Black 1353would yield White on Black, while on \fIxterm\fR(1) it would yield Black
1367on White. 1354on White.
1355.Sh "\s-1ALPHA\s0 \s-1CHANNEL\s0 \s-1SUPPORT\s0"
1356.IX Subsection "ALPHA CHANNEL SUPPORT"
1357If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1358their act together, rxvt-unicode will support \f(CW\*(C`rgba:rrrr/gggg/bbbb/aaaa\*(C'\fR
1359(recommended, but \fB\s-1MUST\s0\fR have 4 digits/component) colour specifications,
1360in addition to the ones provided by X, where the additional A component
1361specifies opacity (alpha) values. The minimum value of \f(CW0\fR is completely
1362transparent). You can also prefix any color with \f(CW\*(C`[a]\*(C'\fR, where \f(CW\*(C`a\*(C'\fR is on
1363to four hex digits specifiying the opacity value.
1364.PP
1365You probably need to specify \fB\*(L"\-depth 32\*(R"\fR, too, and have the luck that
1366your X\-server uses \s-1ARGB\s0 pixel layout, as X is far from just supporting
1367\&\s-1ARGB\s0 visuals out of the box, and rxvt-unicode just fudges around.
1368.PP
1369For example, the following selects an almost completely transparent red
1370background, and an almost opaque pink foreground:
1371.PP
1372.Vb 1
1373\& @@RXVT_NAME@@ -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink"
1374.Ve
1375.PP
1376\&\fIPlease note that transparency of any kind if completely unsupported by
1377the author. Don't bug him with installation questions!\fR
1368.SH "ENVIRONMENT" 1378.SH "ENVIRONMENT"
1369.IX Header "ENVIRONMENT" 1379.IX Header "ENVIRONMENT"
1370\&\fB@@RXVT_NAME@@\fR sets and/or uses the following environment variables: 1380\&\fB@@RXVT_NAME@@\fR sets and/or uses the following environment variables:
1371.IP "\fB\s-1TERM\s0\fR" 4 1381.IP "\fB\s-1TERM\s0\fR" 4
1372.IX Item "TERM" 1382.IX Item "TERM"

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines