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

Comparing rxvt-unicode/doc/rxvtperl.3.txt (file contents):
Revision 1.35 by root, Sun Jan 22 20:39:56 2006 UTC vs.
Revision 1.37 by root, Wed Jan 25 21:48:47 2006 UTC

         must contain at least one pair of capturing parentheses, which will
         be used for the match. For example, the followign adds a regex that
         matches everything between two vertical bars:
            URxvt.selection.pattern-0: \\|([^|]+)\\|
+        Another example: Programs I use often output "absolute path: " at
+        the beginning of a line when they process multiple files. The
+        following pattern matches the filename (note, there is a single
+        space at the very end):
+           URxvt.selection.pattern-0: ^(/[^:]+):\
         You can look at the source of the selection extension to see more
         interesting uses, such as parsing a line from beginning to end.
         This extension also offers following bindable keyboard commands:
         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.
+    xim-onthespot
+        This (experimental) perl extension implements OnTheSpot editing. It
+        does not work perfectly, and some input methods don't seem to work
+        well with OnTheSpot editing in general, but it seems to work at
+        leats for SCIM and kinput2.
+        You enable it by specifying this extension and a preedit style of
+        "OnTheSpot", i.e.:
+           rxvt -pt OnTheSpot -pe xim-onthespot
     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:
         U+259F) by a similar-looking ascii character.
     digital-clock
         Displays a digital clock using the built-in overlay.
-    example-refresh-hooks
+    remote-clipboard
-        Displays a very simple digital clock in the upper right corner of
+        Somewhat of a misnomer, this extension adds two menu entries to the
-        the window. Illustrates overwriting the refresh callbacks to create
+        selection popup that allows one ti run external commands to store
-        your own overlays or changes.
+        the selection somewhere and fetch it again.
+        We use it to implement a "distributed selection mechanism", which
+        just means that one command uploads the file to a remote server, and
+        another reads it.
+        The commands can be set using the "URxvt.remote-selection.store" and
+        "URxvt.remote-selection.fetch" resources. The first should read the
+        selection to store from STDIN (always in UTF-8), the second should
+        provide the selection data on STDOUT (also in UTF-8).
+        The defaults (which are likely useless to you) use rsh and cat:
+           URxvt.remote-selection.store: rsh ruth 'cat >/tmp/distributed-selection'
+           URxvt.remote-selection.fetch: rsh ruth 'cat /tmp/distributed-selection'
     selection-pastebin
         This is a little rarely useful extension that Uploads the selection
         as textfile to a remote site (or does other things). (The
         implementation is not currently secure for use in a multiuser
         After a successful upload the selection will be replaced by the text
         given in the "selection-pastebin-url" resource (again, the % is the
         placeholder for the filename):
            URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/%
+    example-refresh-hooks
+        Displays a very simple digital clock in the upper right corner of
+        the window. Illustrates overwriting the refresh callbacks to create
+        your own overlays or changes.
 API DOCUMENTATION
   General API Considerations
     All objects (such as terminals, time watchers etc.) are typical
     reference-to-hash objects. The hash can be used to store anything you
         Called at the very end of initialisation of a new terminal, just
         before trying to map (display) the toplevel and returning to the
         mainloop.
     on_destroy $term
-        Called whenever something tries to destroy terminal, before doing
+        Called whenever something tries to destroy terminal, when the
-        anything yet. If this hook returns true, then destruction is
+        terminal is still fully functional (not for long, though).
-        skipped, but this is rarely a good idea.
     on_reset $term
         Called after the screen is "reset" for any reason, such as resizing
         or control sequences. Here is where you can react on changes to
         size-related variables.
         display code is run after this hook, and takes precedence.
     on_refresh_end $term
         Called just after the screen gets redrawn. See "on_refresh_begin".
-    on_keyboard_command $term, $string
+    on_user_command $term, $string
-        Called whenever the user presses a key combination that has a
+        Called whenever the a user-configured event is being activated (e.g.
-        "perl:string" action bound to it (see description of the keysym
+        via a "perl:string" action bound to a key, see description of the
-        resource in the rxvt(1) manpage).
+        keysym resource in the rxvt(1) manpage).
+        The event is simply the action string. This interface is assumed to
+        change slightly in the future.
     on_x_event $term, $event
         Called on every X event received on the vt window (and possibly
         other windows). Should only be used as a last resort. Most event
         structure members are not passed.

Diff Legend

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

Comparing rxvt-unicode/doc/rxvtperl.3.txt (file contents): Revision 1.35 by root, Sun Jan 22 20:39:56 2006 UTC vs. Revision 1.37 by root, Wed Jan 25 21:48:47 2006 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvtperl.3.txt (file contents):
Revision 1.35 by root, Sun Jan 22 20:39:56 2006 UTC vs.
Revision 1.37 by root, Wed Jan 25 21:48:47 2006 UTC