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.76 by root, Sat Dec 31 16:06:48 2005 UTC vs.
Revision 1.107 by root, Sun Jan 29 20:51:27 2006 UTC

… …
93 93
94Attempt to open a window on the named X display (B<-d> still 94Attempt to open a window on the named X display (B<-d> still
95respected). In the absence of this option, the display specified by the 95respected). In the absence of this option, the display specified by the
96B<DISPLAY> environment variable is used. 96B<DISPLAY> environment variable is used.
97 97
98=item B<-depth> I<bitdepth>
99
100Compile I<frills>: Attempt to find a visual with the given bit depth;
101resource B<depth>.
102
98=item B<-geometry> I<geom> 103=item B<-geometry> I<geom>
99 104
100Window geometry (B<-g> still respected); resource B<geometry>. 105Window geometry (B<-g> still respected); resource B<geometry>.
101 106
102=item B<-rv>|B<+rv> 107=item B<-rv>|B<+rv>
… …
172resource B<borderColor>. 177resource B<borderColor>.
173 178
174=item B<-fn> I<fontlist> 179=item B<-fn> I<fontlist>
175 180
176Select the fonts to be used. This is a comma separated list of font names 181Select the fonts to be used. This is a comma separated list of font names
177that are used in turn when trying to display Unicode characters. The 182that are checked in order when trying to find glyphs for characters. The
178first font defines the cell size for characters; other fonts might be 183first font defines the cell size for characters; other fonts might be
179smaller, but not (in general) larger. A (hopefully) reasonable default 184smaller, but not (in general) larger. A (hopefully) reasonable default
180font list is always appended to it. See resource B<font> for more details. 185font list is always appended to it. See resource B<font> for more details.
181 186
182In short, to specify an X11 core font, just specify it's name or prefix it 187In short, to specify an X11 core font, just specify it's name or prefix it
… …
189See also the question "How does rxvt-unicode choose fonts?" in the FAQ 194See also the question "How does rxvt-unicode choose fonts?" in the FAQ
190section of @@RXVT_NAME@@(7). 195section of @@RXVT_NAME@@(7).
191 196
192=item B<-fb> I<fontlist> 197=item B<-fb> I<fontlist>
193 198
194Compile font-styles: The bold font list to use when bold characters are to 199Compile I<font-styles>: The bold font list to use when B<bold> characters
195be printed. See resource B<boldFont> for details. 200are to be printed. See resource B<boldFont> for details.
196 201
197=item B<-fi> I<fontlist> 202=item B<-fi> I<fontlist>
198 203
199Compile font-styles: The italic font list to use when bold characters are to 204Compile I<font-styles>: The italic font list to use when I<italic>
200be printed. See resource B<italicFont> for details. 205characters are to be printed. See resource B<italicFont> for details.
201 206
202=item B<-fbi> I<fontlist> 207=item B<-fbi> I<fontlist>
203 208
204Compile font-styles: The bold italic font list to use when bold characters are to 209Compile I<font-styles>: The bold italic font list to use when B<< I<bold
205be printed. See resource B<boldItalicFont> for details. 210italic> >> characters are to be printed. See resource B<boldItalicFont>
211for details.
206 212
207=item B<-is>|B<+is> 213=item B<-is>|B<+is>
208 214
209Compile font-styles: Bold/Italic font styles imply high intensity 215Compile I<font-styles>: Bold/Italic font styles imply high intensity
210foreground/background (default). See resource B<intensityStyles> for 216foreground/background (default). See resource B<intensityStyles> for
211details. 217details.
212 218
213=item B<-name> I<name> 219=item B<-name> I<name>
214 220
… …
295=item B<-bl> 301=item B<-bl>
296 302
297Compile I<frills>: Set MWM hints to request a borderless window, i.e. 303Compile I<frills>: Set MWM hints to request a borderless window, i.e.
298if honoured by the WM, the rxvt-unicode window will not have window 304if honoured by the WM, the rxvt-unicode window will not have window
299decorations; resource B<borderLess>. 305decorations; resource B<borderLess>.
306
307=item B<-override-redirect>
308
309Compile I<frills>: Sets override-redirect on the window; resource
310B<override-redirect>.
311
312=item B<-sbg>
313
314Compile I<frills>: Disable the usage of the built-in block graphics/line
315drawing characters and just rely on what the specified fonts provide. Use
316this if you have a good font and want to use its block graphic glyphs;
317resource B<skipBuiltinGlyphs>.
300 318
301=item B<-lsp> I<number> 319=item B<-lsp> I<number>
302 320
303Compile I<frills>: Lines (pixel height) to insert between each row of 321Compile I<frills>: Lines (pixel height) to insert between each row of
304the display. Useful to work around font rendering problems; resource 322the display. Useful to work around font rendering problems; resource
… …
427 $rxvt->signal_connect_after (realize => sub { 445 $rxvt->signal_connect_after (realize => sub {
428 my $xid = $_[0]->window->get_xid; 446 my $xid = $_[0]->window->get_xid;
429 system "@@RXVT_NAME@@ -embed $xid &"; 447 system "@@RXVT_NAME@@ -embed $xid &";
430 }); 448 });
431 449
432=item B<-pty-fd> I<fileno> 450=item B<-pty-fd> I<file descriptor>
433 451
434Tells @@RXVT_NAME@@ NOT to execute any commands or create a new pty/tty 452Tells @@RXVT_NAME@@ NOT to execute any commands or create a new pty/tty
435pair but instead use the given filehandle as the tty master. This is 453pair but instead use the given filehandle as the tty master. This is
436useful if you want to drive @@RXVT_NAME@@ as a generic terminal emulator 454useful if you want to drive @@RXVT_NAME@@ as a generic terminal emulator
437without having to run a program within it. 455without having to run a program within it.
438 456
439If this switch is given, @@RXVT_NAME@@ will not create any utmp/wtmp 457If this switch is given, @@RXVT_NAME@@ will not create any utmp/wtmp
440entries and will not tinker with pty/tty permissions - you have to do that 458entries and will not tinker with pty/tty permissions - you have to do that
441yourself if you want that. 459yourself if you want that.
442 460
461As an extremely special case, specifying C<-1> will completely suppress
462pty/tty operations.
463
443Here is a example in perl that illustrates how this option can be used (a 464Here is a example in perl that illustrates how this option can be used (a
444longer example is in F<doc/pty-fd>): 465longer example is in F<doc/pty-fd>):
445 466
446 use IO::Pty; 467 use IO::Pty;
447 use Fcntl; 468 use Fcntl;
… …
453 474
454 # now communicate with rxvt 475 # now communicate with rxvt
455 my $slave = $pty->slave; 476 my $slave = $pty->slave;
456 while (<$slave>) { print $slave "got <$_>\n" } 477 while (<$slave>) { print $slave "got <$_>\n" }
457 478
479=item B<-pe> I<string>
480
481Comma-separated list of perl extension scripts to use (or not to use) in
482this terminal instance. See resource B<perl-ext> for details.
483
458=back 484=back
459 485
460=head1 RESOURCES (available also as long-options) 486=head1 RESOURCES (available also as long-options)
461 487
462Note: `@@RXVT_NAME@@ --help' gives a list of all resources (long 488Note: `@@RXVT_NAME@@ --help' gives a list of all resources (long
463options) compiled into your version. 489options) compiled into your version.
464 490
465There are two different methods that @@RXVT_NAME@@ can use to get the 491You can set and change the resources using X11 tools like B<xrdb>. Many
466Xresource data: using the X libraries (Xrm*-functions) or internal 492distribution do also load settings from the B<~/.Xresources> file when X
467Xresources reader (B<~/.Xdefaults>). For the first method (ie. 493starts. @@RXVT_NAME@@ will consult the following files/resources in order,
468B<@@RXVT_NAME@@ -h> lists B<XGetDefaults>), you can set and change the 494with later settings overwriting earlier ones:
469resources using X11 tools like B<xrdb>. Many distribution do also load
470settings from the B<~/.Xresources> file when X starts. @@RXVT_NAME@@
471will consult the following files/resources in order, with later settings
472overwriting earlier ones:
473 495
474 1. system-wide app-defaults file, either locale-dependent OR global 496 1. system-wide app-defaults file, either locale-dependent OR global
475 2. app-defaults file in $XAPPLRESDIR 497 2. app-defaults file in $XAPPLRESDIR
476 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults 498 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults
477 4. SCREEN_RESOURCES for the current screen 499 4. SCREEN_RESOURCES for the current screen
478 5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename> 500 5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename>
479 501
480If compiled with internal Xresources support (i.e. B<@@RXVT_NAME@@ -h>
481lists B<.Xdefaults>) then B<@@RXVT_NAME@@> accepts application defaults
482set in XAPPLOADDIR/URxvt (compile-time defined: usually
483B</usr/lib/X11/app-defaults/URxvt>) and resources set in
484B<~/.Xdefaults>, or B<~/.Xresources> if B<~/.Xdefaults> does not exist.
485Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two 502Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two class
486class names: B<XTerm> and B<URxvt>. The class name B<Rxvt> allows 503names: B<Rxvt> and B<URxvt>. The class name B<Rxvt> allows resources
487resources common to both B<@@RXVT_NAME@@> and the original I<rxvt> to be 504common to both B<@@RXVT_NAME@@> and the original I<rxvt> to be easily
488easily configured, while the class name B<URxvt> allows resources 505configured, while the class name B<URxvt> allows resources unique to
489unique to B<@@RXVT_NAME@@>, notably colours and key-handling, to be 506B<@@RXVT_NAME@@>, to be shared between different B<@@RXVT_NAME@@>
490shared between different B<@@RXVT_NAME@@> configurations. If no 507configurations. If no resources are specified, suitable defaults will
491resources are specified, suitable defaults will be used. Command-line 508be used. Command-line arguments can be used to override resource
492arguments can be used to override resource settings. The following 509settings. The following resources are supported (you might want to
493resources are allowed: 510check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl
511extensions not documented here):
494 512
495=over 4 513=over 4
514
515=item B<depth:> I<bitdepth>
516
517Compile I<frills>: Attempt to find a visual with the given bit depth;
518option B<-depth>.
496 519
497=item B<geometry:> I<geom> 520=item B<geometry:> I<geom>
498 521
499Create the window with the specified X window geometry [default 80x24]; 522Create the window with the specified X window geometry [default 80x24];
500option B<-geometry>. 523option B<-geometry>.
… …
619of 1 displays the image without any scaling. A scale of 2 to 9 642of 1 displays the image without any scaling. A scale of 2 to 9
620specifies an integer number of images in that direction. No image will 643specifies an integer number of images in that direction. No image will
621be magnified beyond 10 times its original size. The maximum permitted 644be magnified beyond 10 times its original size. The maximum permitted
622scale is 1000. [default 0x0+50+50] 645scale is 1000. [default 0x0+50+50]
623 646
624=item B<menu:> I<file[;tag]>
625
626Read in the specified menu file (note the `.menu' extension is
627optional) and also optionally specify a starting tag to find. See the
628reference documentation for details on the syntax for the menuBar.
629
630=item B<path:> I<path> 647=item B<path:> I<path>
631 648
632Specify the colon-delimited search path for finding files (XPM and 649Specify the colon-delimited search path for finding XPM files.
633menus), in addition to the paths specified by the B<RXVTPATH> and
634B<PATH> environment variables.
635 650
636=item B<font:> I<fontlist> 651=item B<font:> I<fontlist>
637 652
638Select the fonts to be used. This is a comma separated list of font 653Select the fonts to be used. This is a comma separated list of font names
639names that are used in turn when trying to display Unicode characters. 654that are checked in order when trying to find glyphs for characters. The
640The first font defines the cell size for characters; other fonts might 655first font defines the cell size for characters; other fonts might be
641be smaller, but not larger. A reasonable default font list is always 656smaller, but not (in general) larger. A (hopefully) reasonable default
642appended to it. option B<-fn>. 657font list is always appended to it; option B<-fn>.
643 658
644Each font can either be a standard X11 core font (XLFD) name, with 659Each font can either be a standard X11 core font (XLFD) name, with
645optional prefix C<x:> or a Xft font (Compile I<xft>), prefixed with C<xft:>. 660optional prefix C<x:> or a Xft font (Compile I<xft>), prefixed with C<xft:>.
646 661
647In addition, each font can be prefixed with additional hints and 662In addition, each font can be prefixed with additional hints and
… …
649hint currently is C<codeset=codeset-name>, and this is only used for Xft 664hint currently is C<codeset=codeset-name>, and this is only used for Xft
650fonts. 665fonts.
651 666
652For example, this font resource 667For example, this font resource
653 668
654 URxvt*font: 9x15bold,\ 669 URxvt.font: 9x15bold,\
655 -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\ 670 -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\
656 -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \ 671 -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \
657 [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \ 672 [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \
658 xft:Code2000:antialias=false 673 xft:Code2000:antialias=false
659 674
… …
756 771
757The string will be interpreted as if typed into the shell as-is. 772The string will be interpreted as if typed into the shell as-is.
758 773
759Example: 774Example:
760 775
761 URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) 776 URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
762 777
763This creates a new file in your home directory with the screen contents 778This creates a new file in your home directory with the screen contents
764everytime you hit C<Print>. 779everytime you hit C<Print>.
765 780
766=item B<scrollBar:> I<boolean> 781=item B<scrollBar:> I<boolean>
… …
820=item B<borderLess:> I<boolean> 835=item B<borderLess:> I<boolean>
821 836
822Set MWM hints to request a borderless window, i.e. if honoured by the 837Set MWM hints to request a borderless window, i.e. if honoured by the
823WM, the rxvt-unicode window will not have window decorations; option B<-bl>. 838WM, the rxvt-unicode window will not have window decorations; option B<-bl>.
824 839
840=item B<skipBuiltinGlyphs:> I<boolean>
841
842Compile I<frills>: Disable the usage of the built-in block graphics/line
843drawing characters and just rely on what the specified fonts provide. Use
844this if you have a good font and want to use its block graphic glyphs;
845option B<-sbg>.
846
825=item B<termName:> I<termname> 847=item B<termName:> I<termname>
826 848
827Specifies the terminal type name to be set in the B<TERM> environment 849Specifies the terminal type name to be set in the B<TERM> environment
828variable; option B<-tn>. 850variable; option B<-tn>.
829 851
… …
884pressed. If unset it will send the sequence traditionally associated 906pressed. If unset it will send the sequence traditionally associated
885with the B<Execute> key. 907with the B<Execute> key.
886 908
887=item B<cutchars:> I<string> 909=item B<cutchars:> I<string>
888 910
889The characters used as delimiters for double-click word selection. The 911The characters used as delimiters for double-click word selection
890built-in default: 912(whitespace delimiting is added automatically if resource is given).
913
914When the selection extension is in use (the default if compiled in, see
915the @@RXVT_NAME@@perl(3) manpage), a suitable regex using these characters
916will be created (if the resource exists, otherwise, no regex will be
917created). In this mode, characters outside ISO-8859-1 can be used.
918
919When the selection extension is not used, only ISO-8859-1 characters can
920be used. If not specified, the built-in default is used:
891 921
892B<< BACKSLASH `"'&()*,;<=>?@[]{|} >> 922B<< BACKSLASH `"'&()*,;<=>?@[]{|} >>
893 923
894=item B<preeditType:> I<style> 924=item B<preeditType:> I<style>
895 925
… …
902=item B<imLocale:> I<name> 932=item B<imLocale:> I<name>
903 933
904The locale to use for opening the IM. You can use an C<LC_CTYPE> of e.g. 934The locale to use for opening the IM. You can use an C<LC_CTYPE> of e.g.
905C<de_DE.UTF-8> for normal text processing but C<ja_JP.EUC-JP> for the 935C<de_DE.UTF-8> for normal text processing but C<ja_JP.EUC-JP> for the
906input extension to be able to input japanese characters while staying in 936input extension to be able to input japanese characters while staying in
907another locale. option B<-imlocale>. 937another locale; option B<-imlocale>.
908 938
909=item B<imFont:> I<fontset> 939=item B<imFont:> I<fontset>
910 940
911Specify the font-set used for XIM styles C<OverTheSpot> or 941Specify the font-set used for XIM styles C<OverTheSpot> or
912C<OffTheSpot>. It must be a standard X font set (XLFD patterns separated 942C<OffTheSpot>. It must be a standard X font set (XLFD patterns separated
… …
917 947
918=item B<tripleclickwords:> I<boolean> 948=item B<tripleclickwords:> I<boolean>
919 949
920Change the meaning of triple-click selection with the left mouse 950Change the meaning of triple-click selection with the left mouse
921button. Instead of selecting a full line it will extend the selection to 951button. Instead of selecting a full line it will extend the selection to
922the end of the logical line only. option B<-tcw>. 952the end of the logical line only; option B<-tcw>.
923 953
924=item B<insecure:> I<boolean> 954=item B<insecure:> I<boolean>
925 955
926Enables "insecure" mode. Rxvt-unicode offers some escape sequences that 956Enables "insecure" mode. Rxvt-unicode offers some escape sequences that
927echo arbitrary strings like the icon name or the locale. This could be 957echo arbitrary strings like the icon name or the locale. This could be
… …
931default. (Note that many other terminals, including xterm, have these 961default. (Note that many other terminals, including xterm, have these
932sequences enabled by default, which doesn't make it safer, though). 962sequences enabled by default, which doesn't make it safer, though).
933 963
934You can enable them by setting this boolean resource or specifying 964You can enable them by setting this boolean resource or specifying
935B<-insecure> as an option. At the moment, this enables display-answer, 965B<-insecure> as an option. At the moment, this enables display-answer,
936locale, findfont, icon label and window title requests as well as dynamic 966locale, findfont, icon label and window title requests.
937menubar dispatch.
938 967
939=item B<modifier:> I<modifier> 968=item B<modifier:> I<modifier>
940 969
941Set the key to be interpreted as the Meta key to: B<alt>, B<meta>, 970Set the key to be interpreted as the Meta key to: B<alt>, B<meta>,
942B<hyper>, B<super>, B<mod1>, B<mod2>, B<mod3>, B<mod4>, B<mod5>; option 971B<hyper>, B<super>, B<mod1>, B<mod2>, B<mod3>, B<mod4>, B<mod5>; option
… …
946 975
947Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E) 976Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E)
948character is passed through. It may contain escape values as described 977character is passed through. It may contain escape values as described
949in the entry on B<keysym> following. 978in the entry on B<keysym> following.
950 979
951=item B<secondaryScreen:> I<bool> 980=item B<secondaryScreen:> I<boolean>
952 981
953Turn on/off secondary screen (default enabled). 982Turn on/off secondary screen (default enabled).
954 983
955=item B<secondaryScroll:> I<bool> 984=item B<secondaryScroll:> I<boolean>
956 985
957Turn on/off secondary screen scroll (default enabled). If the this 986Turn on/off secondary screen scroll (default enabled). If the this
958option is enabled, scrolls on the secondary screen will change the 987option is enabled, scrolls on the secondary screen will change the
959scrollback buffer and switching to/from the secondary screen will 988scrollback buffer and switching to/from the secondary screen will
960instead scroll the screen up. 989instead scroll the screen up.
961 990
962=item B<hold>: I<bool> 991=item B<hold>: I<boolean>
963 992
964Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ 993Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
965will not immediately destroy its window when the program executed within 994will not immediately destroy its window when the program executed within
966it exits. Instead, it will wait till it is being killed or closed by the 995it exits. Instead, it will wait till it is being killed or closed by the
967user. 996user.
… …
992C<\e>, C<\E>: escape, C<\n>: newline, C<\r>: carriage return, C<\t>: tab, 1021C<\e>, C<\E>: escape, C<\n>: newline, C<\r>: carriage return, C<\t>: tab,
993C<\000>: octal number) or verbatim control characters (C<^?>: delete, 1022C<\000>: octal number) or verbatim control characters (C<^?>: delete,
994C<^@>: null, C<^A> ...) and may be enclosed with double quotes so that it 1023C<^@>: null, C<^A> ...) and may be enclosed with double quotes so that it
995can start or end with whitespace. 1024can start or end with whitespace.
996 1025
997Please note that you need to double the C<\> when using 1026Please note that you need to double the C<\> in resource files, as
998C<--enable-xgetdefault>, as X itself does it's own de-escaping (you can 1027Xlib itself does it's own de-escaping (you can use C<\033> instead of
999use C<\033> instead of C<\e> (and so on), which will work with both Xt and 1028C<\e> (and so on), which will work with both Xt and @@RXVT_NAME@@'s own
1000@@RXVT_NAME@@'s own processing). 1029processing).
1001 1030
1002You can define a range of keysyms in one shot by providing a I<string> 1031You can define a range of keysyms in one shot by providing a I<string>
1003with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where the delimeter `/' 1032with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where the delimeter `/'
1004should be a character not used by the strings. 1033should be a character not used by the strings.
1005 1034
… …
1017is interpreted and executed as @@RXVT_NAME@@'s control sequence. For 1046is interpreted and executed as @@RXVT_NAME@@'s control sequence. For
1018example the following means "change the current locale to C<zh_CN.GBK> 1047example the following means "change the current locale to C<zh_CN.GBK>
1019when Control-Meta-c is being pressed": 1048when Control-Meta-c is being pressed":
1020 1049
1021 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 1050 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
1051
1052If I<string> takes the form C<perl:STRING>, then the specified B<STRING>
1053is passed to the C<on_keyboard_command> perl handler. See the @@RXVT_NAME@@perl(3)
1054manpage. For example, the F<selection> extension (activated via
1055C<@@RXVT_NAME@@ -pe selection>) listens for C<selection:rot13> events:
1056
1057 URxvt.keysym.M-C-c: perl:selection:rot13
1022 1058
1023Due the the large number of modifier combinations, a defined key mapping 1059Due the the large number of modifier combinations, a defined key mapping
1024will match if at I<at least> the specified identifiers are being set, and 1060will match if at I<at least> the specified identifiers are being set, and
1025no other key mappings with those and more bits are being defined. That 1061no other key mappings with those and more bits are being defined. That
1026means that defining a key map for C<a> will automatically provide 1062means that defining a key map for C<a> will automatically provide
… …
1050info): 1086info):
1051 1087
1052 URxvt.keysym.M-C-3: command:\033[8;25;80t 1088 URxvt.keysym.M-C-3: command:\033[8;25;80t
1053 URxvt.keysym.M-C-4: command:\033[8;48;110t 1089 URxvt.keysym.M-C-4: command:\033[8;48;110t
1054 1090
1091=item B<perl-ext-common>: I<string>
1092
1093=item B<perl-ext>: I<string>
1094
1095Comma-separated list(s) of perl extension scripts (default: C<default>) to
1096use in this terminal instance; option B<-pe>.
1097
1098Extension names can be prefixed with a C<-> sign to prohibit using
1099them. This can be useful to selectively disable some extensions loaded
1100by default, or specified via the C<perl-ext-common> resource. For
1101example, C<default,-selection> will use all the default extension except
1102C<selection>.
1103
1104Extension names can also be followed by an argument in angle brackets
1105(e.g. C<< searchable-scrollback<M-s> >>, which binds the hotkey for
1106searchable scorllback to Alt/Meta-s). Mentioning the same extension
1107multiple times with different arguments will pass multiple arguments to
1108the extension.
1109
1110Each extension is looked up in the library directories, loaded if
1111necessary, and bound to the current terminal instance.
1112
1113If both of these resources are the empty string, then the perl
1114interpreter will not be initialized. The idea behind two options is that
1115B<perl-ext-common> will be used for extensions that should be available to
1116all instances, while B<perl-ext> is used for specific instances.
1117
1118=item B<perl-eval>: I<string>
1119
1120Perl code to be evaluated when all extensions have been registered. See
1121the @@RXVT_NAME@@perl(3) manpage. Due to security reasons, this resource
1122will be ignored when running setuid/setgid.
1123
1124=item B<perl-lib>: I<path>
1125
1126Colon-separated list of additional directories that hold extension
1127scripts. When looking for extensions specified by the C<perl> resource,
1128@@RXVT_NAME@@ will first look in these directories and then in
1129F<@@RXVT_LIBDIR@@/urxvt/perl/>. Due to security reasons, this resource
1130will be ignored when running setuid/setgid.
1131
1132See the @@RXVT_NAME@@perl(3) manpage.
1133
1134=item B<< selection.pattern-I<idx> >>: I<perl-regex>
1135
1136Additional selection patterns, see the @@RXVT_NAME@@perl(3) manpage for
1137details.
1138
1139=item B<< selection-autotransform.I<idx> >>: I<perl-transform>
1140
1141Selection auto-transform patterns, see the @@RXVT_NAME@@perl(3) manpage
1142for details.
1143
1144=item B<searchable-scrollback:> I<keysym>
1145
1146Sets the hotkey that starts the incremental scrollback buffer search
1147(default: C<M-s>).
1148
1149=item B<urlLauncher>: I<string>
1150
1151Specifies the program to be started with a URL argument. Used by the
1152C<selection-popup> and C<mark-urls> perl extensions.
1153
1154=item B<transient-for>: I<windowid>
1155
1156Compile I<frills>: Sets the WM_TRANSIENT_FOR property to the given window id.
1157
1158=item B<override-redirect>: I<boolean>
1159
1160Compile I<frills>: Sets override-redirect for the terminal window, making
1161it almost invisible to window managers; option B<-override-redirect>.
1162
1055=back 1163=back
1056 1164
1057=head1 THE SCROLLBAR 1165=head1 THE SCROLLBAR
1058 1166
1059Lines of text that scroll off the top of the B<@@RXVT_NAME@@> window 1167Lines of text that scroll off the top of the B<@@RXVT_NAME@@> window
… …
1100selection, and trailing whitespace is visually underlined and removed from 1208selection, and trailing whitespace is visually underlined and removed from
1101the selection. 1209the selection.
1102 1210
1103=item B<Insertion>: 1211=item B<Insertion>:
1104 1212
1105Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in 1213Pressing and releasing the Middle mouse button in an B<@@RXVT_NAME@@>
1106an B<@@RXVT_NAME@@> window causes the current text selection to be 1214window causes the value of the PRIMARY selection (or CLIPBOARD with the
1107inserted as if it had been typed on the keyboard. 1215Meta modifier) to be inserted as if it had been typed on the keyboard.
1216
1217Pressing B<Shift-Insert> causes the value of the PRIMARY selection to be
1218inserted too.
1108 1219
1109=back 1220=back
1110 1221
1111=head1 CHANGING FONTS 1222=head1 CHANGING FONTS
1112 1223
1113Changing fonts (or font sizes, respectively) via the keypad is not yet 1224Changing fonts (or font sizes, respectively) via the keypad is not yet
1114supported in rxvt-unicode. Bug me if you need this. 1225supported in rxvt-unicode. Bug me if you need this.
1115 1226
1116You can, however, switch fonts at runtime using escape sequences (and 1227You can, however, switch fonts at runtime using escape sequences, e.g.:
1117therefore using the menubar), e.g.:
1118 1228
1119 printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic" 1229 printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic"
1230
1231You can use keyboard shortcuts, too:
1232
1233 URxvt.keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
1234 URxvt.keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007
1120 1235
1121rxvt-unicode will automatically re-apply these fonts to the output so far. 1236rxvt-unicode will automatically re-apply these fonts to the output so far.
1122 1237
1123=head1 ISO 14755 SUPPORT 1238=head1 ISO 14755 SUPPORT
1124 1239
… …
1195=head1 COLORS AND GRAPHICS 1310=head1 COLORS AND GRAPHICS
1196 1311
1197In addition to the default foreground and background colours, 1312In addition to the default foreground and background colours,
1198B<@@RXVT_NAME@@> can display up to 16 colours (8 ANSI colours plus 1313B<@@RXVT_NAME@@> can display up to 16 colours (8 ANSI colours plus
1199high-intensity bold/blink versions of the same). Here is a list of the 1314high-intensity bold/blink versions of the same). Here is a list of the
1200colours with their B<rgb.txt> names. 1315colours with their names.
1201 1316
1202=begin table 1317=begin table
1203 1318
1204 B<color0> (black) = Black 1319 B<color0> (black) = Black
1205 B<color1> (red) = Red3 1320 B<color1> (red) = Red3
… …
1225It is also possible to specify the colour values of B<foreground>, 1340It is also possible to specify the colour values of B<foreground>,
1226B<background>, B<cursorColor>, B<cursorColor2>, B<colorBD>, B<colorUL> as 1341B<background>, B<cursorColor>, B<cursorColor2>, B<colorBD>, B<colorUL> as
1227a number 0-15, as a convenient shorthand to reference the colour name of 1342a number 0-15, as a convenient shorthand to reference the colour name of
1228color0-color15. 1343color0-color15.
1229 1344
1345If Xft support has been compiled in and as long as Xft/Xrender don't get
1346their act together, rxvt-unicode will support C<#ARGB>, C<#AARRGGBB>
1347and C<#AAAARRRRGGGGBBBB> colour specifications, in addition to the ones
1348provided by X, where the additional A component specifies alpha (opacity)
1349values (0 is completely transparent and the maximum is opaque). You
1350probably need to specify B<"-depth 32">, too, as X is far from just
1351supporting ARGB visuals out of the box.
1352
1230Note that B<-rv> (B<"reverseVideo: True">) simulates reverse video by 1353Note that B<-rv> (B<"reverseVideo: True">) simulates reverse video by
1231always swapping the foreground/background colours. This is in contrast to 1354always swapping the foreground/background colours. This is in contrast to
1232I<xterm>(1) where the colours are only swapped if they have not otherwise 1355I<xterm>(1) where the colours are only swapped if they have not otherwise
1233been specified. For example, 1356been specified. For example,
1234 1357
… …
1286 1409
1287=item B<SHELL> 1410=item B<SHELL>
1288 1411
1289The shell to be used for command execution, defaults to C</bin/sh>. 1412The shell to be used for command execution, defaults to C</bin/sh>.
1290 1413
1291=item B<RXVTPATH>
1292
1293The path where @@RXVT_NAME@@ looks for support files such as menu and xpm
1294files.
1295
1296=item B<PATH>
1297
1298Used in the same way as C<RXVTPATH>.
1299
1300=item B<RXVT_SOCKET> 1414=item B<RXVT_SOCKET>
1301 1415
1302The unix domain socket path used by @@RXVT_NAME@@c(1) and 1416The unix domain socket path used by @@RXVT_NAME@@c(1) and
1303@@RXVT_NAME@@d(1). 1417@@RXVT_NAME@@d(1).
1304 1418
… …
1373 1487
1374Project Coordinator (changes.txt 2.21a to 2.4.5) 1488Project Coordinator (changes.txt 2.21a to 2.4.5)
1375 1489
1376=item Geoff Wing L<< <gcw@pobox.com> >> 1490=item Geoff Wing L<< <gcw@pobox.com> >>
1377 1491
1378Rewrote screen display and text selection routines. Project Coordinator 1492Rewrote screen display and text selection routines.
1493
1379(changes.txt 2.4.6 - rxvt-unicode) 1494Project Coordinator (changes.txt 2.4.6 - rxvt-unicode)
1380 1495
1381=item Marc Alexander Lehmann L<< <rxvt-unicode@schmorp.de> >> 1496=item Marc Alexander Lehmann L<< <rxvt-unicode@schmorp.de> >>
1382 1497
1383Forked rxvt-unicode, rewrote most of the display code and internal 1498Forked rxvt-unicode, unicode support, rewrote almost all the code, perl
1384character handling to store text in unicode, improve xterm 1499extension, random hacks, numerous bugfixes and extensions.
1385compatibility and apply numerous other bugfixes and extensions.
1386 1500
1387Project Coordinator (Changes 1.0 -) 1501Project Coordinator (Changes 1.0 -)
1388 1502
1503=item Emanuele Giaquinta L<< <e.giaquinta@glauco.it> >>
1504
1505Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.
1506
1389=back 1507=back
1390 1508

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines