--- rxvt-unicode/doc/rxvt.1.pod 2006/01/04 20:43:37 1.85 +++ rxvt-unicode/doc/rxvt.1.pod 2006/01/11 02:13:55 1.92 @@ -437,7 +437,7 @@ system "@@RXVT_NAME@@ -embed $xid &"; }); -=item B<-pty-fd> I +=item B<-pty-fd> I Tells @@RXVT_NAME@@ NOT to execute any commands or create a new pty/tty pair but instead use the given filehandle as the tty master. This is @@ -448,6 +448,9 @@ entries and will not tinker with pty/tty permissions - you have to do that yourself if you want that. +As an extremely special case, specifying C<-1> will completely suppress +pty/tty operations. + Here is a example in perl that illustrates how this option can be used (a longer example is in F): @@ -465,8 +468,8 @@ =item B<-pe> I -Colon-separated list of perl extension scripts to use in this terminal -instance. See resource B. +Comma-separated list of perl extension scripts to use (or not to use) in +this terminal instance. See resource B for details. =back @@ -1083,28 +1086,54 @@ =item B: I -Colon-separated list(s) of perl extension scripts to use in this terminal -instance. Each extension is looked up in the library directories, loaded -if necessary, and bound to the current terminal instance. If this -resource is empty or missing, then the perl interpreter will not be -initialized. The idea behind two options is that B will -be used for extensions that should be available to all instances, while -B is used for specific instances; option B<-pe>. +Comma-separated list(s) of perl extension scripts (default: C) to +use in this terminal instance; option B<-pe>. + +Extension names can be prefixed with a C<-> sign to prohibit using +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. + +If both of these resources are the empty string, then the perl +interpreter will not be initialized. The idea behind two options is that +B will be used for extensions that should be available to +all instances, while B is used for specific instances. =item B: I -Perl code to be evaluated when all extensions have been registered. See the -@@RXVT_NAME@@perl(3) manpage. +Perl code to be evaluated when all extensions have been registered. See +the @@RXVT_NAME@@perl(3) manpage. Due to security reasons, this resource +will be ignored when running setuid/setgid. =item B: I Colon-separated list of additional directories that hold extension scripts. When looking for extensions specified by the C resource, @@RXVT_NAME@@ will first look in these directories and then in -F<@@RXVT_LIBDIR@@/urxvt/perl/>. +F<@@RXVT_LIBDIR@@/urxvt/perl/>. Due to security reasons, this resource +will be ignored when running setuid/setgid. 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. + =back =head1 THE SCROLLBAR