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.121 by root, Sun Aug 20 02:47:26 2006 UTC vs.
Revision 1.129 by root, Mon May 28 20:34:56 2007 UTC

144 144
145=item B<-sh> 145=item B<-sh>
146 146
147I<number> Darken (0 .. 100) or lighten (-1 .. -100) the transparent 147I<number> Darken (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 tinting it (i.e. B<-tint> must be
149specified, too, e.g. C<-tint white>). 149specified, too, e.g. C<-tint white>); resource I<shading>.
150 150
151=item B<-bg> I<colour> 151=item B<-bg> I<colour>
152 152
153Window background colour; resource B<background>. 153Window background colour; resource B<background>.
154 154
386for more info. 386for more info.
387 387
388=item B<-tcw> 388=item B<-tcw>
389 389
390Change the meaning of triple-click selection with the left mouse 390Change the meaning of triple-click selection with the left mouse
391button. Only effective when the original (non-perl) selection code is
391button. Instead of selecting a full line it will extend the selection the 392in-use. Instead of selecting a full line it will extend the selection the
392end of the logical line only. resource B<tripleclickwords>. 393end of the logical line only. resource B<tripleclickwords>.
393 394
394=item B<-insecure> 395=item B<-insecure>
395 396
396Enable "insecure" mode, which currently enables most of the escape 397Enable "insecure" mode, which currently enables most of the escape
564Use the specified colour to display underlined characters when the 565Use the specified colour to display underlined characters when the
565foreground colour is the default. 566foreground colour is the default.
566 567
567=item B<colorRV:> I<colour> 568=item B<colorRV:> I<colour>
568 569
569Use the specified colour as the background for reverse video 570Use the specified colour as the background for reverse video characters
570characters. 571when OPTION_HC is disabled (--disable-frills).
571 572
572=item B<underlineColor:> I<colour> 573=item B<underlineColor:> I<colour>
573 574
574If set, use the specified colour as the colour for the underline 575If set, use the specified colour as the colour for the underline
575itself. If unset, use the foreground colour. 576itself. If unset, use the foreground colour.
620Tint the transparent background pixmap with the given colour; option 621Tint the transparent background pixmap with the given colour; option
621B<-tint>. 622B<-tint>.
622 623
623=item B<shading:> I<number> 624=item B<shading:> I<number>
624 625
625Darken (0 .. 100) or lighten (-1 .. -100) the transparent background 626Darken (0 .. 100) or lighten (-1 .. -100) the transparent background image
626image in addition to tinting it. 627in addition to tinting it; option B<-sh>.
627 628
628=item B<scrollColor:> I<colour> 629=item B<scrollColor:> I<colour>
629 630
630Use the specified colour for the scrollbar [default #B2B2B2]. 631Use the specified colour for the scrollbar [default #B2B2B2].
631 632
725option B<+is>) disables this behaviour, the high intensity colours are not 726option B<+is>) disables this behaviour, the high intensity colours are not
726reachable. 727reachable.
727 728
728=item B<selectstyle:> I<mode> 729=item B<selectstyle:> I<mode>
729 730
730Set mouse selection style to B<old> which is 2.20, B<oldword> which is 731Set 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 732is xterm style with 2.20 old word selection, or anything else which
732xterm style selection. 733gives xterm style selection. Only effective when the original (non-perl)
734selection code is in use.
733 735
734=item B<scrollstyle:> I<mode> 736=item B<scrollstyle:> I<mode>
735 737
736Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is 738Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is
737the author's favourite. 739the author's favourite.
750 752
751=item B<mapAlert:> I<boolean> 753=item B<mapAlert:> I<boolean>
752 754
753B<True>: de-iconify (map) on receipt of a bell character. B<False>: no 755B<True>: de-iconify (map) on receipt of a bell character. B<False>: no
754de-iconify (map) on receipt of a bell character [default]. 756de-iconify (map) on receipt of a bell character [default].
757
758=item B<urgentOnBell:> I<boolean>
759
760B<True>: set the urgency hint for the wm on receipt of a bell character.
761B<False>: do not set the urgency hint [default].
755 762
756=item B<visualBell:> I<boolean> 763=item B<visualBell:> I<boolean>
757 764
758B<True>: use visual bell on receipt of a bell character; option B<-vb>. 765B<True>: use visual bell on receipt of a bell character; option B<-vb>.
759B<False>: no visual bell [default]; option B<+vb>. 766B<False>: no visual bell [default]; option B<+vb>.
916=item B<cutchars:> I<string> 923=item B<cutchars:> I<string>
917 924
918The characters used as delimiters for double-click word selection 925The characters used as delimiters for double-click word selection
919(whitespace delimiting is added automatically if resource is given). 926(whitespace delimiting is added automatically if resource is given).
920 927
921When the selection extension is in use (the default if compiled in, see 928When the perl selection extension is in use (the default if compiled
922the @@RXVT_NAME@@perl(3) manpage), a suitable regex using these characters 929in, see the @@RXVT_NAME@@perl(3) manpage), a suitable regex using these
923will be created (if the resource exists, otherwise, no regex will be 930characters will be created (if the resource exists, otherwise, no regex
924created). In this mode, characters outside ISO-8859-1 can be used. 931will be created). In this mode, characters outside ISO-8859-1 can be used.
925 932
926When the selection extension is not used, only ISO-8859-1 characters can 933When the selection extension is not used, only ISO-8859-1 characters can
927be used. If not specified, the built-in default is used: 934be used. If not specified, the built-in default is used:
928 935
929B<< BACKSLASH `"'&()*,;<=>?@[]{|} >> 936B<< BACKSLASH `"'&()*,;<=>?@[]{|} >>
988 995
989Turn on/off secondary screen (default enabled). 996Turn on/off secondary screen (default enabled).
990 997
991=item B<secondaryScroll:> I<boolean> 998=item B<secondaryScroll:> I<boolean>
992 999
993Turn on/off secondary screen scroll (default enabled). If the this 1000Turn on/off secondary screen scroll (default enabled). If this
994option is enabled, scrolls on the secondary screen will change the 1001option is enabled, scrolls on the secondary screen will change the
995scrollback buffer and switching to/from the secondary screen will 1002scrollback buffer and switching to/from the secondary screen will
996instead scroll the screen up. 1003instead scroll the screen up.
997 1004
998=item B<hold>: I<boolean> 1005=item B<hold>: I<boolean>
1155(default: C<M-s>). 1162(default: C<M-s>).
1156 1163
1157=item B<urlLauncher>: I<string> 1164=item B<urlLauncher>: I<string>
1158 1165
1159Specifies the program to be started with a URL argument. Used by the 1166Specifies the program to be started with a URL argument. Used by the
1160C<selection-popup> and C<mark-urls> perl extensions. 1167C<selection-popup> and C<matcher> perl extensions.
1161 1168
1162=item B<transient-for>: I<windowid> 1169=item B<transient-for>: I<windowid>
1163 1170
1164Compile I<frills>: Sets the WM_TRANSIENT_FOR property to the given window id. 1171Compile I<frills>: Sets the WM_TRANSIENT_FOR property to the given window id.
1165 1172
1193application. Instead, pressing Button1 and Button3 sends B<ESC [ 6 ~> 1200application. Instead, pressing Button1 and Button3 sends B<ESC [ 6 ~>
1194(Next) and B<ESC [ 5 ~> (Prior), respectively. Similarly, clicking on the 1201(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), 1202up and down arrows sends B<ESC [ A> (Up) and B<ESC [ B> (Down),
1196respectively. 1203respectively.
1197 1204
1198=head1 TEXT SELECTION AND INSERTION 1205=head1 THE SELECTION: SELECTING AND PASTING TEXT
1199 1206
1200The behaviour of text selection and insertion mechanism is similar to 1207The behaviour of text selection and insertion/pasting mechanism is similar
1201I<xterm>(1). 1208to I<xterm>(1).
1202 1209
1203=over 4 1210=over 4
1204 1211
1205=item B<Selection>: 1212=item B<Selecting>:
1206 1213
1207Left click at the beginning of the region, drag to the end of the region 1214Left 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 1215and release; Right click to extend the marked region; Left double-click
1209to select a word; Left triple-click to select the entire logical line 1216to select a word; Left triple-click to select the entire logical line
1210(which can span multiple screen lines), unless modified by resource 1217(which can span multiple screen lines), unless modified by resource
1214(Compile: I<frills>) will create a rectangular selection instead of a 1221(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 1222normal one. In this mode, every selected row becomes its own line in the
1216selection, and trailing whitespace is visually underlined and removed from 1223selection, and trailing whitespace is visually underlined and removed from
1217the selection. 1224the selection.
1218 1225
1219=item B<Insertion>: 1226=item B<Pasting>:
1220 1227
1221Pressing and releasing the Middle mouse button in an B<@@RXVT_NAME@@> 1228Pressing and releasing the Middle mouse button in an B<@@RXVT_NAME@@>
1222window causes the value of the PRIMARY selection (or CLIPBOARD with the 1229window 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. 1230B<Meta> modifier) to be inserted as if it had been typed on the keyboard.
1224 1231
1225Pressing B<Shift-Insert> causes the value of the PRIMARY selection to be 1232Pressing B<Shift-Insert> causes the value of the PRIMARY selection to be
1226inserted too. 1233inserted too.
1227 1234
1228=back 1235=back
1378If Xft support has been compiled in and as long as Xft/Xrender/X don't get 1385If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1379their act together, rxvt-unicode will support C<rgba:rrrr/gggg/bbbb/aaaa> 1386their act together, rxvt-unicode will support C<rgba:rrrr/gggg/bbbb/aaaa>
1380(recommended, but B<MUST> have 4 digits/component) colour specifications, 1387(recommended, but B<MUST> have 4 digits/component) colour specifications,
1381in addition to the ones provided by X, where the additional A component 1388in addition to the ones provided by X, where the additional A component
1382specifies opacity (alpha) values. The minimum value of C<0> is completely 1389specifies opacity (alpha) values. The minimum value of C<0> is completely
1383transparent). You can also prefix any color with C<[a]>, where C<a> is on 1390transparent). You can also prefix any color with C<[percent]>, where
1384to four hex digits specifiying the opacity value. 1391C<percent> is a decimal percentage (0-100) that specifies the opacity of
1392the color, where C<0> is completely transparent and C<100> is completelxy
1393opaque.
1385 1394
1386You probably need to specify B<"-depth 32">, too, and have the luck that 1395You probably need to specify B<"-depth 32">, too, and have the luck that
1387your X-server uses ARGB pixel layout, as X is far from just supporting 1396your X-server uses ARGB pixel layout, as X is far from just supporting
1388ARGB visuals out of the box, and rxvt-unicode just fudges around. 1397ARGB visuals out of the box, and rxvt-unicode just fudges around.
1389 1398
1390For example, the following selects an almost completely transparent red 1399For example, the following selects an almost completely transparent red
1391background, and an almost opaque pink foreground: 1400background, and an almost opaque pink foreground:
1392 1401
1393 @@RXVT_NAME@@ -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink" 1402 @@RXVT_NAME@@ -depth 32 -bg rgba:0000/0000/0000/aaaa -fg "[80]pink"
1394 1403
1395I<Please note that transparency of any kind if completely unsupported by 1404I<Please note that transparency of any kind if completely unsupported by
1396the author. Don't bug him with installation questions!> 1405the author. Don't bug him with installation questions!>
1397 1406
1398=head1 ENVIRONMENT 1407=head1 ENVIRONMENT

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines