--- rxvt-unicode/doc/rxvt.1.pod 2010/11/04 12:13:20 1.188 +++ rxvt-unicode/doc/rxvt.1.pod 2011/08/11 08:37:17 1.202 @@ -149,8 +149,8 @@ =item B<-sh> I -Darken (0 .. 100) or lighten (100 .. 200) the transparent background; -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 @@ -560,10 +560,10 @@ starts. @@RXVT_NAME@@ will consult the following files/resources in order, with later settings overwriting earlier ones: - 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 + 1. app-defaults file in $XAPPLRESDIR + 2. $HOME/.Xdefaults + 3. RESOURCE_MANAGER property on root-window of screen 0 + 4. SCREEN_RESOURCES property on root-window of the current screen 5. $XENVIRONMENT file OR $HOME/.Xdefaults- 6. resources specified via -xrm on the commandline @@ -707,13 +707,16 @@ =item B I -Tint the transparent background 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 (100 .. 200) the transparent background; -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 @@ -748,19 +751,36 @@ optionally specify its scaling with a geometry string B, (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. +centre (percent). A scale of 0 disables scaling. The maximum permitted scale is 1000. Additional operations can be specified after colon B<:op1:op2...>. Supported operations are: - tile force background image to be tiled and not scaled. Equivalent to 0x0 - propscale will scale image keeping proportions - auto will scale image to match window size. Equivalent to 100x100 - hscale will scale image horizontally to the window size - vscale will scale image vertically to the window size - scale will scale image to match window size - root will tile image as if it was a root window background, auto-adjusting - whenever terminal window moves + op=tile enables tiling + op=pscale enables proportional scaling + op=root use the position of the terminal window relative to the root + window as the image offset, simulating a root window background + +Alternatively, a predefined set of templates can be used to achieve +the most common setups: + + style=tiled the image is tiled with no scaling + style=aspect-stretched the image is scaled to fill the whole window maintaining + the aspect ratio and centered + style=stretched the image is scaled to fill the whole window + style=centered the image is centered with no scaling + style=root-tiled the image is tiled with no scaling and using 'op=root' positioning + +If multiple templates are specified the last one wins. Note that a +template overrides all the scale, position and operations settings. +Indeed, the templates can be specified in terms of low level settings +as follows: + + style=tiled 0x0+0+0:op=tile + style=aspect-stretched +50+50:op=pscale + style=stretched 100x100 + style=centered 0x0+50+50 + style=root-tiled 0x0:op=tile:op=root If used in conjunction with B<-tr> option, the specified pixmap will be blended over the transparent background using alpha-blending. If I @@ -902,6 +922,10 @@ Set scrollbar style to B, B, B or B. B is the author's favourite. +=item B I + +Set the scrollbar width in pixels. + =item B I B: enable the scrollbar [default]; option B<-sb>. B: @@ -930,9 +954,10 @@ =item B I -B: scroll with scrollback buffer when tty receives new lines (and -B is False); option B<-sw>. B: do not scroll -with scrollback buffer when tty receives new lines; option B<+sw>. +B: scroll with scrollback buffer when tty receives new lines (i.e. +try to show the same lines) and B is False; option +B<-sw>. B: do not scroll with scrollback buffer when tty receives +new lines; option B<+sw>. =item B I @@ -1162,13 +1187,13 @@ Its usage can be demonstrated by an example: - URxvt.keysym.M-C-0x61: list|\033 + URxvt.keysym.M-C-0x61: list|\033<|abc|> The above line is equivalent to the following three lines: - URxvt.keysym.Meta-Control-0x61: \033 - URxvt.keysym.Meta-Control-0x62: \033 - URxvt.keysym.Meta-Control-0x63: \033 + URxvt.keysym.Meta-Control-0x61: \033 + URxvt.keysym.Meta-Control-0x62: \033 + URxvt.keysym.Meta-Control-0x63: \033 If I takes the form of C, the specified B is interpreted and executed as @@RXVT_NAME@@'s control sequence. For @@ -1608,7 +1633,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 @@ -1618,7 +1643,7 @@ =item B -Directory where various X resource files are being located. +Directory where application-specific X resource files are located. =item B @@ -1694,7 +1719,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