--- rxvt-unicode/src/urxvt.pm	2011/06/29 22:18:11	1.195
+++ rxvt-unicode/src/urxvt.pm	2012/06/05 21:06:15	1.206
@@ -261,14 +261,16 @@
 with numbered patterns, in a manner similar to the "selection" extension.
 The launcher can also be overridden on a per-pattern basis.
 
-It is possible to activate the most recently seen match from the keyboard.
-Simply bind a keysym to "perl:matcher" as seen in the example below.
+It is possible to activate the most recently seen match or a list of matches
+from the keyboard.  Simply bind a keysym to "perl:matcher:last" or
+"perl:matcher:list" as seen in the example below.
 
 Example configuration:
 
     URxvt.perl-ext:           default,matcher
     URxvt.urlLauncher:        sensible-browser
-    URxvt.keysym.C-Delete:    perl:matcher
+    URxvt.keysym.C-Delete:    perl:matcher:last
+    URxvt.keysym.M-Delete:    perl:matcher:list
     URxvt.matcher.button:     1
     URxvt.matcher.pattern.1:  \\bwww\\.[\\w-]+\\.[\\w./?&@#-]*[\\w/-]
     URxvt.matcher.pattern.2:  \\B(/\\S+?):(\\d+)(?=:|$)
@@ -400,6 +402,14 @@
 Displays a confirmation dialog when a paste containing at least a full
 line is detected.
 
+=item bell-command
+
+Runs the command specified by the C<URxvt.bell-command> resource when
+a bell event occurs. For example, the following pops up a notification
+bubble with the text "Beep, Beep" using notify-send:
+
+   URxvt.bell-command: notify-send "Beep, Beep"
+
 =back
 
 =head1 API DOCUMENTATION
@@ -438,6 +448,12 @@
 Either binary data or - more common - a text string encoded in a
 locale-specific way.
 
+=item $keysym
+
+an integer that is a valid X11 keysym code. You can convert a string
+into a keysym and viceversa by using C<XStringToKeysym> and
+C<XKeysymToString>.
+
 =back
 
 =head2 Extension Objects
@@ -658,6 +674,13 @@
 The event is simply the action string. This interface is assumed to change
 slightly in the future.
 
+=item on_register_command $term, $keysym, $modifiermask, $string
+
+Called after parsing a keysym resource but before registering the
+associated binding. If this hook returns TRUE the binding is not
+registered. It can be used to modify a binding by calling
+C<register_command>.
+
 =item on_resize_all_windows $term, $new_width, $new_height
 
 Called just after the new window size has been calculated, but before
@@ -922,6 +945,14 @@
 
 no warnings 'utf8';
 
+sub resource {
+   my ($term, $name, $isarg, $flag, $value) = @_;
+
+   warn "resourece<@_>\n";#d#
+
+   0
+}
+
 my $verbosity = $ENV{URXVT_PERL_VERBOSITY};
 
 sub verbose {
@@ -967,7 +998,7 @@
    my $htype = shift;
 
    if ($htype == 0) { # INIT
-      my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$LIBDIR/perl");
+      my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$ENV{HOME}/.urxvt/ext", "$LIBDIR/perl");
 
       my %ext_arg;
 
@@ -1209,6 +1240,7 @@
    $_[0][1]->stop;
 }
 
+# only needed for AnyEvent < 6 compatibility
 sub one_event {
    Carp::croak "AnyEvent->one_event blocking wait unsupported in urxvt, use a non-blocking API";
 }
@@ -1312,7 +1344,7 @@
 
  borderLess buffered console cursorBlink cursorUnderline hold iconic
  insecure intensityStyles iso14755 iso14755_52 jumpScroll loginShell
- mapAlert meta8 mouseWheelScrollPage override-redirect pastableTabs
+ mapAlert meta8 mouseWheelScrollPage override_redirect pastableTabs
  pointerBlank reverseVideo scrollBar scrollBar_floating scrollBar_right
  scrollTtyKeypress scrollTtyOutput scrollWithBuffer secondaryScreen
  secondaryScroll skipBuiltinGlyphs skipScroll transparent tripleclickwords
@@ -1373,11 +1405,18 @@
 only one resource database per display, and later invocations might return
 the wrong resources.
 
-=item $success = $term->parse_keysym ($keysym_spec, $command_string)
+=item $success = $term->parse_keysym ($key, $octets)
 
-Adds a keymap translation exactly as specified via a resource. See the
+Adds a key binding exactly as specified via a resource. See the
 C<keysym> resource in the @@RXVT_NAME@@(1) manpage.
 
+=item $term->register_command ($keysym, $modifiermask, $string)
+
+Adds a key binding. This is a lower level api compared to
+C<parse_keysym>, as it expects a parsed key description, and can be
+used only inside either the C<on_init> hook, to add a binding, or the
+C<on_register_command> hook, to modify a parsed binding.
+
 =item $rend = $term->rstyle ([$new_rstyle])
 
 Return and optionally change the current rendition. Text that is output by
@@ -1600,6 +1639,10 @@
 
    $term->vt_emask_add (urxvt::PointerMotionMask);
 
+=item $term->set_urgency ($set)
+
+Enable/disable the urgency hint on the toplevel window.
+
 =item $term->focus_in
 
 =item $term->focus_out
@@ -1925,6 +1968,10 @@
 
 =item $term->XChangeInput ($window, $add_events[, $del_events])
 
+=item $keysym = $term->XStringToKeysym ($string)
+
+=item $string = $term->XKeysymToString ($keysym)
+
 Various X or X-related functions. The C<$term> object only serves as
 the source of the display, otherwise those functions map more-or-less
 directly onto the X functions of the same name.