--- rxvt-unicode/doc/rxvt.1.pod	2006/01/29 22:27:04	1.109
+++ rxvt-unicode/doc/rxvt.1.pod	2006/01/31 00:25:16	1.111
@@ -117,6 +117,9 @@
 Turn on/off inheriting parent window's pixmap. Alternative form is
 B<-tr>; resource B<inheritPixmap>.
 
+I<Please note that transparency of any kind if completely unsupported by
+the author. Don't bug him with installation questions!>
+
 =item B<-fade> I<number>
 
 Fade the text by the given percentage when focus is lost. Small values
@@ -126,7 +129,7 @@
 =item B<-fadecolor> I<colour>
 
 Fade to this colour when fading is used (see B<-fade>). The default colour
-is black. resource B<fadeColor>.
+is opaque black. resource B<fadeColor>.
 
 =item B<-tint> I<colour>
 
@@ -599,6 +602,9 @@
 artificial transparency. B<False>: do not inherit the parent windows'
 pixmap.
 
+I<Please note that transparency of any kind if completely unsupported by
+the author. Don't bug him with installation questions!>
+
 =item B<fading:> I<number>
 
 Fade the text by the given percentage when focus is lost; option B<-fade>.
@@ -1342,16 +1348,6 @@
 a number 0-15, as a convenient shorthand to reference the colour name of
 color0-color15.
 
-If Xft support has been compiled in and as long as Xft/Xrender/X don't get
-their act together, rxvt-unicode will support C<rgba:rrrr/gggg/bbbb/aaaa>
-(recommended, but B<MUST> have 4 digits/component), C<#ARGB>, C<#AARRGGBB>
-and C<#AAAARRRRGGGGBBBB> colour specifications, in addition to the ones
-provided by X, where the additional A component specifies alpha (opacity)
-values (0 is completely transparent and the maximum is opaque). You
-probably need to specify B<"-depth 32">, too, and have the luck that your
-X-server uses ARGB pixel layout, as X is far from just supporting ARGB
-visuals out of the box, and rxvt-unicode just fudges around.
-
 Note that B<-rv> (B<"reverseVideo: True">) simulates reverse video by
 always swapping the foreground/background colours. This is in contrast to
 I<xterm>(1) where the colours are only swapped if they have not otherwise
@@ -1366,6 +1362,28 @@
 
 =back
 
+=head2 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 C<rgba:rrrr/gggg/bbbb/aaaa>
+(recommended, but B<MUST> 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 C<0> is completely
+transparent). You can also prefix any color with C<[a]>, where C<a> is on
+to four hex digits specifiying the opacity value.
+
+You probably need to specify B<"-depth 32">, too, and have the luck that
+your X-server uses ARGB pixel layout, as X is far from just supporting
+ARGB visuals out of the box, and rxvt-unicode just fudges around.
+
+For example, the following selects an almost completely transparent red
+background, and an almost opaque pink foreground:
+
+   @@RXVT_NAME@@ -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink"
+
+I<Please note that transparency of any kind if completely unsupported by
+the author. Don't bug him with installation questions!>
+
 =head1 ENVIRONMENT
 
 B<@@RXVT_NAME@@> sets and/or uses the following environment variables: