--- rxvt-unicode/doc/rxvt.1.txt	2006/01/29 22:38:43	1.55
+++ rxvt-unicode/doc/rxvt.1.txt	2006/02/21 01:00:40	1.58
@@ -6,7 +6,7 @@
     rxvt [options] [-e command [ args ]]
 
 DESCRIPTION
-    rxvt-unicode, version 7.4, is a colour vt102 terminal emulator intended
+    rxvt-unicode, version 7.6, is a colour vt102 terminal emulator intended
     as an *xterm*(1) replacement for users who do not require features such
     as Tektronix 4014 emulation and toolkit-style configurability. As a
     result, rxvt-unicode uses much less swap space -- a significant
@@ -1177,19 +1177,14 @@
     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
-    "rgba:rrrr/gggg/bbbb/aaaa" (recommended, but MUST have 4
-    digits/component), "#ARGB", "#AARRGGBB" and "#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
-    "-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.
-
-    *Please note that transparency of any kind if completely unsupported by
-    the author. Don't bug him with installation questions!*
+    In addition to the colours defined above, rxvt offers an additional 72
+    colours. The first 64 of those (with indices 16 to 79) consist of a
+    4*4*4 RGB colour cube (i.e. *index = r * 16 + g * 4 + b + 16*), followed
+    by 8 additional shades of gray (with indices 80 to 87).
+
+    Together, all those colours implement the 88 colour xterm colours. Only
+    the first 16 can be changed using resources currently, the rest can only
+    be changed via command sequences ("escape codes").
 
     Note that -rv ("reverseVideo: True") simulates reverse video by always
     swapping the foreground/background colours. This is in contrast to
@@ -1200,6 +1195,28 @@
         would yield White on Black, while on *xterm*(1) it would yield Black
         on White.
 
+  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
+    "rgba:rrrr/gggg/bbbb/aaaa" (recommended, but 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 0 is completely transparent). You
+    can also prefix any color with "[a]", where "a" is on to four hex digits
+    specifiying the opacity value.
+
+    You probably need to specify "-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 -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink"
+
+    *Please note that transparency of any kind if completely unsupported by
+    the author. Don't bug him with installation questions!*
+
 ENVIRONMENT
     rxvt sets and/or uses the following environment variables: