--- rxvt-unicode/doc/rxvt.1.pod	2006/01/02 19:36:07	1.77
+++ rxvt-unicode/doc/rxvt.1.pod	2006/01/03 18:11:34	1.82
@@ -455,9 +455,9 @@
    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
 
@@ -1024,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 @@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 +1063,27 @@
   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>: 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 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;
+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