--- rxvt-unicode/doc/rxvt.1.pod	2010/10/13 23:36:00	1.186
+++ 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<transparent>.
+Turn on/off pseudo-transparency by using the root pixmap as background; resource B<transparent>.
 
 B<-ip> is still accepted as an obsolete alias but will be removed in
 future versions.
 
-I<Please address all transparency related issues to Sasha Vasko at
-sasha@aftercode.net. Read the FAQ (man 7 @@RXVT_NAME@@)!>
-
 =item B<-fade> I<number>
 
 Fade the text by the given percentage when focus is lost. Small values
@@ -147,29 +144,19 @@
 
 =item B<-tint> I<colour>
 
-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<tintColor>. Example:
-
-   @@RXVT_NAME@@ -tr -tint blue -sh 40
+Tint the transparent background with the given colour;
+resource I<tintColor>.
 
 =item B<-sh> I<number>
 
-Darken (0 .. 100) or lighten (100 .. 200) the transparent
-background image in addition to (or instead of) tinting it;
-resource I<shading>.
+Darken (0 .. 99) or lighten (101 .. 200) the transparent background.
+A value of 100 means no shading; resource I<shading>.
 
 =item B<-blt> I<string>
 
 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<add>, B<alphablend>, B<allanon> - colour values averaging, B<colorize>,
 B<darken>, B<diff>, B<dissipate>, B<hue>, B<lighten>, B<overlay>,
 B<saturate>, B<screen>, B<sub>, B<tint>, B<value>. The default is
@@ -178,10 +165,10 @@
 =item B<-blr> I<HxV>
 
 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<afterimage> or I<xft>;
+on some backgrounds. Maximum radius value is 128;
 resource I<blurRadius>.
 
 =item B<-icon> I<file>
@@ -704,14 +691,11 @@
 
 =item B<transparent:> I<boolean>
 
-Turn on/off illusion of a transparent window background.
+Turn on/off pseudo-transparency by using the root pixmap as background.
 
 B<inheritPixmap> is still accepted as an obsolete alias but will be removed in
 future versions.
 
-I<Please address all transparency related issues to Sasha Vasko at
-sasha@aftercode.net. Read the FAQ (man 7 @@RXVT_NAME@@)!>
-
 =item B<fading:> I<number>
 
 Fade the text by the given percentage when focus is lost; option B<-fade>.
@@ -723,13 +707,16 @@
 
 =item B<tintColor:> I<colour>
 
-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<shading:> I<number>
 
-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<blendType:> I<string>
 
@@ -738,7 +725,7 @@
 =item B<blurRadius:> I<number>
 
 Apply gaussian blur with the specified radius to the transparent
-background image; option B<-blr>.
+background; option B<-blr>.
 
 =item B<iconFile:> I<file>
 
@@ -779,7 +766,7 @@
               whenever terminal window moves
 
 If used in conjunction with B<-tr> option, the specified pixmap will be
-blended over transparency image using alpha-blending. If I<afterimage>
+blended over the transparent background using alpha-blending. If I<afterimage>
 support has been compiled in it is possible to choose other blending
 types with B<-blt "type"> option.
 
@@ -1624,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<< <nodename >> >>>.
+Default F<<< $HOME/.rxvt-unicode-I<< <nodename> >> >>>.
 
 =item B<HOME>
 
@@ -1634,7 +1621,7 @@
 
 =item B<XAPPLRESDIR>
 
-Directory where various X resource files are being located.
+Directory where application-specific X resource files are located.
 
 =item B<XENVIRONMENT>
 
@@ -1710,7 +1697,7 @@
 
 =item Emanuele Giaquinta L<< <e.giaquinta@glauco.it> >>
 
-Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.
+pty/utmp code rewrite, image code improvements, many random hacks and bugfixes.
 
 =back