--- rxvt-unicode/doc/rxvt.1.txt 2006/01/26 00:09:47 1.53 +++ rxvt-unicode/doc/rxvt.1.txt 2006/01/31 00:25:16 1.56 @@ -6,7 +6,7 @@ rxvt [options] [-e command [ args ]] DESCRIPTION - rxvt-unicode, version 7.3a, is a colour vt102 terminal emulator intended + rxvt-unicode, version 7.5, 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 @@ -87,7 +87,7 @@ the DISPLAY environment variable is used. -depth *bitdepth* - Compile *frills*: Attempt to find a visual with the given bit depth; + Compile *xft*: Attempt to find a visual with the given bit depth; resource depth. -geometry *geom* @@ -103,6 +103,9 @@ Turn on/off inheriting parent window's pixmap. Alternative form is -tr; resource inheritPixmap. + *Please note that transparency of any kind if completely unsupported + by the author. Don't bug him with installation questions!* + -fade *number* Fade the text by the given percentage when focus is lost. Small values fade a little only, 100 completely replaces all colours by @@ -110,7 +113,7 @@ -fadecolor *colour* Fade to this colour when fading is used (see -fade). The default - colour is black. resource fadeColor. + colour is opaque black. resource fadeColor. -tint *colour* Tint the transparent background pixmap with the given colour when @@ -439,7 +442,7 @@ documented here): depth: *bitdepth* - Compile *frills*: Attempt to find a visual with the given bit depth; + Compile *xft*: Attempt to find a visual with the given bit depth; option -depth. geometry: *geom* @@ -512,6 +515,9 @@ artificial transparency. False: do not inherit the parent windows' pixmap. + *Please note that transparency of any kind if completely unsupported + by the author. Don't bug him with installation questions!* + fading: *number* Fade the text by the given percentage when focus is lost; option -fade. @@ -1145,8 +1151,7 @@ COLORS AND GRAPHICS In addition to the default foreground and background colours, rxvt can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink - versions of the same). Here is a list of the colours with their rgb.txt - names. + versions of the same). Here is a list of the colours with their names. color0 (black) = Black color1 (red) = Red3 @@ -1181,6 +1186,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: