… | |
… | |
476 | =head1 RESOURCES (available also as long-options) |
476 | =head1 RESOURCES (available also as long-options) |
477 | |
477 | |
478 | Note: `@@RXVT_NAME@@ --help' gives a list of all resources (long |
478 | Note: `@@RXVT_NAME@@ --help' gives a list of all resources (long |
479 | options) compiled into your version. |
479 | options) compiled into your version. |
480 | |
480 | |
481 | There are two different methods that @@RXVT_NAME@@ can use to get the |
481 | You can set and change the resources using X11 tools like B<xrdb>. Many |
482 | Xresource data: using the X libraries (Xrm*-functions) or internal |
482 | distribution do also load settings from the B<~/.Xresources> file when X |
483 | Xresources reader (B<~/.Xdefaults>). For the first method (ie. |
483 | starts. @@RXVT_NAME@@ will consult the following files/resources in order, |
484 | B<@@RXVT_NAME@@ -h> lists B<XGetDefaults>), you can set and change the |
484 | with later settings overwriting earlier ones: |
485 | resources using X11 tools like B<xrdb>. Many distribution do also load |
|
|
486 | settings from the B<~/.Xresources> file when X starts. @@RXVT_NAME@@ |
|
|
487 | will consult the following files/resources in order, with later settings |
|
|
488 | overwriting earlier ones: |
|
|
489 | |
485 | |
490 | 1. system-wide app-defaults file, either locale-dependent OR global |
486 | 1. system-wide app-defaults file, either locale-dependent OR global |
491 | 2. app-defaults file in $XAPPLRESDIR |
487 | 2. app-defaults file in $XAPPLRESDIR |
492 | 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults |
488 | 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults |
493 | 4. SCREEN_RESOURCES for the current screen |
489 | 4. SCREEN_RESOURCES for the current screen |
494 | 5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename> |
490 | 5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename> |
495 | |
491 | |
496 | If compiled with internal Xresources support (i.e. B<@@RXVT_NAME@@ -h> |
|
|
497 | lists B<.Xdefaults>) then B<@@RXVT_NAME@@> accepts application defaults |
|
|
498 | set in XAPPLOADDIR/URxvt (compile-time defined: usually |
|
|
499 | B</usr/lib/X11/app-defaults/URxvt>) and resources set in |
|
|
500 | B<~/.Xdefaults>, or B<~/.Xresources> if B<~/.Xdefaults> does not exist. |
|
|
501 | Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two |
492 | Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two class |
502 | class names: B<XTerm> and B<URxvt>. The class name B<Rxvt> allows |
493 | names: B<Rxvt> and B<URxvt>. The class name B<Rxvt> allows resources |
503 | resources common to both B<@@RXVT_NAME@@> and the original I<rxvt> to be |
494 | common to both B<@@RXVT_NAME@@> and the original I<rxvt> to be easily |
504 | easily configured, while the class name B<URxvt> allows resources |
495 | configured, while the class name B<URxvt> allows resources unique to |
505 | unique to B<@@RXVT_NAME@@>, notably colours and key-handling, to be |
496 | B<@@RXVT_NAME@@>, to be shared between different B<@@RXVT_NAME@@> |
506 | shared between different B<@@RXVT_NAME@@> configurations. If no |
497 | configurations. If no resources are specified, suitable defaults will |
507 | resources are specified, suitable defaults will be used. Command-line |
498 | be used. Command-line arguments can be used to override resource |
508 | arguments can be used to override resource settings. The following |
499 | settings. The following resources are supported (you might want to |
509 | resources are allowed: |
500 | check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl |
|
|
501 | extensions not documented here): |
510 | |
502 | |
511 | =over 4 |
503 | =over 4 |
512 | |
504 | |
513 | =item B<geometry:> I<geom> |
505 | =item B<geometry:> I<geom> |
514 | |
506 | |
… | |
… | |
1015 | C<\e>, C<\E>: escape, C<\n>: newline, C<\r>: carriage return, C<\t>: tab, |
1007 | C<\e>, C<\E>: escape, C<\n>: newline, C<\r>: carriage return, C<\t>: tab, |
1016 | C<\000>: octal number) or verbatim control characters (C<^?>: delete, |
1008 | C<\000>: octal number) or verbatim control characters (C<^?>: delete, |
1017 | C<^@>: null, C<^A> ...) and may be enclosed with double quotes so that it |
1009 | C<^@>: null, C<^A> ...) and may be enclosed with double quotes so that it |
1018 | can start or end with whitespace. |
1010 | can start or end with whitespace. |
1019 | |
1011 | |
1020 | Please note that you need to double the C<\> when using |
1012 | Please note that you need to double the C<\> in resource files, as |
1021 | C<--enable-xgetdefault>, as X itself does it's own de-escaping (you can |
1013 | Xlib itself does it's own de-escaping (you can use C<\033> instead of |
1022 | use C<\033> instead of C<\e> (and so on), which will work with both Xt and |
1014 | C<\e> (and so on), which will work with both Xt and @@RXVT_NAME@@'s own |
1023 | @@RXVT_NAME@@'s own processing). |
1015 | processing). |
1024 | |
1016 | |
1025 | You can define a range of keysyms in one shot by providing a I<string> |
1017 | You can define a range of keysyms in one shot by providing a I<string> |
1026 | with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where the delimeter `/' |
1018 | with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where the delimeter `/' |
1027 | should be a character not used by the strings. |
1019 | should be a character not used by the strings. |
1028 | |
1020 | |
… | |
… | |
1088 | |
1080 | |
1089 | Comma-separated list(s) of perl extension scripts (default: C<default>) to |
1081 | Comma-separated list(s) of perl extension scripts (default: C<default>) to |
1090 | use in this terminal instance; option B<-pe>. |
1082 | use in this terminal instance; option B<-pe>. |
1091 | |
1083 | |
1092 | Extension names can be prefixed with a C<-> sign to prohibit using |
1084 | Extension names can be prefixed with a C<-> sign to prohibit using |
1093 | it. This can be useful to selectively disable some extensions loaded |
1085 | them. This can be useful to selectively disable some extensions loaded |
1094 | by default, or specified via the C<perl-ext-common> resource. For |
1086 | by default, or specified via the C<perl-ext-common> resource. For |
1095 | example, C<default,-selection> will use all the default extension except |
1087 | example, C<default,-selection> will use all the default extension except |
1096 | C<selection>. |
1088 | C<selection>. |
|
|
1089 | |
|
|
1090 | Extension names can also be followed by an argument in angle brackets |
|
|
1091 | (e.g. C<< searchable-scrollback<M-s> >>, which binds the hotkey for |
|
|
1092 | searchable scorllback to Alt/Meta-s). Mentioning the same extension |
|
|
1093 | multiple times with different arguments will pass multiple arguments to |
|
|
1094 | the extension. |
1097 | |
1095 | |
1098 | Each extension is looked up in the library directories, loaded if |
1096 | Each extension is looked up in the library directories, loaded if |
1099 | necessary, and bound to the current terminal instance. |
1097 | necessary, and bound to the current terminal instance. |
1100 | |
1098 | |
1101 | If both of these resources are the empty string, then the perl |
1099 | If both of these resources are the empty string, then the perl |
… | |
… | |
1116 | @@RXVT_NAME@@ will first look in these directories and then in |
1114 | @@RXVT_NAME@@ will first look in these directories and then in |
1117 | F<@@RXVT_LIBDIR@@/urxvt/perl/>. Due to security reasons, this resource |
1115 | F<@@RXVT_LIBDIR@@/urxvt/perl/>. Due to security reasons, this resource |
1118 | will be ignored when running setuid/setgid. |
1116 | will be ignored when running setuid/setgid. |
1119 | |
1117 | |
1120 | See the @@RXVT_NAME@@perl(3) manpage. |
1118 | See the @@RXVT_NAME@@perl(3) manpage. |
|
|
1119 | |
|
|
1120 | =item B<searchable-scrollback:> I<keysym> |
|
|
1121 | |
|
|
1122 | Sets the hotkey that starts the incremental scrollback buffer search |
|
|
1123 | (default: C<M-s>). |
|
|
1124 | |
|
|
1125 | =item B<urlLauncher>: I<string> |
|
|
1126 | |
|
|
1127 | Specifies the program to be started with a URL argument. Used by the |
|
|
1128 | C<selection-popup> and C<mark-urls> perl extensions. |
|
|
1129 | |
|
|
1130 | =item B<transient-for>: I<windowid> |
|
|
1131 | |
|
|
1132 | Sets the WM_TRANSIENT_FOR property to the given window iw. |
1121 | |
1133 | |
1122 | =back |
1134 | =back |
1123 | |
1135 | |
1124 | =head1 THE SCROLLBAR |
1136 | =head1 THE SCROLLBAR |
1125 | |
1137 | |