[ViewVC] Diff of: cvs/rxvt-unicode/doc/rxvtperl.3.txt

Comparing rxvt-unicode/doc/rxvtperl.3.txt (file contents):
Revision 1.30 by root, Wed Jan 18 09:40:53 2006 UTC vs.
Revision 1.31 by root, Thu Jan 19 19:26:31 2006 UTC

     selection-popup (enabled by default)
         Binds a popup menu to Ctrl-Button3 that lets you convert the
         selection 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 "@{ $term-"{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 $_, 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 $_.
+        The following will add an entry "a to b" that transforms all "a"s in
+        the selection to "b"s, but only if the selection currently contains
+        any "a"s:
+           push @{ $self->{term}{selection_popup_hook} }, sub {
+              /a/ ? ("a to be" => sub { s/a/b/g }
+                  : ()
+           };
     searchable-scrollback<hotkey> (enabled by default)
         Adds regex search functionality to the scrollback buffer, triggered
         by a hotkey (default: "M-s"). While in search mode, normal terminal
         input/output is suspended and a regex is displayed at the bottom of
            URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\\d+):?$/vi +$2 \\Q$1\\E\\x0d/
         And this example matches the same,but replaces it with vi-commands
         you can paste directly into your (vi :) editor:
-           URxvt.selection-autotransform.0: s/^([^:[:space:]]+(\\d+):?$/\\x1b:e \\Q$1\\E\\x0d:$2\\x0d/
+           URxvt.selection-autotransform.0: s/^([^:[:space:]]+(\\d+):?$/:e \\Q$1\\E\\x0d:$2\\x0d/
         Of course, this can be modified to suit your needs and your editor
         :)
         To expand the example above to typical perl error messages ("XXX at
         FILENAME line YYY."), you need a slightly more elaborate solution:
-           URxvt.selection.pattern-0: ( at .*? line \\d+\\.)
+           URxvt.selection.pattern-0: ( at .*? line \\d+[,.])
-           URxvt.selection-autotransform.0: s/^ at (.*?) line (\\d+)\\.$/\x1b:e \\Q$1\E\\x0d:$2\\x0d/
+           URxvt.selection-autotransform.0: s/^ at (.*?) line (\\d+)[,.]$/:e \\Q$1\E\\x0d:$2\\x0d/
         The first line tells the selection code to treat the unchanging part
         of every error message as a selection pattern, and the second line
         transforms the message into vi commands to load the file.
     mark-urls
         Uses per-line display filtering ("on_line_update") to underline urls
         and make them clickable. When middle-clicked, the program specified
         in the resource "urlLauncher" (default "x-www-browser") will be
         started with the URL as first argument.
+    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 -pixmap background.xpm -pe automove-background
     block-graphics-to-ascii
         A not very useful example of filtering all text output to the
         terminal, by replacing all line-drawing characters (U+2500 ..
         U+259F) by a similar-looking ascii character.
         size-related variables.
     on_start $term
         Called at the very end of initialisation of a new terminal, just
         before returning to the mainloop.
+    on_child_start $term, $pid
+        Called just after the child process has been "fork"ed.
+    on_child_exit $term, $status
+        Called just after the child process has exited. $status is the
+        status from "waitpid".
     on_sel_make $term, $eventtime
         Called whenever a selection has been made by the user, but before
         the selection text is copied, so changes to the beginning, end or
         type of the selection will be honored.
     on_focus_out $term
         Called wheneever the window loses keyboard focus, before
         rxvt-unicode does focus out processing.
+    on_configure_notify $term, $event
     on_key_press $term, $event, $keysym, $octets
     on_key_release $term, $event, $keysym
     on_button_press $term, $event
     on_button_release $term, $event
     on_motion_notify $term, $event
     $term->destroy
         Destroy the terminal object (close the window, free resources etc.).
         Please note that rxvt will not exit as long as any event watchers
         (timers, io watchers) are still active.
+    $term->exec_async ($cmd[, @args])
+        Works like the combination of the "fork"/"exec" builtins, which
+        executes ("starts") programs in the background. This function takes
+        care of setting the user environment before exec'ing the command
+        (e.g. "PATH") and should be preferred over explicit calls to "exec"
+        or "system".
+        Returns the pid of the subprocess or "undef" on error.
     $isset = $term->option ($optval[, $set])
         Returns true if the option specified by $optval is enabled, and
         optionally change it. All option values are stored by name in the
         hash %urxvt::OPTION. Options not enabled in this binary are not in
         the hash.
         Here is a a likely non-exhaustive list of option names, please see
         the source file /src/optinc.h to see the actual list:
          borderLess console cursorBlink cursorUnderline hold iconic insecure
          intensityStyles jumpScroll loginShell mapAlert meta8 mouseWheelScrollPage
-         pastableTabs pointerBlank reverseVideo scrollBar scrollBar_floating
+         override-redirect pastableTabs pointerBlank reverseVideo scrollBar
-         scrollBar_right scrollTtyKeypress scrollTtyOutput scrollWithBuffer
+         scrollBar_floating scrollBar_right scrollTtyKeypress scrollTtyOutput
-         secondaryScreen secondaryScroll skipBuiltinGlyphs transparent
+         scrollWithBuffer secondaryScreen secondaryScroll skipBuiltinGlyphs
-         tripleclickwords utmpInhibit visualBell
+         transparent tripleclickwords utmpInhibit visualBell
     $value = $term->resource ($name[, $newval])
         Returns the current resource value associated with a given name and
         optionally sets a new value. Setting values is most useful in the
         "init" hook. Unset resources are returned and accepted as "undef".
           answerbackstring backgroundPixmap backspace_key boldFont boldItalicFont
           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
+          italicFont jumpScroll lineSpace loginShell mapAlert meta8 modifier
-          mouseWheelScrollPage name pastableTabs path perl_eval perl_ext_1 perl_ext_2
+          mouseWheelScrollPage name override_redirect pastableTabs path perl_eval
-          perl_lib pointerBlank pointerBlankDelay preeditType print_pipe pty_fd
+          perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay
-          reverseVideo saveLines scrollBar scrollBar_align scrollBar_floating
+          preeditType print_pipe pty_fd reverseVideo saveLines scrollBar
-          scrollBar_right scrollBar_thickness scrollTtyKeypress scrollTtyOutput
+          scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness
-          scrollWithBuffer scrollstyle secondaryScreen secondaryScroll selectstyle
+          scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle
+          secondaryScreen secondaryScroll selectstyle shade term_name title
-          shade term_name title transparent transparent_all tripleclickwords
+          transient_for transparent transparent_all tripleclickwords utmpInhibit
-          utmpInhibit visualBell
+          visualBell
     $value = $term->x_resource ($pattern)
         Returns the X-Resource for the given pattern, excluding the program
         or class name, i.e. "$term->x_resource ("boldFont")" should return
         the same value as used by this instance of rxvt-unicode. Returns
         Start the timer.
     $timer = $timer->start ($tstamp)
         Set the event trigger time to $tstamp and start the timer.
+    $timer = $timer->after ($delay)
+        Like "start", but sets the expiry timer to c<urxvt::NOW + $delay>.
     $timer = $timer->stop
         Stop the timer.
   The "urxvt::iow" Class
     This class implements io watchers/events. Example:

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines
->
+Changed lines

Comparing rxvt-unicode/doc/rxvtperl.3.txt (file contents): Revision 1.30 by root, Wed Jan 18 09:40:53 2006 UTC vs. Revision 1.31 by root, Thu Jan 19 19:26:31 2006 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvtperl.3.txt (file contents):
Revision 1.30 by root, Wed Jan 18 09:40:53 2006 UTC vs.
Revision 1.31 by root, Thu Jan 19 19:26:31 2006 UTC