--- rxvt-unicode/doc/rxvt.1.pod 2007/10/17 13:53:42 1.139 +++ rxvt-unicode/doc/rxvt.1.pod 2007/11/10 09:40:51 1.143 @@ -116,12 +116,16 @@ Turn on/off skip scrolling (allow multiple screens per refresh); resource B. -=item B<-ip>|B<+ip> | B<-tr>|B<+tr> +=item B<-tr>|B<+tr> -Turn on/off inheriting parent window's pixmap. Alternative form is -B<-tr>; resource B. +Turn on/off illusion of a transparent window background. Obsolete form of it is +B<-ip> and it should not be used anymore; resource B. -I is obsolete and should be +changed to B. Backwards compatibility support for B will +be phased out in future versions of rxvt!> + +I =item B<-fade> I @@ -138,19 +142,20 @@ =item B<-tint> I Tint the transparent background pixmap with the given colour when -transparency is enabled with B<-tr> or B<-ip>. This only works for +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; resource +blue, red, green, cyan, magenta, yellow, and those close to them. Also +pure black and pure white colors essentially mean no tinting; resource I. Example: @@RXVT_NAME@@ -tr -tint blue -sh 40 =item B<-sh> I -Darken (0 .. 100) or lighten (-1 .. -100) the transparent +Darken (0 .. 100) or lighten (100 .. 200) the transparent background image in addition to (or instead of) tinting it; resource I. @@ -162,7 +167,7 @@ B, B, B - color values averaging, B, B, B, B, B, B, B, B, B, B, B, B. The default is -alpha-blending; resource I. +alpha-blending. Compile I; resource I. =item B<-blr> I @@ -170,7 +175,8 @@ background image. If 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; resource I. +on some backgrounds. Maximum radius value is 128. Compile I; +resource I. =item B<-bg> I @@ -182,7 +188,7 @@ =item B<-pixmap> I -Compile I: Specify image file for the background and also +Compile 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. @@ -672,7 +678,7 @@ =item B I -Apply Gaussian Blurr with the specified radius to the transparent +Apply Gaussian Blurr with the specified radius to the transparent background image; option B<-blr>. =item B I @@ -691,18 +697,18 @@ =item B I -Use the specified image file for the background and also optionally -specify its scaling with a geometry string B, -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. -Special string of B<"auto"> used as a geometry will cause image to be +Use the specified image file for the background and also optionally +specify its scaling with a geometry string B, +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. +Special string of B<"auto"> used as a geometry will cause image to be automatically scaled to match window size. -If used in conjunction with B<-tr> option - specified pixmap will be -blended over transparency image using either alpha-blending, or any +If used in conjunction with B<-tr> option - specified pixmap will be +blended over transparency image using either alpha-blending, or any other blending type, specified with B<-blt "type"> option. [default 0x0+50+50] @@ -1467,8 +1473,8 @@ =item B Either C, C, depending on whether @@RXVT_NAME@@ was -compiled with background image support, and optionally with the added -extension C<-mono> to indicate that rxvt-unicode runs on a monochrome +compiled with background image support, and optionally with the added +extension C<-mono> to indicate that rxvt-unicode runs on a monochrome screen. =item B @@ -1478,7 +1484,7 @@ C to indicate that the default-colour escape sequence is to be used), C is the colour code used as default background colour (or the string C), and C is the string C if @@RXVT_NAME@@ -was compiled with background image support. Libraries like C +was compiled with background image support. Libraries like C and C can (and do) use this information to optimize screen output. =item B @@ -1580,7 +1586,7 @@ =item Geoff Wing L<< >> Rewrote screen display and text selection routines. - + Project Coordinator (changes.txt 2.4.6 - rxvt-unicode) =item Marc Alexander Lehmann L<< >>