--- rxvt-unicode/doc/rxvt.1.pod 2006/01/02 21:41:51 1.81 +++ rxvt-unicode/doc/rxvt.1.pod 2006/01/09 01:36:56 1.90 @@ -191,22 +191,23 @@ =item B<-fb> I -Compile font-styles: The bold font list to use when bold characters are to -be printed. See resource B for details. +Compile I: The bold font list to use when B characters +are to be printed. See resource B for details. =item B<-fi> I -Compile font-styles: The italic font list to use when bold characters are to -be printed. See resource B for details. +Compile I: The italic font list to use when I +characters are to be printed. See resource B for details. =item B<-fbi> I -Compile font-styles: The bold italic font list to use when bold characters are to -be printed. See resource B for details. +Compile I: The bold italic font list to use when B<< I >> characters are to be printed. See resource B +for details. =item B<-is>|B<+is> -Compile font-styles: Bold/Italic font styles imply high intensity +Compile I: Bold/Italic font styles imply high intensity foreground/background (default). See resource B for details. @@ -298,6 +299,13 @@ if honoured by the WM, the rxvt-unicode window will not have window decorations; resource B. +=item B<-sbg> + +Compile I: Disable the usage of the built-in block graphics/line +drawing characters and just rely on what the specified fonts provide. Use +this if you have a good font and want to use its block graphic glyphs; +resource B. + =item B<-lsp> I Compile I: Lines (pixel height) to insert between each row of @@ -429,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 @@ -440,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): @@ -457,7 +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 @@ -826,6 +838,13 @@ Set MWM hints to request a borderless window, i.e. if honoured by the WM, the rxvt-unicode window will not have window decorations; option B<-bl>. +=item B I + +Compile I: Disable the usage of the built-in block graphics/line +drawing characters and just rely on what the specified fonts provide. Use +this if you have a good font and want to use its block graphic glyphs; +option B<-sbg>. + =item B I Specifies the terminal type name to be set in the B environment @@ -1063,26 +1082,47 @@ URxvt.keysym.M-C-3: command:\033[8;25;80t URxvt.keysym.M-C-4: command:\033[8;48;110t +=item B: I + =item B: I -Colon-separated list 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; 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 +it. 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. + +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 + +Sets the WM_TRANSIENT_FOR property to the given window iw. + =back =head1 THE SCROLLBAR