--- rxvt-unicode/doc/rxvt.1.pod 2010/06/15 11:45:48 1.180 +++ rxvt-unicode/doc/rxvt.1.pod 2010/12/18 12:20:18 1.192 @@ -126,14 +126,11 @@ =item B<-tr>|B<+tr> -Turn on/off illusion of a transparent window background; resource B. +Turn on/off pseudo-transparency by using the root pixmap as background; resource B. B<-ip> is still accepted as an obsolete alias but will be removed in future versions. -I - =item B<-fade> I Fade the text by the given percentage when focus is lost. Small values @@ -147,29 +144,19 @@ =item B<-tint> I -Tint the transparent background pixmap with the given colour when -transparency is enabled with B<-tr>. This only works for -non-tiled backgrounds, currently. See also the B<-sh> option that can be -used to brighten or darken the image in addition to tinting it. -Please note that certain tint colours can be applied on the server-side, -thus yielding performance gain of two orders of magnitude. These colours are: -blue, red, green, cyan, magenta, yellow, and those close to them. Also -pure black and pure white colours essentially mean no tinting; resource -I. Example: - - @@RXVT_NAME@@ -tr -tint blue -sh 40 +Tint the transparent background with the given colour; +resource I. =item B<-sh> I -Darken (0 .. 100) or lighten (100 .. 200) the transparent -background image in addition to (or instead of) tinting it; -resource I. +Darken (0 .. 99) or lighten (101 .. 200) the transparent background. +A value of 100 means no shading; resource I. =item B<-blt> I Specify background blending type. If background pixmap is specified at the same time as transparency - such pixmap will be blended over -transparency image, using method specified. Supported values are : +the transparent background, using the method specified. Supported values are: B, B, B - colour values averaging, B, B, B, B, B, B, B, B, B, B, B, B. The default is @@ -178,15 +165,15 @@ =item B<-blr> I Apply Gaussian Blur with the specified radii to the transparent -background image. If single number is specified - both vertical and +background. If a single number is specified - both vertical and horizontal radii are considered to be the same. Setting one of the radii to 1 and another to a large number creates interesting effects -on some backgrounds. Maximum radius value is 128. Compile I; +on some backgrounds. Maximum radius value is 128; resource I. =item B<-icon> I -Compile I: Use the specified image as application icon. This +Compile I or I: Use the specified image as application icon. This is used by many window managers, taskbars and pagers to represent the application window; resource I. @@ -200,7 +187,7 @@ =item B<-pixmap> I -Compile I: Specify image file for the background and also +Compile I or I: Specify image file for the background and also optionally specify its scaling with a geometry string. Note you may need to add quotes to avoid special shell interpretation of the C<;> in the command-line; for more details see resource B. @@ -704,14 +691,11 @@ =item B I -Turn on/off illusion of a transparent window background. +Turn on/off pseudo-transparency by using the root pixmap as background. B is still accepted as an obsolete alias but will be removed in future versions. -I - =item B I Fade the text by the given percentage when focus is lost; option B<-fade>. @@ -723,13 +707,16 @@ =item B I -Tint the transparent background pixmap with the given colour; option -B<-tint>. +Tint the transparent background with the given colour. If the RENDER +extension is not available only black, red, green, yellow, blue, +magenta, cyan and white tints can be performed server-side. Note that +a black tint yields a completely black image while a white tint yields +the image unchanged; option B<-tint>. =item B I -Darken (0 .. 100) or lighten (-1 .. -100) the transparent background image -in addition to tinting it; option B<-sh>. +Darken (0 .. 99) or lighten (101 .. 200) the transparent background. +A value of 100 means no shading; option B<-sh>. =item B I @@ -738,7 +725,7 @@ =item B I Apply gaussian blur with the specified radius to the transparent -background image; option B<-blr>. +background; option B<-blr>. =item B I @@ -762,12 +749,10 @@ Use the specified image file for the background and also optionally specify its scaling with a geometry string B, -(default C<0x0+50+50>) in which B<"W" / "H"> specify the +(default C<100x100+50+50>) in which B<"W" / "H"> specify the horizontal/vertical scale (percent), and B<"X" / "Y"> locate the image -centre (percent). A scale of 0 displays the image with tiling. A scale -of 1 displays the image without any scaling. A scale of 2 to 9 specifies -an integer number of images in that direction. No image will be magnified -beyond 10 times its original size. The maximum permitted scale is 1000. +centre (percent). A scale of 0 displays the image with tiling. +The maximum permitted scale is 1000. Additional operations can be specified after colon B<:op1:op2...>. Supported operations are: @@ -781,8 +766,9 @@ whenever terminal window moves If used in conjunction with B<-tr> option, the specified pixmap will be -blended over transparency image using either alpha-blending, or any -other blending type, specified with B<-blt "type"> option. +blended over the transparent background using alpha-blending. If I +support has been compiled in it is possible to choose other blending +types with B<-blt "type"> option. =item B I @@ -1171,7 +1157,7 @@ performed in an exact manner; however, the closest match is assured. I may contain escape values (C<\n>: newline, C<\000>: octal -number), see RESOURCES in C for futher details. +number), see RESOURCES in C for further details. You can define a range of keysyms in one shot by providing a I with pattern B, where the delimiter `/' @@ -1202,7 +1188,7 @@ URxvt.keysym.M-C-c: perl:selection:rot13 Due the the large number of modifier combinations, a defined key mapping -will match if at I the specified identifiers are being set, and +will match if I the specified identifiers are being set, and no other key mappings with those and more bits are being defined. That means that defining a key map for C will automatically provide definitions for C, C and so on, unless some of those are defined @@ -1530,7 +1516,7 @@ If Xft support has been compiled in and as long as Xft/Xrender/X don't get their act together, rxvt-unicode will do it's own alpha channel management: -You can prefix any colour with an opaquenes percentage enclosed in +You can prefix any colour with an opaqueness percentage enclosed in brackets, i.e. C<[percent]>, where C is a decimal percentage (0-100) that specifies the opacity of the colour, where C<0> is completely transparent and C<100> is completely opaque. For example, C<[50]red> is a @@ -1625,7 +1611,7 @@ The unix domain socket path used by @@RXVT_NAME@@c(1) and @@RXVT_NAME@@d(1). -Default F<<< $HOME/.rxvt-unicode-I<< > >>>. +Default F<<< $HOME/.rxvt-unicode-I<< >> >>>. =item B @@ -1635,7 +1621,7 @@ =item B -Directory where various X resource files are being located. +Directory where application-specific X resource files are located. =item B @@ -1711,7 +1697,7 @@ =item Emanuele Giaquinta L<< >> -Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing. +pty/utmp code rewrite, image code improvements, many random hacks and bugfixes. =back