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.105 by root, Wed Jan 25 13:26:48 2006 UTC

… …
172resource B<borderColor>. 172resource B<borderColor>.
173 173
174=item B<-fn> I<fontlist> 174=item B<-fn> I<fontlist>
175 175
176Select the fonts to be used. This is a comma separated list of font names 176Select 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 177that are checked in order when trying to find glyphs for characters. The
178first font defines the cell size for characters; other fonts might be 178first font defines the cell size for characters; other fonts might be
179smaller, but not (in general) larger. A (hopefully) reasonable default 179smaller, but not (in general) larger. A (hopefully) reasonable default
180font list is always appended to it. See resource B<font> for more details. 180font list is always appended to it. See resource B<font> for more details.
181 181
182In short, to specify an X11 core font, just specify it's name or prefix it 182In 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 189See also the question "How does rxvt-unicode choose fonts?" in the FAQ
190section of @@RXVT_NAME@@(7). 190section of @@RXVT_NAME@@(7).
191 191
192=item B<-fb> I<fontlist> 192=item B<-fb> I<fontlist>
193 193
194Compile font-styles: The bold font list to use when bold characters are to 194Compile I<font-styles>: The bold font list to use when B<bold> characters
195be printed. See resource B<boldFont> for details. 195are to be printed. See resource B<boldFont> for details.
196 196
197=item B<-fi> I<fontlist> 197=item B<-fi> I<fontlist>
198 198
199Compile font-styles: The italic font list to use when bold characters are to 199Compile I<font-styles>: The italic font list to use when I<italic>
200be printed. See resource B<italicFont> for details. 200characters are to be printed. See resource B<italicFont> for details.
201 201
202=item B<-fbi> I<fontlist> 202=item B<-fbi> I<fontlist>
203 203
204Compile font-styles: The bold italic font list to use when bold characters are to 204Compile I<font-styles>: The bold italic font list to use when B<< I<bold
205be printed. See resource B<boldItalicFont> for details. 205italic> >> characters are to be printed. See resource B<boldItalicFont>
206for details.
206 207
207=item B<-is>|B<+is> 208=item B<-is>|B<+is>
208 209
209Compile font-styles: Bold/Italic font styles imply high intensity 210Compile I<font-styles>: Bold/Italic font styles imply high intensity
210foreground/background (default). See resource B<intensityStyles> for 211foreground/background (default). See resource B<intensityStyles> for
211details. 212details.
212 213
213=item B<-name> I<name> 214=item B<-name> I<name>
214 215
… …
295=item B<-bl> 296=item B<-bl>
296 297
297Compile I<frills>: Set MWM hints to request a borderless window, i.e. 298Compile 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 299if honoured by the WM, the rxvt-unicode window will not have window
299decorations; resource B<borderLess>. 300decorations; resource B<borderLess>.
301
302=item B<-override-redirect>
303
304Compile I<frills>: Sets override-redirect on the window; resource
305B<override-redirect>.
306
307=item B<-sbg>
308
309Compile I<frills>: Disable the usage of the built-in block graphics/line
310drawing characters and just rely on what the specified fonts provide. Use
311this if you have a good font and want to use its block graphic glyphs;
312resource B<skipBuiltinGlyphs>.
300 313
301=item B<-lsp> I<number> 314=item B<-lsp> I<number>
302 315
303Compile I<frills>: Lines (pixel height) to insert between each row of 316Compile I<frills>: Lines (pixel height) to insert between each row of
304the display. Useful to work around font rendering problems; resource 317the display. Useful to work around font rendering problems; resource
… …
427 $rxvt->signal_connect_after (realize => sub { 440 $rxvt->signal_connect_after (realize => sub {
428 my $xid = $_[0]->window->get_xid; 441 my $xid = $_[0]->window->get_xid;
429 system "@@RXVT_NAME@@ -embed $xid &"; 442 system "@@RXVT_NAME@@ -embed $xid &";
430 }); 443 });
431 444
432=item B<-pty-fd> I<fileno> 445=item B<-pty-fd> I<file descriptor>
433 446
434Tells @@RXVT_NAME@@ NOT to execute any commands or create a new pty/tty 447Tells @@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 448pair 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 449useful if you want to drive @@RXVT_NAME@@ as a generic terminal emulator
437without having to run a program within it. 450without having to run a program within it.
438 451
439If this switch is given, @@RXVT_NAME@@ will not create any utmp/wtmp 452If 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 453entries and will not tinker with pty/tty permissions - you have to do that
441yourself if you want that. 454yourself if you want that.
442 455
456As an extremely special case, specifying C<-1> will completely suppress
457pty/tty operations.
458
443Here is a example in perl that illustrates how this option can be used (a 459Here is a example in perl that illustrates how this option can be used (a
444longer example is in F<doc/pty-fd>): 460longer example is in F<doc/pty-fd>):
445 461
446 use IO::Pty; 462 use IO::Pty;
447 use Fcntl; 463 use Fcntl;
… …
453 469
454 # now communicate with rxvt 470 # now communicate with rxvt
455 my $slave = $pty->slave; 471 my $slave = $pty->slave;
456 while (<$slave>) { print $slave "got <$_>\n" } 472 while (<$slave>) { print $slave "got <$_>\n" }
457 473
474=item B<-pe> I<string>
475
476Comma-separated list of perl extension scripts to use (or not to use) in
477this terminal instance. See resource B<perl-ext> for details.
478
458=back 479=back
459 480
460=head1 RESOURCES (available also as long-options) 481=head1 RESOURCES (available also as long-options)
461 482
462Note: `@@RXVT_NAME@@ --help' gives a list of all resources (long 483Note: `@@RXVT_NAME@@ --help' gives a list of all resources (long
463options) compiled into your version. 484options) compiled into your version.
464 485
465There are two different methods that @@RXVT_NAME@@ can use to get the 486You can set and change the resources using X11 tools like B<xrdb>. Many
466Xresource data: using the X libraries (Xrm*-functions) or internal 487distribution do also load settings from the B<~/.Xresources> file when X
467Xresources reader (B<~/.Xdefaults>). For the first method (ie. 488starts. @@RXVT_NAME@@ will consult the following files/resources in order,
468B<@@RXVT_NAME@@ -h> lists B<XGetDefaults>), you can set and change the 489with 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 490
474 1. system-wide app-defaults file, either locale-dependent OR global 491 1. system-wide app-defaults file, either locale-dependent OR global
475 2. app-defaults file in $XAPPLRESDIR 492 2. app-defaults file in $XAPPLRESDIR
476 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults 493 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults
477 4. SCREEN_RESOURCES for the current screen 494 4. SCREEN_RESOURCES for the current screen
478 5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename> 495 5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename>
479 496
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 497Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two class
486class names: B<XTerm> and B<URxvt>. The class name B<Rxvt> allows 498names: 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 499common to both B<@@RXVT_NAME@@> and the original I<rxvt> to be easily
488easily configured, while the class name B<URxvt> allows resources 500configured, while the class name B<URxvt> allows resources unique to
489unique to B<@@RXVT_NAME@@>, notably colours and key-handling, to be 501B<@@RXVT_NAME@@>, to be shared between different B<@@RXVT_NAME@@>
490shared between different B<@@RXVT_NAME@@> configurations. If no 502configurations. If no resources are specified, suitable defaults will
491resources are specified, suitable defaults will be used. Command-line 503be used. Command-line arguments can be used to override resource
492arguments can be used to override resource settings. The following 504settings. The following resources are supported (you might want to
493resources are allowed: 505check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl
506extensions not documented here):
494 507
495=over 4 508=over 4
496 509
497=item B<geometry:> I<geom> 510=item B<geometry:> I<geom>
498 511
… …
619of 1 displays the image without any scaling. A scale of 2 to 9 632of 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 633specifies an integer number of images in that direction. No image will
621be magnified beyond 10 times its original size. The maximum permitted 634be magnified beyond 10 times its original size. The maximum permitted
622scale is 1000. [default 0x0+50+50] 635scale is 1000. [default 0x0+50+50]
623 636
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> 637=item B<path:> I<path>
631 638
632Specify the colon-delimited search path for finding files (XPM and 639Specify 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 640
636=item B<font:> I<fontlist> 641=item B<font:> I<fontlist>
637 642
638Select the fonts to be used. This is a comma separated list of font 643Select 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. 644that are checked in order when trying to find glyphs for characters. The
640The first font defines the cell size for characters; other fonts might 645first font defines the cell size for characters; other fonts might be
641be smaller, but not larger. A reasonable default font list is always 646smaller, but not (in general) larger. A (hopefully) reasonable default
642appended to it. option B<-fn>. 647font list is always appended to it; option B<-fn>.
643 648
644Each font can either be a standard X11 core font (XLFD) name, with 649Each 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:>. 650optional prefix C<x:> or a Xft font (Compile I<xft>), prefixed with C<xft:>.
646 651
647In addition, each font can be prefixed with additional hints and 652In addition, each font can be prefixed with additional hints and
… …
649hint currently is C<codeset=codeset-name>, and this is only used for Xft 654hint currently is C<codeset=codeset-name>, and this is only used for Xft
650fonts. 655fonts.
651 656
652For example, this font resource 657For example, this font resource
653 658
654 URxvt*font: 9x15bold,\ 659 URxvt.font: 9x15bold,\
655 -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\ 660 -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, \ 661 -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \
657 [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \ 662 [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \
658 xft:Code2000:antialias=false 663 xft:Code2000:antialias=false
659 664
… …
756 761
757The string will be interpreted as if typed into the shell as-is. 762The string will be interpreted as if typed into the shell as-is.
758 763
759Example: 764Example:
760 765
761 URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) 766 URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
762 767
763This creates a new file in your home directory with the screen contents 768This creates a new file in your home directory with the screen contents
764everytime you hit C<Print>. 769everytime you hit C<Print>.
765 770
766=item B<scrollBar:> I<boolean> 771=item B<scrollBar:> I<boolean>
… …
820=item B<borderLess:> I<boolean> 825=item B<borderLess:> I<boolean>
821 826
822Set MWM hints to request a borderless window, i.e. if honoured by the 827Set 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>. 828WM, the rxvt-unicode window will not have window decorations; option B<-bl>.
824 829
830=item B<skipBuiltinGlyphs:> I<boolean>
831
832Compile I<frills>: Disable the usage of the built-in block graphics/line
833drawing characters and just rely on what the specified fonts provide. Use
834this if you have a good font and want to use its block graphic glyphs;
835option B<-sbg>.
836
825=item B<termName:> I<termname> 837=item B<termName:> I<termname>
826 838
827Specifies the terminal type name to be set in the B<TERM> environment 839Specifies the terminal type name to be set in the B<TERM> environment
828variable; option B<-tn>. 840variable; option B<-tn>.
829 841
… …
884pressed. If unset it will send the sequence traditionally associated 896pressed. If unset it will send the sequence traditionally associated
885with the B<Execute> key. 897with the B<Execute> key.
886 898
887=item B<cutchars:> I<string> 899=item B<cutchars:> I<string>
888 900
889The characters used as delimiters for double-click word selection. The 901The characters used as delimiters for double-click word selection
890built-in default: 902(whitespace delimiting is added automatically if resource is given).
903
904When the selection extension is in use (the default if compiled in, see
905the @@RXVT_NAME@@perl(3) manpage), a suitable regex using these characters
906will be created (if the resource exists, otherwise, no regex will be
907created). In this mode, characters outside ISO-8859-1 can be used.
908
909When the selection extension is not used, only ISO-8859-1 characters can
910be used. If not specified, the built-in default is used:
891 911
892B<< BACKSLASH `"'&()*,;<=>?@[]{|} >> 912B<< BACKSLASH `"'&()*,;<=>?@[]{|} >>
893 913
894=item B<preeditType:> I<style> 914=item B<preeditType:> I<style>
895 915
… …
902=item B<imLocale:> I<name> 922=item B<imLocale:> I<name>
903 923
904The locale to use for opening the IM. You can use an C<LC_CTYPE> of e.g. 924The 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 925C<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 926input extension to be able to input japanese characters while staying in
907another locale. option B<-imlocale>. 927another locale; option B<-imlocale>.
908 928
909=item B<imFont:> I<fontset> 929=item B<imFont:> I<fontset>
910 930
911Specify the font-set used for XIM styles C<OverTheSpot> or 931Specify the font-set used for XIM styles C<OverTheSpot> or
912C<OffTheSpot>. It must be a standard X font set (XLFD patterns separated 932C<OffTheSpot>. It must be a standard X font set (XLFD patterns separated
… …
917 937
918=item B<tripleclickwords:> I<boolean> 938=item B<tripleclickwords:> I<boolean>
919 939
920Change the meaning of triple-click selection with the left mouse 940Change the meaning of triple-click selection with the left mouse
921button. Instead of selecting a full line it will extend the selection to 941button. Instead of selecting a full line it will extend the selection to
922the end of the logical line only. option B<-tcw>. 942the end of the logical line only; option B<-tcw>.
923 943
924=item B<insecure:> I<boolean> 944=item B<insecure:> I<boolean>
925 945
926Enables "insecure" mode. Rxvt-unicode offers some escape sequences that 946Enables "insecure" mode. Rxvt-unicode offers some escape sequences that
927echo arbitrary strings like the icon name or the locale. This could be 947echo arbitrary strings like the icon name or the locale. This could be
… …
931default. (Note that many other terminals, including xterm, have these 951default. (Note that many other terminals, including xterm, have these
932sequences enabled by default, which doesn't make it safer, though). 952sequences enabled by default, which doesn't make it safer, though).
933 953
934You can enable them by setting this boolean resource or specifying 954You can enable them by setting this boolean resource or specifying
935B<-insecure> as an option. At the moment, this enables display-answer, 955B<-insecure> as an option. At the moment, this enables display-answer,
936locale, findfont, icon label and window title requests as well as dynamic 956locale, findfont, icon label and window title requests.
937menubar dispatch.
938 957
939=item B<modifier:> I<modifier> 958=item B<modifier:> I<modifier>
940 959
941Set the key to be interpreted as the Meta key to: B<alt>, B<meta>, 960Set 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 961B<hyper>, B<super>, B<mod1>, B<mod2>, B<mod3>, B<mod4>, B<mod5>; option
… …
946 965
947Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E) 966Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E)
948character is passed through. It may contain escape values as described 967character is passed through. It may contain escape values as described
949in the entry on B<keysym> following. 968in the entry on B<keysym> following.
950 969
951=item B<secondaryScreen:> I<bool> 970=item B<secondaryScreen:> I<boolean>
952 971
953Turn on/off secondary screen (default enabled). 972Turn on/off secondary screen (default enabled).
954 973
955=item B<secondaryScroll:> I<bool> 974=item B<secondaryScroll:> I<boolean>
956 975
957Turn on/off secondary screen scroll (default enabled). If the this 976Turn on/off secondary screen scroll (default enabled). If the this
958option is enabled, scrolls on the secondary screen will change the 977option is enabled, scrolls on the secondary screen will change the
959scrollback buffer and switching to/from the secondary screen will 978scrollback buffer and switching to/from the secondary screen will
960instead scroll the screen up. 979instead scroll the screen up.
961 980
962=item B<hold>: I<bool> 981=item B<hold>: I<boolean>
963 982
964Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ 983Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
965will not immediately destroy its window when the program executed within 984will 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 985it exits. Instead, it will wait till it is being killed or closed by the
967user. 986user.
… …
992C<\e>, C<\E>: escape, C<\n>: newline, C<\r>: carriage return, C<\t>: tab, 1011C<\e>, C<\E>: escape, C<\n>: newline, C<\r>: carriage return, C<\t>: tab,
993C<\000>: octal number) or verbatim control characters (C<^?>: delete, 1012C<\000>: octal number) or verbatim control characters (C<^?>: delete,
994C<^@>: null, C<^A> ...) and may be enclosed with double quotes so that it 1013C<^@>: null, C<^A> ...) and may be enclosed with double quotes so that it
995can start or end with whitespace. 1014can start or end with whitespace.
996 1015
997Please note that you need to double the C<\> when using 1016Please 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 1017Xlib 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 1018C<\e> (and so on), which will work with both Xt and @@RXVT_NAME@@'s own
1000@@RXVT_NAME@@'s own processing). 1019processing).
1001 1020
1002You can define a range of keysyms in one shot by providing a I<string> 1021You can define a range of keysyms in one shot by providing a I<string>
1003with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where the delimeter `/' 1022with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where the delimeter `/'
1004should be a character not used by the strings. 1023should be a character not used by the strings.
1005 1024
… …
1017is interpreted and executed as @@RXVT_NAME@@'s control sequence. For 1036is interpreted and executed as @@RXVT_NAME@@'s control sequence. For
1018example the following means "change the current locale to C<zh_CN.GBK> 1037example the following means "change the current locale to C<zh_CN.GBK>
1019when Control-Meta-c is being pressed": 1038when Control-Meta-c is being pressed":
1020 1039
1021 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 1040 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
1041
1042If I<string> takes the form C<perl:STRING>, then the specified B<STRING>
1043is passed to the C<on_keyboard_command> perl handler. See the @@RXVT_NAME@@perl(3)
1044manpage. For example, the F<selection> extension (activated via
1045C<@@RXVT_NAME@@ -pe selection>) listens for C<selection:rot13> events:
1046
1047 URxvt.keysym.M-C-c: perl:selection:rot13
1022 1048
1023Due the the large number of modifier combinations, a defined key mapping 1049Due 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 1050will 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 1051no other key mappings with those and more bits are being defined. That
1026means that defining a key map for C<a> will automatically provide 1052means that defining a key map for C<a> will automatically provide
… …
1050info): 1076info):
1051 1077
1052 URxvt.keysym.M-C-3: command:\033[8;25;80t 1078 URxvt.keysym.M-C-3: command:\033[8;25;80t
1053 URxvt.keysym.M-C-4: command:\033[8;48;110t 1079 URxvt.keysym.M-C-4: command:\033[8;48;110t
1054 1080
1081=item B<perl-ext-common>: I<string>
1082
1083=item B<perl-ext>: I<string>
1084
1085Comma-separated list(s) of perl extension scripts (default: C<default>) to
1086use in this terminal instance; option B<-pe>.
1087
1088Extension names can be prefixed with a C<-> sign to prohibit using
1089them. This can be useful to selectively disable some extensions loaded
1090by default, or specified via the C<perl-ext-common> resource. For
1091example, C<default,-selection> will use all the default extension except
1092C<selection>.
1093
1094Extension names can also be followed by an argument in angle brackets
1095(e.g. C<< searchable-scrollback<M-s> >>, which binds the hotkey for
1096searchable scorllback to Alt/Meta-s). Mentioning the same extension
1097multiple times with different arguments will pass multiple arguments to
1098the extension.
1099
1100Each extension is looked up in the library directories, loaded if
1101necessary, and bound to the current terminal instance.
1102
1103If both of these resources are the empty string, then the perl
1104interpreter will not be initialized. The idea behind two options is that
1105B<perl-ext-common> will be used for extensions that should be available to
1106all instances, while B<perl-ext> is used for specific instances.
1107
1108=item B<perl-eval>: I<string>
1109
1110Perl code to be evaluated when all extensions have been registered. See
1111the @@RXVT_NAME@@perl(3) manpage. Due to security reasons, this resource
1112will be ignored when running setuid/setgid.
1113
1114=item B<perl-lib>: I<path>
1115
1116Colon-separated list of additional directories that hold extension
1117scripts. When looking for extensions specified by the C<perl> resource,
1118@@RXVT_NAME@@ will first look in these directories and then in
1119F<@@RXVT_LIBDIR@@/urxvt/perl/>. Due to security reasons, this resource
1120will be ignored when running setuid/setgid.
1121
1122See the @@RXVT_NAME@@perl(3) manpage.
1123
1124=item B<< selection.pattern-I<idx> >>: I<perl-regex>
1125
1126Additional selection patterns, see the @@RXVT_NAME@@perl(3) manpage for
1127details.
1128
1129=item B<< selection-autotransform.I<idx> >>: I<perl-transform>
1130
1131Selection auto-transform patterns, see the @@RXVT_NAME@@perl(3) manpage
1132for details.
1133
1134=item B<searchable-scrollback:> I<keysym>
1135
1136Sets the hotkey that starts the incremental scrollback buffer search
1137(default: C<M-s>).
1138
1139=item B<urlLauncher>: I<string>
1140
1141Specifies the program to be started with a URL argument. Used by the
1142C<selection-popup> and C<mark-urls> perl extensions.
1143
1144=item B<transient-for>: I<windowid>
1145
1146Compile I<frills>: Sets the WM_TRANSIENT_FOR property to the given window id.
1147
1148=item B<override-redirect>: I<boolean>
1149
1150Compile I<frills>: Sets override-redirect for the terminal window, making
1151it almost invisible to window managers; option B<-override-redirect>.
1152
1055=back 1153=back
1056 1154
1057=head1 THE SCROLLBAR 1155=head1 THE SCROLLBAR
1058 1156
1059Lines of text that scroll off the top of the B<@@RXVT_NAME@@> window 1157Lines of text that scroll off the top of the B<@@RXVT_NAME@@> window
… …
1100selection, and trailing whitespace is visually underlined and removed from 1198selection, and trailing whitespace is visually underlined and removed from
1101the selection. 1199the selection.
1102 1200
1103=item B<Insertion>: 1201=item B<Insertion>:
1104 1202
1105Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in 1203Pressing and releasing the Middle mouse button in an B<@@RXVT_NAME@@>
1106an B<@@RXVT_NAME@@> window causes the current text selection to be 1204window causes the value of the PRIMARY selection (or CLIPBOARD with the
1107inserted as if it had been typed on the keyboard. 1205Meta modifier) to be inserted as if it had been typed on the keyboard.
1206
1207Pressing B<Shift-Insert> causes the value of the PRIMARY selection to be
1208inserted too.
1108 1209
1109=back 1210=back
1110 1211
1111=head1 CHANGING FONTS 1212=head1 CHANGING FONTS
1112 1213
1113Changing fonts (or font sizes, respectively) via the keypad is not yet 1214Changing fonts (or font sizes, respectively) via the keypad is not yet
1114supported in rxvt-unicode. Bug me if you need this. 1215supported in rxvt-unicode. Bug me if you need this.
1115 1216
1116You can, however, switch fonts at runtime using escape sequences (and 1217You can, however, switch fonts at runtime using escape sequences, e.g.:
1117therefore using the menubar), e.g.:
1118 1218
1119 printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic" 1219 printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic"
1220
1221You can use keyboard shortcuts, too:
1222
1223 URxvt.keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
1224 URxvt.keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007
1120 1225
1121rxvt-unicode will automatically re-apply these fonts to the output so far. 1226rxvt-unicode will automatically re-apply these fonts to the output so far.
1122 1227
1123=head1 ISO 14755 SUPPORT 1228=head1 ISO 14755 SUPPORT
1124 1229
… …
1286 1391
1287=item B<SHELL> 1392=item B<SHELL>
1288 1393
1289The shell to be used for command execution, defaults to C</bin/sh>. 1394The shell to be used for command execution, defaults to C</bin/sh>.
1290 1395
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> 1396=item B<RXVT_SOCKET>
1301 1397
1302The unix domain socket path used by @@RXVT_NAME@@c(1) and 1398The unix domain socket path used by @@RXVT_NAME@@c(1) and
1303@@RXVT_NAME@@d(1). 1399@@RXVT_NAME@@d(1).
1304 1400
… …
1373 1469
1374Project Coordinator (changes.txt 2.21a to 2.4.5) 1470Project Coordinator (changes.txt 2.21a to 2.4.5)
1375 1471
1376=item Geoff Wing L<< <gcw@pobox.com> >> 1472=item Geoff Wing L<< <gcw@pobox.com> >>
1377 1473
1378Rewrote screen display and text selection routines. Project Coordinator 1474Rewrote screen display and text selection routines.
1475
1379(changes.txt 2.4.6 - rxvt-unicode) 1476Project Coordinator (changes.txt 2.4.6 - rxvt-unicode)
1380 1477
1381=item Marc Alexander Lehmann L<< <rxvt-unicode@schmorp.de> >> 1478=item Marc Alexander Lehmann L<< <rxvt-unicode@schmorp.de> >>
1382 1479
1383Forked rxvt-unicode, rewrote most of the display code and internal 1480Forked rxvt-unicode, unicode support, rewrote almost all the code, perl
1384character handling to store text in unicode, improve xterm 1481extension, random hacks, numerous bugfixes and extensions.
1385compatibility and apply numerous other bugfixes and extensions.
1386 1482
1387Project Coordinator (Changes 1.0 -) 1483Project Coordinator (Changes 1.0 -)
1388 1484
1485=item Emanuele Giaquinta L<< <e.giaquinta@glauco.it> >>
1486
1487Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.
1488
1389=back 1489=back
1390 1490

Diff Legend

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