amended docs for -sh parameter to have range between 0..200

diff --git a/doc/rxvt.1.man.in b/doc/rxvt.1.man.in
index 476c4202143f46fe9d9b105a9989bcc7f3b4314e..c521db155b06132c23775b960fc75ddfaae548ab 100644 (file)
--- a/doc/rxvt.1.man.in
+++ b/doc/rxvt.1.man.in
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.35
+.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
 .\"
 .\" Standard preamble:
 .\" ========================================================================
@@ -129,7 +129,7 @@
 .\" ========================================================================
 .\"
 .IX Title "@@RXVT_NAME@@ 1"
-.TH @@RXVT_NAME@@ 1 "2007-10-27" "8.4" "RXVT-UNICODE"
+.TH @@RXVT_NAME@@ 1 "2007-10-29" "8.3" "RXVT-UNICODE"
 .SH "NAME"
 rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system)
 .SH "SYNOPSIS"
@@ -260,15 +260,16 @@ non-tiled backgrounds, currently. See also the \fB\-sh\fR 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 essentialy mean no tinting; resource
 \&\fItintColor\fR. Example:
 .Sp
 .Vb 1
-\&   @@RXVT_NAME@@ -tr -tint blue -sh 40
+\&   @@RXVT_NAME@@ \-tr \-tint blue \-sh 40
 .Ve
 .IP "\fB\-sh\fR \fInumber\fR" 4
 .IX Item "-sh number"
-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 \fIshading\fR.
 .IP "\fB\-blt\fR \fIstring\fR" 4
@@ -326,8 +327,8 @@ with \f(CW\*(C`x:\*(C'\fR. To specify an XFT\-font, you need to prefix it with \
 e.g.:
 .Sp
 .Vb 2
-\&   @@RXVT_NAME@@ -fn "xft:Bitstream Vera Sans Mono:pixelsize=15"
-\&   @@RXVT_NAME@@ -fn "9x15bold,xft:Bitstream Vera Sans Mono"
+\&   @@RXVT_NAME@@ \-fn "xft:Bitstream Vera Sans Mono:pixelsize=15"
+\&   @@RXVT_NAME@@ \-fn "9x15bold,xft:Bitstream Vera Sans Mono"
 .Ve
 .Sp
 See also the question \*(L"How does rxvt-unicode choose fonts?\*(R" in the \s-1FAQ\s0
@@ -456,7 +457,7 @@ Please note that you must specify a program with arguments. If you want to
 run shell commands, you have to specify the shell, like this:
 .Sp
 .Vb 1
-\&  @@RXVT_NAME@@ -e sh -c "shell commands"
+\&  @@RXVT_NAME@@ \-e sh \-c "shell commands"
 .Ve
 .IP "\fB\-title\fR \fItext\fR" 4
 .IX Item "-title text"
@@ -544,9 +545,9 @@ used (a longer example is in \fIdoc/embed\fR):
 .Sp
 .Vb 5
 \&   my $rxvt = new Gtk2::Socket;
-\&   $rxvt->signal_connect_after (realize => sub {
-\&      my $xid = $_[0]->window->get_xid;
-\&      system "@@RXVT_NAME@@ -embed $xid &";
+\&   $rxvt\->signal_connect_after (realize => sub {
+\&      my $xid = $_[0]\->window\->get_xid;
+\&      system "@@RXVT_NAME@@ \-embed $xid &";
 \&   });
 .Ve
 .IP "\fB\-pty\-fd\fR \fIfile descriptor\fR" 4
@@ -573,14 +574,14 @@ longer example is in \fIdoc/pty\-fd\fR):
 .Sp
 .Vb 4
 \&   my $pty = new IO::Pty;
-\&   fcntl $pty, F_SETFD, 0; # clear close-on-exec
-\&   system "@@RXVT_NAME@@ -pty-fd " . (fileno $pty) . "&";
+\&   fcntl $pty, F_SETFD, 0; # clear close\-on\-exec
+\&   system "@@RXVT_NAME@@ \-pty\-fd " . (fileno $pty) . "&";
 \&   close $pty;
 .Ve
 .Sp
 .Vb 3
 \&   # now communicate with rxvt
-\&   my $slave = $pty->slave;
+\&   my $slave = $pty\->slave;
 \&   while (<$slave>) { print $slave "got <$_>\en" }
 .Ve
 .IP "\fB\-pe\fR \fIstring\fR" 4
@@ -598,11 +599,11 @@ starts. @@RXVT_NAME@@ will consult the following files/resources in order,
 with later settings overwriting earlier ones:
 .PP
 .Vb 5
-\&  1. system-wide app-defaults file, either locale-dependent OR global
-\&  2. app-defaults file in $XAPPLRESDIR
-\&  3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults
+\&  1. system\-wide app\-defaults file, either locale\-dependent OR global
+\&  2. app\-defaults file in $XAPPLRESDIR
+\&  3. RESOURCE_MANAGER property on root\-window OR $HOME/.Xdefaults
 \&  4. SCREEN_RESOURCES for the current screen
-\&  5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename>
+\&  5. $XENVIRONMENT file OR $HOME/.Xdefaults\-<nodename>
 .Ve
 .PP
 Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two class
@@ -780,8 +781,8 @@ For example, this font resource
 .Sp
 .Vb 5
 \&   URxvt.font: 9x15bold,\e
-\&               -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e
-\&               -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e
+\&               \-misc\-fixed\-bold\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1,\e
+\&               \-misc\-fixed\-medium\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1, \e
 \&               [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \e
 \&               xft:Code2000:antialias=false
 .Ve
@@ -884,7 +885,7 @@ The string will be interpreted as if typed into the shell as\-is.
 Example:
 .Sp
 .Vb 1
-\&   URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
+\&   URxvt.print\-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
 .Ve
 .Sp
 This creates a new file in your home directory with the screen contents
@@ -1102,15 +1103,15 @@ should be a character not used by the strings.
 Its usage can be demonstrated by an example:
 .Sp
 .Vb 1
-\&  URxvt.keysym.M-C-0x61:    list|\e033<M-C-|abc|>
+\&  URxvt.keysym.M\-C\-0x61:    list|\e033<M\-C\-|abc|>
 .Ve
 .Sp
 The above line is equivalent to the following three lines:
 .Sp
 .Vb 3
-\&  URxvt.keysym.Meta-Control-0x61:    \e033<M-C-a>
-\&  URxvt.keysym.Meta-Control-0x62:    \e033<M-C-b>
-\&  URxvt.keysym.Meta-Control-0x63:    \e033<M-C-c>
+\&  URxvt.keysym.Meta\-Control\-0x61:    \e033<M\-C\-a>
+\&  URxvt.keysym.Meta\-Control\-0x62:    \e033<M\-C\-b>
+\&  URxvt.keysym.Meta\-Control\-0x63:    \e033<M\-C\-c>
 .Ve
 .Sp
 If \fIstring\fR takes the form of \f(CW\*(C`command:STRING\*(C'\fR, the specified \fB\s-1STRING\s0\fR
@@ -1119,7 +1120,7 @@ example the following means "change the current locale to \f(CW\*(C`zh_CN.GBK\*(
 when Control-Meta-c is being pressed":
 .Sp
 .Vb 1
-\&  URxvt.keysym.M-C-c: command:\e033]701;zh_CN.GBK\e007
+\&  URxvt.keysym.M\-C\-c: command:\e033]701;zh_CN.GBK\e007
 .Ve
 .Sp
 If \fIstring\fR takes the form \f(CW\*(C`perl:STRING\*(C'\fR, then the specified \fB\s-1STRING\s0\fR
@@ -1128,7 +1129,7 @@ manpage. For example, the \fIselection\fR extension (activated via
 \&\f(CW\*(C`@@RXVT_NAME@@ \-pe selection\*(C'\fR) listens for \f(CW\*(C`selection:rot13\*(C'\fR events:
 .Sp
 .Vb 1
-\&  URxvt.keysym.M-C-c: perl:selection:rot13
+\&  URxvt.keysym.M\-C\-c: perl:selection:rot13
 .Ve
 .Sp
 Due the the large number of modifier combinations, a defined key mapping
@@ -1145,7 +1146,7 @@ user-defined keymap using the \f(CW\*(C`builtin:\*(C'\fR replacement:
 .Sp
 .Vb 2
 \&  URxvt.keysym.Insert: <my insert key sequence>
-\&  URxvt.keysym.S-Insert: builtin:
+\&  URxvt.keysym.S\-Insert: builtin:
 .Ve
 .Sp
 The first line defines a mapping for \f(CW\*(C`Insert\*(C'\fR and \fIany\fR combination
@@ -1157,16 +1158,16 @@ the fonts \f(CW\*(C`suxuseuro\*(C'\fR and \f(CW\*(C`9x15bold\*(C'\fR, so you can
 font-switching at runtime:
 .Sp
 .Vb 2
-\&  URxvt.keysym.M-C-1: command:\e033]50;suxuseuro\e007
-\&  URxvt.keysym.M-C-2: command:\e033]50;9x15bold\e007
+\&  URxvt.keysym.M\-C\-1: command:\e033]50;suxuseuro\e007
+\&  URxvt.keysym.M\-C\-2: command:\e033]50;9x15bold\e007
 .Ve
 .Sp
 Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more
 info):
 .Sp
 .Vb 2
-\&  URxvt.keysym.M-C-3: command:\e033[8;25;80t
-\&  URxvt.keysym.M-C-4: command:\e033[8;48;110t
+\&  URxvt.keysym.M\-C\-3: command:\e033[8;25;80t
+\&  URxvt.keysym.M\-C\-4: command:\e033[8;48;110t
 .Ve
 .IP "\fBperl-ext-common\fR: \fIstring\fR" 4
 .IX Item "perl-ext-common: string"
@@ -1298,8 +1299,8 @@ You can, however, switch fonts at runtime using escape sequences, e.g.:
 You can use keyboard shortcuts, too:
 .PP
 .Vb 2
-\&   URxvt.keysym.M-C-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007
-\&   URxvt.keysym.M-C-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007
+\&   URxvt.keysym.M\-C\-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007
+\&   URxvt.keysym.M\-C\-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007
 .Ve
 .PP
 rxvt-unicode will automatically re-apply these fonts to the output so far.
@@ -1436,7 +1437,7 @@ For example, the following selects an almost completely transparent red
 background, and an almost opaque pink foreground:
 .PP
 .Vb 1
-\&   @@RXVT_NAME@@ -depth 32 -bg rgba:0000/0000/0000/aaaa -fg "[80]pink"
+\&   @@RXVT_NAME@@ \-depth 32 \-bg rgba:0000/0000/0000/aaaa \-fg "[80]pink"
 .Ve
 .PP
 \&\fIPlease note that transparency of any kind if completely unsupported by

diff --git a/doc/rxvt.1.pod b/doc/rxvt.1.pod
index d324efcdf112d6618e6625654dd84b59364aaf2e..69bf37af6b841f13f8ff34a7fe0b686d9110cdce 100644 (file)
--- a/doc/rxvt.1.pod
+++ b/doc/rxvt.1.pod
@@ -147,14 +147,15 @@ 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 essentialy mean no tinting; resource
 I<tintColor>. Example:
 
    @@RXVT_NAME@@ -tr -tint blue -sh 40
 
 =item B<-sh> I<number>
 
-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<shading>.
 

diff --git a/doc/rxvt.7.pod b/doc/rxvt.7.pod
index 6a831ea320bf39ce75617111810f53f1cf868bd5..34bad9d5133ae5f8af5413b7ced8e06302164d0c 100644 (file)
--- a/doc/rxvt.7.pod
+++ b/doc/rxvt.7.pod
@@ -218,10 +218,10 @@ get it working consider it a rite of passage: ... and you failed.
 Here are four ways to get transparency. B<Do> read the manpage and option
 descriptions for the programs mentioned and rxvt-unicode. Really, do it!
 
-1. Use inheritPixmap:
+1. Use transparent mode:
 
    Esetroot wallpaper.jpg
-   @@URXVT_NAME@@ -ip -tint red -sh 40
+   @@URXVT_NAME@@ -tr -tint red -sh 40
 
 That works. If you think it doesn't, you lack transparency and tinting
 support, or you are unable to read.
@@ -2367,8 +2367,7 @@ lowered if libAfterImage is configured without support for SVG.
 
 =item --enable-transparency (default: on)
 
-Add support for inheriting parent backgrounds thus giving a fake
-transparency to the term.
+Add support for backgrounds, creating illusion of transparency in the term.
 
 =item --enable-fading (default: on)