--- rxvt-unicode/src/urxvt.pm	2006/01/18 08:33:34	1.100
+++ rxvt-unicode/src/urxvt.pm	2006/01/18 19:44:22	1.106
@@ -91,6 +91,24 @@
 text into various other formats/action (such as uri unescaping, perl
 evalution, web-browser starting etc.), depending on content.
 
+Other extensions can extend this popup menu by pushing a code reference onto
+C<@urxvt::ext::selection_popup::hook>, that is called whenever the popup is displayed.
+
+It's sole argument is the popup menu, which can be modified. The selection
+is in C<$_>, which can be used to decide wether to add something or not.
+It should either return nothing or a string and a code reference. The
+string will be used as button text and the code reference will be called
+when the button gets activated and should transform C<$_>.
+
+The following will add an entry C<a to b> that transforms all C<a>s in
+the selection to C<b>s, but only if the selection currently contains any
+C<a>s:
+
+   push urxvt::ext::selection_popup::hook, sub {
+      /a/ ? ("a to be" => sub { s/a/b/g }
+          : ()
+   };
+
 =item searchable-scrollback<hotkey> (enabled by default)
 
 Adds regex search functionality to the scrollback buffer, triggered
@@ -148,6 +166,14 @@
 resource C<urlLauncher> (default C<x-www-browser>) will be started with
 the URL as first argument.
 
+=item automove-background
+
+This is basically a one-line extension that dynamically changes the background pixmap offset
+to the window position, in effect creating the same effect as pseudo transparency with
+a custom pixmap. No scaling is supported in this mode. Exmaple:
+
+   @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background
+
 =item block-graphics-to-ascii
 
 A not very useful example of filtering all text output to the terminal,
@@ -418,6 +444,8 @@
 Called wheneever the window loses keyboard focus, before rxvt-unicode does
 focus out processing.
 
+=item on_configure_notify $term, $event
+
 =item on_key_press $term, $event, $keysym, $octets
 
 =item on_key_release $term, $event, $keysym
@@ -933,10 +961,10 @@
 
  borderLess console cursorBlink cursorUnderline hold iconic insecure
  intensityStyles jumpScroll loginShell mapAlert meta8 mouseWheelScrollPage
- pastableTabs pointerBlank reverseVideo scrollBar scrollBar_floating
- scrollBar_right scrollTtyKeypress scrollTtyOutput scrollWithBuffer
- secondaryScreen secondaryScroll skipBuiltinGlyphs transparent
- tripleclickwords utmpInhibit visualBell
+ override-redirect pastableTabs pointerBlank reverseVideo scrollBar
+ scrollBar_floating scrollBar_right scrollTtyKeypress scrollTtyOutput
+ scrollWithBuffer secondaryScreen secondaryScroll skipBuiltinGlyphs
+ transparent tripleclickwords utmpInhibit visualBell
 
 =item $value = $term->resource ($name[, $newval])
 
@@ -963,14 +991,15 @@
   borderLess color cursorBlink cursorUnderline cutchars delete_key
   display_name embed ext_bwidth fade font geometry hold iconName
   imFont imLocale inputMethod insecure int_bwidth intensityStyles
-  italicFont jumpScroll lineSpace loginShell mapAlert menu meta8 modifier
-  mouseWheelScrollPage name pastableTabs path perl_eval perl_ext_1 perl_ext_2
-  perl_lib pointerBlank pointerBlankDelay preeditType print_pipe pty_fd
-  reverseVideo saveLines scrollBar scrollBar_align scrollBar_floating
-  scrollBar_right scrollBar_thickness scrollTtyKeypress scrollTtyOutput
-  scrollWithBuffer scrollstyle secondaryScreen secondaryScroll selectstyle
-  shade term_name title transparent transparent_all tripleclickwords
-  utmpInhibit visualBell
+  italicFont jumpScroll lineSpace loginShell mapAlert meta8 modifier
+  mouseWheelScrollPage name override_redirect pastableTabs path perl_eval
+  perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay
+  preeditType print_pipe pty_fd reverseVideo saveLines scrollBar
+  scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness
+  scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle
+  secondaryScreen secondaryScroll selectstyle shade term_name title
+  transient_for transparent transparent_all tripleclickwords utmpInhibit
+  visualBell
 
 =cut
 
@@ -1572,8 +1601,10 @@
    delete $env->{LC_ALL};
    $env->{LC_CTYPE} = $self->{term}->locale;
 
-   urxvt::term->new ($env, $self->{term}->resource ("name"),
-                     "--perl-lib" => "", "--perl-ext-common" => "", "-pty-fd" => -1, "-sl" => 0, "-b" => 0,
+   urxvt::term->new ($env, "popup",
+                     "--perl-lib" => "", "--perl-ext-common" => "",
+                     "-pty-fd" => -1, "-sl" => 0,
+                     "-b" => 1, "-bd" => "grey80", "-bl", "-override-redirect",
                      "--transient-for" => $self->{term}->parent,
                      "-display" => $self->{term}->display_id,
                      "-pe" => "urxvt-popup")
@@ -1636,6 +1667,10 @@
 
 Set the event trigger time to C<$tstamp> and start the timer.
 
+=item $timer = $timer->after ($delay)
+
+Like C<start>, but sets the expiry timer to c<urxvt::NOW + $delay>.
+
 =item $timer = $timer->stop
 
 Stop the timer.