--- rxvt-unicode/doc/rxvt.1.pod 2006/01/09 01:36:56 1.90 +++ rxvt-unicode/doc/rxvt.1.pod 2006/01/11 23:08:54 1.93 @@ -478,14 +478,10 @@ Note: `@@RXVT_NAME@@ --help' gives a list of all resources (long options) compiled into your version. -There are two different methods that @@RXVT_NAME@@ can use to get the -Xresource data: using the X libraries (Xrm*-functions) or internal -Xresources reader (B<~/.Xdefaults>). For the first method (ie. -B<@@RXVT_NAME@@ -h> lists B), you can set and change the -resources using X11 tools like B. Many distribution do also load -settings from the B<~/.Xresources> file when X starts. @@RXVT_NAME@@ -will consult the following files/resources in order, with later settings -overwriting earlier ones: +You can set and change the resources using X11 tools like B. Many +distribution do also load settings from the B<~/.Xresources> file when X +starts. @@RXVT_NAME@@ will consult the following files/resources in order, +with later settings overwriting earlier ones: 1. system-wide app-defaults file, either locale-dependent OR global 2. app-defaults file in $XAPPLRESDIR @@ -493,20 +489,16 @@ 4. SCREEN_RESOURCES for the current screen 5. $XENVIRONMENT file OR $HOME/.Xdefaults- -If compiled with internal Xresources support (i.e. B<@@RXVT_NAME@@ -h> -lists B<.Xdefaults>) then B<@@RXVT_NAME@@> accepts application defaults -set in XAPPLOADDIR/URxvt (compile-time defined: usually -B) and resources set in -B<~/.Xdefaults>, or B<~/.Xresources> if B<~/.Xdefaults> does not exist. -Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two -class names: B and B. The class name B allows -resources common to both B<@@RXVT_NAME@@> and the original I to be -easily configured, while the class name B allows resources -unique to B<@@RXVT_NAME@@>, notably colours and key-handling, to be -shared between different B<@@RXVT_NAME@@> configurations. If no -resources are specified, suitable defaults will be used. Command-line -arguments can be used to override resource settings. The following -resources are allowed: +Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two class +names: B and B. The class name B allows resources +common to both B<@@RXVT_NAME@@> and the original I to be easily +configured, while the class name B allows resources unique to +B<@@RXVT_NAME@@>, to be shared between different B<@@RXVT_NAME@@> +configurations. If no resources are specified, suitable defaults will +be used. Command-line arguments can be used to override resource +settings. The following resources are supported (you might want to +check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl +extensions not documented here): =over 4 @@ -1017,10 +1009,10 @@ C<^@>: null, C<^A> ...) and may be enclosed with double quotes so that it can start or end with whitespace. -Please note that you need to double the C<\> when using -C<--enable-xgetdefault>, as X itself does it's own de-escaping (you can -use C<\033> instead of C<\e> (and so on), which will work with both Xt and -@@RXVT_NAME@@'s own processing). +Please note that you need to double the C<\> in resource files, as +Xlib itself does it's own de-escaping (you can use C<\033> instead of +C<\e> (and so on), which will work with both Xt and @@RXVT_NAME@@'s own +processing). You can define a range of keysyms in one shot by providing a I with pattern B, where the delimeter `/' @@ -1090,11 +1082,17 @@ use in this terminal instance; option B<-pe>. Extension names can be prefixed with a C<-> sign to prohibit using -it. This can be useful to selectively disable some extensions loaded +them. This can be useful to selectively disable some extensions loaded by default, or specified via the C resource. For example, C will use all the default extension except C. +Extension names can also be followed by an argument in angle brackets +(e.g. C<< searchable-scrollback >>, which binds the hotkey for +searchable scorllback to Alt/Meta-s). Mentioning the same extension +multiple times with different arguments will pass multiple arguments to +the extension. + Each extension is looked up in the library directories, loaded if necessary, and bound to the current terminal instance. @@ -1119,6 +1117,11 @@ See the @@RXVT_NAME@@perl(3) manpage. +=item B: I + +Specifies the program to be started with a URL argument. Used by the +C and C perl extensions. + =item B: I Sets the WM_TRANSIENT_FOR property to the given window iw.