--- rxvt-unicode/doc/rxvt.1.pod	2005/12/31 16:06:48	1.76
+++ rxvt-unicode/doc/rxvt.1.pod	2006/01/04 05:35:34	1.84
@@ -191,18 +191,19 @@
 
 =item B<-fb> I<fontlist>
 
-Compile font-styles: The bold font list to use when bold characters are to
+Compile 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
+Compile 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 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>
 
@@ -455,6 +456,11 @@
    my $slave = $pty->slave;
    while (<$slave>) { print $slave "got <$_>\n" }
 
+=item B<-pe> I<string>
+
+Colon-separated list of perl extension scripts to use in this terminal
+instance. See resource B<perl-ext>.
+
 =back
 
 =head1 RESOURCES (available also as long-options)
@@ -639,7 +645,7 @@
 names that are used in turn when trying to display Unicode characters.
 The first font defines the cell size for characters; other fonts might
 be smaller, but not larger. A reasonable default font list is always
-appended to it. option B<-fn>.
+appended to it; option B<-fn>.
 
 Each font can either be a standard X11 core font (XLFD) name, with
 optional prefix C<x:> or a Xft font (Compile I<xft>), prefixed with C<xft:>.
@@ -904,7 +910,7 @@
 The locale to use for opening the IM. You can use an C<LC_CTYPE> of e.g.
 C<de_DE.UTF-8> for normal text processing but C<ja_JP.EUC-JP> for the
 input extension to be able to input japanese characters while staying in
-another locale. option B<-imlocale>.
+another locale; option B<-imlocale>.
 
 =item B<imFont:> I<fontset>
 
@@ -919,7 +925,7 @@
 
 Change the meaning of triple-click selection with the left mouse
 button. Instead of selecting a full line it will extend the selection to
-the end of the logical line only. option B<-tcw>.
+the end of the logical line only; option B<-tcw>.
 
 =item B<insecure:> I<boolean>
 
@@ -1020,6 +1026,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
@@ -1052,6 +1065,32 @@
   URxvt.keysym.M-C-3: command:\033[8;25;80t
   URxvt.keysym.M-C-4: command:\033[8;48;110t
 
+=item B<perl-ext-common>: I<string>
+
+=item B<perl-ext>: I<string>
+
+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 registered. See the
+@@RXVT_NAME@@perl(3) manpage.
+
+=item B<perl-lib>: I<path>
+
+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 @@RXVT_NAME@@perl(3) manpage.
+
 =back
 
 =head1 THE SCROLLBAR