ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.1.pod
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.124 by root, Sat Jan 13 15:06:54 2007 UTC vs.
Revision 1.130 by sasha, Fri Jun 8 20:04:12 2007 UTC

140used to brighten or darken the image in addition to tinting it; resource 140used to brighten or darken the image in addition to tinting it; resource
141I<tintColor>. Example: 141I<tintColor>. Example:
142 142
143 @@RXVT_NAME@@ -tr -tint blue -sh 40 143 @@RXVT_NAME@@ -tr -tint blue -sh 40
144 144
145=item B<-sh> 145=item B<-sh> I<number>
146 146
147I<number> Darken (0 .. 100) or lighten (-1 .. -100) the transparent 147Darken (0 .. 100) or lighten (-1 .. -100) the transparent
148background image in addition to tinting it (i.e. B<-tint> must be 148background image in addition to (or instead of) tinting it;
149specified, too, e.g. C<-tint white>); resource I<shading>. 149resource I<shading>.
150
151=item B<-blt> I<string>
152
153Specify background blending type. If background pixmap is specified
154at the same time as transparency - such pixmap will be blended over
155transparency image, using method specified. Supported values are :
156B<add>, B<alphablend>, B<allanon> - color values averaging, B<colorize>,
157B<darken>, B<diff>, B<dissipate>, B<hue>, B<lighten>, B<overlay>,
158B<saturate>, B<screen>, B<sub>, B<tint>, B<value>. The default is
159alpha-blending; resource I<blendType>.
160
161=item B<-blr> I<number>
162
163Apply Gaussian Blur with the specified radius to the transparent
164background image; resource I<blurRadius>.
150 165
151=item B<-bg> I<colour> 166=item B<-bg> I<colour>
152 167
153Window background colour; resource B<background>. 168Window background colour; resource B<background>.
154 169
156 171
157Window foreground colour; resource B<foreground>. 172Window foreground colour; resource B<foreground>.
158 173
159=item B<-pixmap> I<file[;geom]> 174=item B<-pixmap> I<file[;geom]>
160 175
161Compile I<XPM>: Specify XPM file for the background and also optionally 176Compile I<afterimage>: Specify image file for the background and also
162specify its scaling with a geometry string. Note you may need to 177optionally specify its scaling with a geometry string. Note you may need to
163add quotes to avoid special shell interpretation of the C<;> in the 178add quotes to avoid special shell interpretation of the C<;> in the
164command-line; resource B<backgroundPixmap>. 179command-line; for more details see resource B<backgroundPixmap>.
165 180
166=item B<-cr> I<colour> 181=item B<-cr> I<colour>
167 182
168The cursor colour; resource B<cursorColor>. 183The cursor colour; resource B<cursorColor>.
169 184
386for more info. 401for more info.
387 402
388=item B<-tcw> 403=item B<-tcw>
389 404
390Change the meaning of triple-click selection with the left mouse 405Change the meaning of triple-click selection with the left mouse
406button. Only effective when the original (non-perl) selection code is
391button. Instead of selecting a full line it will extend the selection the 407in-use. Instead of selecting a full line it will extend the selection the
392end of the logical line only. resource B<tripleclickwords>. 408end of the logical line only. resource B<tripleclickwords>.
393 409
394=item B<-insecure> 410=item B<-insecure>
395 411
396Enable "insecure" mode, which currently enables most of the escape 412Enable "insecure" mode, which currently enables most of the escape
564Use the specified colour to display underlined characters when the 580Use the specified colour to display underlined characters when the
565foreground colour is the default. 581foreground colour is the default.
566 582
567=item B<colorRV:> I<colour> 583=item B<colorRV:> I<colour>
568 584
569Use the specified colour as the background for reverse video 585Use the specified colour as the background for reverse video characters
570characters. 586when OPTION_HC is disabled (--disable-frills).
571 587
572=item B<underlineColor:> I<colour> 588=item B<underlineColor:> I<colour>
573 589
574If set, use the specified colour as the colour for the underline 590If set, use the specified colour as the colour for the underline
575itself. If unset, use the foreground colour. 591itself. If unset, use the foreground colour.
623=item B<shading:> I<number> 639=item B<shading:> I<number>
624 640
625Darken (0 .. 100) or lighten (-1 .. -100) the transparent background image 641Darken (0 .. 100) or lighten (-1 .. -100) the transparent background image
626in addition to tinting it; option B<-sh>. 642in addition to tinting it; option B<-sh>.
627 643
644=item B<blendType:> I<string>
645
646Specify background blending type; option B<-blt>.
647
648=item B<blurRadius:> I<number>
649
650Apply Gaussian Blurr with the specified radius to the transparent
651background image; option B<-blr>.
652
628=item B<scrollColor:> I<colour> 653=item B<scrollColor:> I<colour>
629 654
630Use the specified colour for the scrollbar [default #B2B2B2]. 655Use the specified colour for the scrollbar [default #B2B2B2].
631 656
632=item B<troughColor:> I<colour> 657=item B<troughColor:> I<colour>
639The colour of the border around the text area and between the scrollbar 664The colour of the border around the text area and between the scrollbar
640and the text. 665and the text.
641 666
642=item B<backgroundPixmap:> I<file[;geom]> 667=item B<backgroundPixmap:> I<file[;geom]>
643 668
644Use the specified XPM file (note the `.xpm' extension is optional) for 669Use the specified image file for the background and also optionally
645the background and also optionally specify its scaling with a geometry 670specify its scaling with a geometry string B<WxH+X+Y>,
646string B<WxH+X+Y>, in which B<"W" / "H"> specify the 671in which B<"W" / "H"> specify the horizontal/vertical scale (percent),
647horizontal/vertical scale (percent) and B<"X" / "Y"> locate the image 672and B<"X" / "Y"> locate the image centre (percent).
648centre (percent). A scale of 0 displays the image with tiling. A scale 673A scale of 0 displays the image with tiling. A scale of 1 displays the
649of 1 displays the image without any scaling. A scale of 2 to 9 674image without any scaling. A scale of 2 to 9 specifies an integer
650specifies an integer number of images in that direction. No image will 675number of images in that direction. No image will be magnified beyond
651be magnified beyond 10 times its original size. The maximum permitted 67610 times its original size. The maximum permitted scale is 1000.
652scale is 1000. [default 0x0+50+50] 677Special string of B<"auto"> used as a geometry will cause image to be
678automatically scaled to match window size.
679If used in conjunction with B<-tr> option - specified pixmap will be
680blended over transparency image using either alpha-blending, or any
681other blending type, specified with B<-blt "type"> option.
682[default 0x0+50+50]
653 683
654=item B<path:> I<path> 684=item B<path:> I<path>
655 685
656Specify the colon-delimited search path for finding XPM files. 686Specify the colon-delimited search path for finding XPM files.
657 687
725option B<+is>) disables this behaviour, the high intensity colours are not 755option B<+is>) disables this behaviour, the high intensity colours are not
726reachable. 756reachable.
727 757
728=item B<selectstyle:> I<mode> 758=item B<selectstyle:> I<mode>
729 759
730Set mouse selection style to B<old> which is 2.20, B<oldword> which is 760Set mouse selection style to B<old> which is 2.20, B<oldword> which
731xterm style with 2.20 old word selection, or anything else which gives 761is xterm style with 2.20 old word selection, or anything else which
732xterm style selection. 762gives xterm style selection. Only effective when the original (non-perl)
763selection code is in use.
733 764
734=item B<scrollstyle:> I<mode> 765=item B<scrollstyle:> I<mode>
735 766
736Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is 767Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is
737the author's favourite. 768the author's favourite.
750 781
751=item B<mapAlert:> I<boolean> 782=item B<mapAlert:> I<boolean>
752 783
753B<True>: de-iconify (map) on receipt of a bell character. B<False>: no 784B<True>: de-iconify (map) on receipt of a bell character. B<False>: no
754de-iconify (map) on receipt of a bell character [default]. 785de-iconify (map) on receipt of a bell character [default].
786
787=item B<urgentOnBell:> I<boolean>
788
789B<True>: set the urgency hint for the wm on receipt of a bell character.
790B<False>: do not set the urgency hint [default].
755 791
756=item B<visualBell:> I<boolean> 792=item B<visualBell:> I<boolean>
757 793
758B<True>: use visual bell on receipt of a bell character; option B<-vb>. 794B<True>: use visual bell on receipt of a bell character; option B<-vb>.
759B<False>: no visual bell [default]; option B<+vb>. 795B<False>: no visual bell [default]; option B<+vb>.
916=item B<cutchars:> I<string> 952=item B<cutchars:> I<string>
917 953
918The characters used as delimiters for double-click word selection 954The characters used as delimiters for double-click word selection
919(whitespace delimiting is added automatically if resource is given). 955(whitespace delimiting is added automatically if resource is given).
920 956
921When the selection extension is in use (the default if compiled in, see 957When the perl selection extension is in use (the default if compiled
922the @@RXVT_NAME@@perl(3) manpage), a suitable regex using these characters 958in, see the @@RXVT_NAME@@perl(3) manpage), a suitable regex using these
923will be created (if the resource exists, otherwise, no regex will be 959characters will be created (if the resource exists, otherwise, no regex
924created). In this mode, characters outside ISO-8859-1 can be used. 960will be created). In this mode, characters outside ISO-8859-1 can be used.
925 961
926When the selection extension is not used, only ISO-8859-1 characters can 962When the selection extension is not used, only ISO-8859-1 characters can
927be used. If not specified, the built-in default is used: 963be used. If not specified, the built-in default is used:
928 964
929B<< BACKSLASH `"'&()*,;<=>?@[]{|} >> 965B<< BACKSLASH `"'&()*,;<=>?@[]{|} >>
988 1024
989Turn on/off secondary screen (default enabled). 1025Turn on/off secondary screen (default enabled).
990 1026
991=item B<secondaryScroll:> I<boolean> 1027=item B<secondaryScroll:> I<boolean>
992 1028
993Turn on/off secondary screen scroll (default enabled). If the this 1029Turn on/off secondary screen scroll (default enabled). If this
994option is enabled, scrolls on the secondary screen will change the 1030option is enabled, scrolls on the secondary screen will change the
995scrollback buffer and switching to/from the secondary screen will 1031scrollback buffer and switching to/from the secondary screen will
996instead scroll the screen up. 1032instead scroll the screen up.
997 1033
998=item B<hold>: I<boolean> 1034=item B<hold>: I<boolean>
1193application. Instead, pressing Button1 and Button3 sends B<ESC [ 6 ~> 1229application. Instead, pressing Button1 and Button3 sends B<ESC [ 6 ~>
1194(Next) and B<ESC [ 5 ~> (Prior), respectively. Similarly, clicking on the 1230(Next) and B<ESC [ 5 ~> (Prior), respectively. Similarly, clicking on the
1195up and down arrows sends B<ESC [ A> (Up) and B<ESC [ B> (Down), 1231up and down arrows sends B<ESC [ A> (Up) and B<ESC [ B> (Down),
1196respectively. 1232respectively.
1197 1233
1198=head1 TEXT SELECTION AND INSERTION 1234=head1 THE SELECTION: SELECTING AND PASTING TEXT
1199 1235
1200The behaviour of text selection and insertion mechanism is similar to 1236The behaviour of text selection and insertion/pasting mechanism is similar
1201I<xterm>(1). 1237to I<xterm>(1).
1202 1238
1203=over 4 1239=over 4
1204 1240
1205=item B<Selection>: 1241=item B<Selecting>:
1206 1242
1207Left click at the beginning of the region, drag to the end of the region 1243Left click at the beginning of the region, drag to the end of the region
1208and release; Right click to extend the marked region; Left double-click 1244and release; Right click to extend the marked region; Left double-click
1209to select a word; Left triple-click to select the entire logical line 1245to select a word; Left triple-click to select the entire logical line
1210(which can span multiple screen lines), unless modified by resource 1246(which can span multiple screen lines), unless modified by resource
1214(Compile: I<frills>) will create a rectangular selection instead of a 1250(Compile: I<frills>) will create a rectangular selection instead of a
1215normal one. In this mode, every selected row becomes its own line in the 1251normal one. In this mode, every selected row becomes its own line in the
1216selection, and trailing whitespace is visually underlined and removed from 1252selection, and trailing whitespace is visually underlined and removed from
1217the selection. 1253the selection.
1218 1254
1219=item B<Insertion>: 1255=item B<Pasting>:
1220 1256
1221Pressing and releasing the Middle mouse button in an B<@@RXVT_NAME@@> 1257Pressing and releasing the Middle mouse button in an B<@@RXVT_NAME@@>
1222window causes the value of the PRIMARY selection (or CLIPBOARD with the 1258window causes the value of the PRIMARY selection (or CLIPBOARD with the
1223Meta modifier) to be inserted as if it had been typed on the keyboard. 1259B<Meta> modifier) to be inserted as if it had been typed on the keyboard.
1224 1260
1225Pressing B<Shift-Insert> causes the value of the PRIMARY selection to be 1261Pressing B<Shift-Insert> causes the value of the PRIMARY selection to be
1226inserted too. 1262inserted too.
1227 1263
1228=back 1264=back

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines