--- rxvt-unicode/doc/rxvt.1.pod	2005/12/31 16:06:48	1.76
+++ rxvt-unicode/doc/rxvt.1.pod	2006/01/02 21:26:05	1.80
@@ -455,6 +455,10 @@
    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 +643,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 +908,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 +923,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 +1024,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 rxvtperl(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 +1063,26 @@
   URxvt.keysym.M-C-3: command:\033[8;25;80t
   URxvt.keysym.M-C-4: command:\033[8;48;110t
 
+=item B<perl-ext>: I<string>
+
+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>.
+
+=item B<perl-eval>: I<string>
+
+Perl code to be evaluated when all extensions have been registered. See the
+rxvtperl(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 rxvtperl(3) manpage.
+
 =back
 
 =head1 THE SCROLLBAR