--- rxvt-unicode/doc/rxvt.1.man.in 2006/01/25 21:48:47 1.53 +++ rxvt-unicode/doc/rxvt.1.man.in 2006/01/31 00:25:16 1.57 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "rxvt 1" -.TH rxvt 1 "2006-01-25" "7.3" "RXVT-UNICODE" +.TH rxvt 1 "2006-01-31" "7.5" "RXVT-UNICODE" .SH "NAME" rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) .SH "SYNOPSIS" @@ -218,7 +218,7 @@ \&\fB\s-1DISPLAY\s0\fR environment variable is used. .IP "\fB\-depth\fR \fIbitdepth\fR" 4 .IX Item "-depth bitdepth" -Compile \fIfrills\fR: Attempt to find a visual with the given bit depth; +Compile \fIxft\fR: Attempt to find a visual with the given bit depth; resource \fBdepth\fR. .IP "\fB\-geometry\fR \fIgeom\fR" 4 .IX Item "-geometry geom" @@ -233,6 +233,9 @@ .IX Item "-ip|+ip | -tr|+tr" Turn on/off inheriting parent window's pixmap. Alternative form is \&\fB\-tr\fR; resource \fBinheritPixmap\fR. +.Sp +\&\fIPlease note that transparency of any kind if completely unsupported by +the author. Don't bug him with installation questions!\fR .IP "\fB\-fade\fR \fInumber\fR" 4 .IX Item "-fade number" Fade the text by the given percentage when focus is lost. Small values @@ -241,7 +244,7 @@ .IP "\fB\-fadecolor\fR \fIcolour\fR" 4 .IX Item "-fadecolor colour" Fade to this colour when fading is used (see \fB\-fade\fR). The default colour -is black. resource \fBfadeColor\fR. +is opaque black. resource \fBfadeColor\fR. .IP "\fB\-tint\fR \fIcolour\fR" 4 .IX Item "-tint colour" Tint the transparent background pixmap with the given colour when @@ -586,7 +589,7 @@ extensions not documented here): .IP "\fBdepth:\fR \fIbitdepth\fR" 4 .IX Item "depth: bitdepth" -Compile \fIfrills\fR: Attempt to find a visual with the given bit depth; +Compile \fIxft\fR: Attempt to find a visual with the given bit depth; option \fB\-depth\fR. .IP "\fBgeometry:\fR \fIgeom\fR" 4 .IX Item "geometry: geom" @@ -659,6 +662,9 @@ \&\fBTrue\fR: make the background inherit the parent windows' pixmap, giving artificial transparency. \fBFalse\fR: do not inherit the parent windows' pixmap. +.Sp +\&\fIPlease note that transparency of any kind if completely unsupported by +the author. Don't bug him with installation questions!\fR .IP "\fBfading:\fR \fInumber\fR" 4 .IX Item "fading: number" Fade the text by the given percentage when focus is lost; option \fB\-fade\fR. @@ -1309,7 +1315,7 @@ In addition to the default foreground and background colours, \&\fB@@RXVT_NAME@@\fR can display up to 16 colours (8 \s-1ANSI\s0 colours plus high-intensity bold/blink versions of the same). Here is a list of the -colours with their \fBrgb.txt\fR names. +colours with their names. .TS l l l . color0 (black) = Black @@ -1346,6 +1352,29 @@ .IX Item "@@RXVT_NAME@@ -fg Black -bg White -rv" would yield White on Black, while on \fIxterm\fR(1) it would yield Black on White. +.Sh "\s-1ALPHA\s0 \s-1CHANNEL\s0 \s-1SUPPORT\s0" +.IX Subsection "ALPHA CHANNEL SUPPORT" +If Xft support has been compiled in and as long as Xft/Xrender/X don't get +their act together, rxvt-unicode will support \f(CW\*(C`rgba:rrrr/gggg/bbbb/aaaa\*(C'\fR +(recommended, but \fB\s-1MUST\s0\fR have 4 digits/component) colour specifications, +in addition to the ones provided by X, where the additional A component +specifies opacity (alpha) values. The minimum value of \f(CW0\fR is completely +transparent). You can also prefix any color with \f(CW\*(C`[a]\*(C'\fR, where \f(CW\*(C`a\*(C'\fR is on +to four hex digits specifiying the opacity value. +.PP +You probably need to specify \fB\*(L"\-depth 32\*(R"\fR, too, and have the luck that +your X\-server uses \s-1ARGB\s0 pixel layout, as X is far from just supporting +\&\s-1ARGB\s0 visuals out of the box, and rxvt-unicode just fudges around. +.PP +For example, the following selects an almost completely transparent red +background, and an almost opaque pink foreground: +.PP +.Vb 1 +\& @@RXVT_NAME@@ -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink" +.Ve +.PP +\&\fIPlease note that transparency of any kind if completely unsupported by +the author. Don't bug him with installation questions!\fR .SH "ENVIRONMENT" .IX Header "ENVIRONMENT" \&\fB@@RXVT_NAME@@\fR sets and/or uses the following environment variables: