--- rxvt-unicode/src/urxvt.pm	2006/01/03 04:20:37	1.21
+++ rxvt-unicode/src/urxvt.pm	2006/01/03 19:10:54	1.22
@@ -41,7 +41,10 @@
 
 =item selection
 
-Miscellaneous selection modifications.
+Intelligent selection. This etxension tries to be more intelligent when the user
+extends selections (double-click).
+
+It also offers the following bindable event:
 
 =over 4
 
@@ -124,6 +127,15 @@
 
 Returning a true value aborts selection grabbing. It will still be hilighted.
 
+=item on_sel_extend $term
+
+Called whenever the user tries to extend the selection (e.g. with a double
+click) and is either supposed to return false (normal operation), or
+should extend the selection itelf and return true to suppress the built-in
+processing.
+
+See the F<selection> example extension.
+
 =item on_focus_in $term
 
 Called whenever the window gets the keyboard focus, before urxvt does
@@ -463,7 +475,9 @@
 This method returns an urxvt::overlay object. The overlay will be visible
 as long as the perl object is referenced.
 
-Currently, the only method on the C<urxvt::overlay> object is C<set>:
+The methods currently supported on C<urxvt::overlay> objects are:
+
+=over 4
 
 =item $overlay->set ($x, $y, $text, $rend)
 
@@ -471,6 +485,16 @@
 text in rxvt-unicode's special encoding and an array of rendition values
 at a specific position inside the overlay.
 
+=item $overlay->hide
+
+If visible, hide the overlay, but do not destroy it.
+
+=item $overlay->show
+
+If hidden, display the overlay again.
+
+=back
+
 =item $cellwidth = $term->strwidth $string
 
 Returns the number of screen-cells this string would need. Correctly