--- rxvt-unicode/doc/rxvt.1.pod 2015/06/16 11:58:26 1.244 +++ rxvt-unicode/doc/rxvt.1.pod 2017/10/13 17:13:58 1.248 @@ -873,8 +873,7 @@ =item B I -Save I lines in the scrollback buffer [default 64]. This -resource is limited on most machines to 65535; option B<-sl>. +Save I lines in the scrollback buffer [default 1000]; option B<-sl>. =item B I @@ -1082,10 +1081,25 @@ (modifiers-)key -Where I can be any combination of B, B, -B, B, B, B, B, B, B, -B, B, B, and the abbreviated B, B, B, B, -B, B, B, B, B<1>, B<2>, B<3>, B<4>, B<5>. +Where I can be any combination of the following full or +abbreviated modifier names: + +=begin table + + B B + B B + B B + B B + B B + B B B + B B + B B<1> + B B<2> + B B<3> + B B<4> + B B<5> + +=end table The B, B and B modifiers are usually aliased to whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 Shift/AltGr @@ -1326,120 +1340,6 @@ =back -=head1 BACKGROUND IMAGE OPTIONS AND RESOURCES - -=over 4 - -=item B<-pixmap> I - -=item B I - -Compile I: Use the specified image file as the window's -background and also optionally specify a colon separated list of -operations to modify it. Note that you may need to quote the C<;> -character when using the command line option, as C<;> is usually a -metacharacter in shells. Supported operations are: - -=over 4 - -=item B - -sets scale and position. B<"W" / "H"> specify the horizontal/vertical -scale (percent), and B<"X" / "Y"> locate the image centre (percent). A -scale of 0 disables scaling. - -=item B - -enables tiling - -=item B - -maintain the image aspect ratio when scaling - -=item B - -use the position of the terminal window relative to the root window as -the image offset, simulating a root window background - -=back - -The default scale and position setting is C<100x100+50+50>. -Alternatively, a predefined set of templates can be used to achieve -the most common setups: - -=over 4 - -=item B - -the image is tiled with no scaling. Equivalent to 0x0+0+0:op=tile - -=item B - -the image is scaled to fill the whole window maintaining the aspect -ratio and centered. Equivalent to 100x100+50+50:op=keep-aspect - -=item B - -the image is scaled to fill the whole window. Equivalent to 100x100 - -=item B - -the image is centered with no scaling. Equivalent to 0x0+50+50 - -=item B - -the image is tiled with no scaling and using 'root' positioning. -Equivalent to 0x0:op=tile:op=root-align - -=back - -If multiple templates are specified the last one wins. Note that a -template overrides all the scale, position and operations settings. - -If used in conjunction with pseudo-transparency, the specified pixmap -will be blended over the transparent background using alpha-blending. - -=item B<-tr>|B<+tr> - -=item B I - -Turn on/off pseudo-transparency by using the root pixmap as background. - -B<-ip> (B) is still accepted as an obsolete alias but -will be removed in future versions. - -=item B<-tint> I - -=item B I - -Tint the transparent background with the given colour. Note that a -black tint yields a completely black image while a white tint yields -the image unchanged. - -=item B<-sh> I - -=item B I - -Darken (0 .. 99) or lighten (101 .. 200) the transparent background. -A value of 100 means no shading. - -=item B<-blr> I - -=item B I - -Apply gaussian blur with the specified radius to the transparent -background. If a single number is specified, the vertical and -horizontal radii are considered to be the same. Setting one of the -radii to 1 and the other to a large number creates interesting effects -on some backgrounds. The maximum radius value is 128. An horizontal or -vertical radius of 0 disables blurring. - -=item B I - -Specify the colon-delimited search path for finding background image files. - -=back - =head1 THE SCROLLBAR Lines of text that scroll off the top of the B<@@RXVT_NAME@@> window @@ -1599,6 +1499,15 @@ 240 in 256 colour mode) colours arranged in an 4x4x4 (or 6x6x6) colour RGB cube plus a 8 (24) colour greyscale ramp. +B<@@RXVT_NAME@@> supports direct 24-bit fg/bg RGB colour escapes +C< ESC [ 38 ; 2 ; R ; G ; Bm > / C< ESC [ 48 ; 2; R ; G ; Bm >. However the +number of 24-bit colours that can be used is limited: an internal 7x7x5 (256 +colour mode) or 6x6x4 (88 colour mode) colour cube is used to index into the +24-bit colour space. When indexing collisions happen, the nearest old colour in +the cube will be adapted to the new 24-bit RGB colour. That means one cannot +use many similar 24-bit colours. It's typically not a problem in common +scenarios. + Here is a list of the ANSI colours with their names. =begin table