--- rxvt-unicode/doc/rxvt.1.pod	2006/01/02 19:36:07	1.77
+++ rxvt-unicode/doc/rxvt.1.pod	2006/01/06 05:28:55	1.86
@@ -191,22 +191,23 @@
 
 =item B<-fb> I<fontlist>
 
-Compile font-styles: The bold font list to use when bold characters are to
-be printed. See resource B<boldFont> for details.
+Compile I<font-styles>: The bold font list to use when B<bold> characters
+are to be printed. See resource B<boldFont> for details.
 
 =item B<-fi> I<fontlist>
 
-Compile font-styles: The italic font list to use when bold characters are to
-be printed. See resource B<italicFont> for details.
+Compile I<font-styles>: The italic font list to use when I<italic>
+characters are to be printed. See resource B<italicFont> for details.
 
 =item B<-fbi> I<fontlist>
 
-Compile font-styles: The bold italic font list to use when bold characters are to
-be printed. See resource B<boldItalicFont> for details.
+Compile I<font-styles>: The bold italic font list to use when B<< I<bold
+italic> >> characters are to be printed. See resource B<boldItalicFont>
+for details.
 
 =item B<-is>|B<+is>
 
-Compile font-styles: Bold/Italic font styles imply high intensity
+Compile I<font-styles>: Bold/Italic font styles imply high intensity
 foreground/background (default). See resource B<intensityStyles> for
 details.
 
@@ -298,6 +299,13 @@
 if honoured by the WM, the rxvt-unicode window will not have window
 decorations; resource B<borderLess>.
 
+=item B<-sbg>
+
+Compile I<frills>: 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<skipBuiltinGlyphs>.
+
 =item B<-lsp> I<number>
 
 Compile I<frills>: Lines (pixel height) to insert between each row of
@@ -429,7 +437,7 @@
       system "@@RXVT_NAME@@ -embed $xid &";
    });
 
-=item B<-pty-fd> I<fileno>
+=item B<-pty-fd> I<file descriptor>
 
 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<doc/pty-fd>):
 
@@ -455,9 +466,10 @@
    my $slave = $pty->slave;
    while (<$slave>) { print $slave "got <$_>\n" }
 
-=item B<-perl> I<string>
+=item B<-pe> I<string>
 
-Used by perl extension. See resource B<perl>.
+Colon-separated list of perl extension scripts to use in this terminal
+instance. See resource B<perl-ext>.
 
 =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<skipBuiltinGlyphs:> I<boolean>
+
+Compile I<frills>: 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<termName:> I<termname>
 
 Specifies the terminal type name to be set in the B<TERM> environment
@@ -1024,6 +1043,13 @@
 
   URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
 
+If I<string> takes the form C<perl:STRING>, then the specified B<STRING>
+is passed to the C<on_keyboard_command> perl handler. See the @@RXVT_NAME@@perl(3)
+manpage. For example, the F<selection> extension (activated via
+C<@@RXVT_NAME@@ -pe selection>) listens for C<selection:rot13> events:
+
+  URxvt.keysym.M-C-c: perl:selection:rot13
+
 Due the the large number of modifier combinations, a defined key mapping
 will match if at I<at least> the specified identifiers are being set, and
 no other key mappings with those and more bits are being defined. That
@@ -1056,24 +1082,31 @@
   URxvt.keysym.M-C-3: command:\033[8;25;80t
   URxvt.keysym.M-C-4: command:\033[8;48;110t
 
-=item B<perl>: I<string>
+=item B<perl-ext-common>: I<string>
+
+=item B<perl-ext>: I<string>
 
-Used by perl extension and is free for any use, as it is not interpreted
-by rxvt-unicode itself; option B<perl>.
+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<perl-ext-common> will
+be used for extensions that should be available to all instances, while
+B<perl-ext> is used for specific instances; option B<-pe>.
 
 =item B<perl-eval>: I<string>
 
-Perl code to be evaluated when all extensions have been loaded. See the
-rxvtperl(3) manpage.
+Perl code to be evaluated when all extensions have been registered. See the
+@@RXVT_NAME@@perl(3) manpage.
 
 =item B<perl-lib>: I<path>
 
-Additional directory that holds extension scripts that are loaded and
-enabled for this terminal instance, in addition to scripts stored in
-F<@@RXVT_LIBDIR@@/urxvt/perl-ext/>, which are global to all terminal
-instances.
+Colon-separated list of additional directories that hold extension
+scripts. When looking for extensions specified by the C<perl> resource,
+@@RXVT_NAME@@ will first look in these directories and then in
+F<@@RXVT_LIBDIR@@/urxvt/perl/>.
 
-See the rxvtperl(3) manpage.
+See the @@RXVT_NAME@@perl(3) manpage.
 
 =back