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

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

4 4
5SYNOPSIS 5SYNOPSIS
6 rxvt [options] [-e command [ args ]] 6 rxvt [options] [-e command [ args ]]
7 7
8DESCRIPTION 8DESCRIPTION
9 rxvt-unicode, version 7.4, is a colour vt102 terminal emulator intended 9 rxvt-unicode, version 7.5, is a colour vt102 terminal emulator intended
10 as an *xterm*(1) replacement for users who do not require features such 10 as an *xterm*(1) replacement for users who do not require features such
11 as Tektronix 4014 emulation and toolkit-style configurability. As a 11 as Tektronix 4014 emulation and toolkit-style configurability. As a
12 result, rxvt-unicode uses much less swap space -- a significant 12 result, rxvt-unicode uses much less swap space -- a significant
13 advantage on a machine serving many X sessions. 13 advantage on a machine serving many X sessions.
14 14
1175 It is also possible to specify the colour values of foreground, 1175 It is also possible to specify the colour values of foreground,
1176 background, cursorColor, cursorColor2, colorBD, colorUL as a number 1176 background, cursorColor, cursorColor2, colorBD, colorUL as a number
1177 0-15, as a convenient shorthand to reference the colour name of 1177 0-15, as a convenient shorthand to reference the colour name of
1178 color0-color15. 1178 color0-color15.
1179 1179
1180 If Xft support has been compiled in and as long as Xft/Xrender/X don't
1181 get their act together, rxvt-unicode will support
1182 "rgba:rrrr/gggg/bbbb/aaaa" (recommended, but MUST have 4
1183 digits/component), "#ARGB", "#AARRGGBB" and "#AAAARRRRGGGGBBBB" colour
1184 specifications, in addition to the ones provided by X, where the
1185 additional A component specifies alpha (opacity) values (0 is completely
1186 transparent and the maximum is opaque). You probably need to specify
1187 "-depth 32", too, and have the luck that your X-server uses ARGB pixel
1188 layout, as X is far from just supporting ARGB visuals out of the box,
1189 and rxvt-unicode just fudges around.
1190
1191 *Please note that transparency of any kind if completely unsupported by
1192 the author. Don't bug him with installation questions!*
1193
1194 Note that -rv ("reverseVideo: True") simulates reverse video by always 1180 Note that -rv ("reverseVideo: True") simulates reverse video by always
1195 swapping the foreground/background colours. This is in contrast to 1181 swapping the foreground/background colours. This is in contrast to
1196 *xterm*(1) where the colours are only swapped if they have not otherwise 1182 *xterm*(1) where the colours are only swapped if they have not otherwise
1197 been specified. For example, 1183 been specified. For example,
1198 1184
1199 rxvt -fg Black -bg White -rv 1185 rxvt -fg Black -bg White -rv
1200 would yield White on Black, while on *xterm*(1) it would yield Black 1186 would yield White on Black, while on *xterm*(1) it would yield Black
1201 on White. 1187 on White.
1188
1189 ALPHA CHANNEL SUPPORT
1190 If Xft support has been compiled in and as long as Xft/Xrender/X don't
1191 get their act together, rxvt-unicode will support
1192 "rgba:rrrr/gggg/bbbb/aaaa" (recommended, but MUST have 4
1193 digits/component) colour specifications, in addition to the ones
1194 provided by X, where the additional A component specifies opacity
1195 (alpha) values. The minimum value of 0 is completely transparent). You
1196 can also prefix any color with "[a]", where "a" is on to four hex digits
1197 specifiying the opacity value.
1198
1199 You probably need to specify "-depth 32", too, and have the luck that
1200 your X-server uses ARGB pixel layout, as X is far from just supporting
1201 ARGB visuals out of the box, and rxvt-unicode just fudges around.
1202
1203 For example, the following selects an almost completely transparent red
1204 background, and an almost opaque pink foreground:
1205
1206 rxvt -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink"
1207
1208 *Please note that transparency of any kind if completely unsupported by
1209 the author. Don't bug him with installation questions!*
1202 1210
1203ENVIRONMENT 1211ENVIRONMENT
1204 rxvt sets and/or uses the following environment variables: 1212 rxvt sets and/or uses the following environment variables:
1205 1213
1206 TERM 1214 TERM

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines