--- rxvt-unicode/doc/rxvtperl.3.html 2006/01/12 12:10:06 1.26 +++ rxvt-unicode/doc/rxvtperl.3.html 2006/01/17 16:22:41 1.31 @@ -122,7 +122,7 @@ interesting uses, such as parsing a line from beginning to end.

-

This extension also offers the following bindable keyboard command:

+

This extension also offers following bindable keyboard commands:

rot13
@@ -134,6 +134,33 @@ 
    URxvt.keysym.C-M-r: perl:selection:rot13
+

+
remote-pastebin
+
+
+Upload the selection as textfile to a remote site. +
+
+
+   URxvt.keysym.C-M-e: perl:selection:remote-pastebin
+
+
+

To set the command to upload the file set this resource:

+
+
+
+   URxvt.selection-pastebin-cmd: rsync -apP % ruth:/var/www/www.ta-sa.org/files/txt/.
+
+
+

The % is the placeholder for the textfile. The name of the textfile is the hex encoded +md5 sum of the selection. +After an successful upload the selection will be replaced by the following url +(the % is the placeholder for the filename):

+
+
+
+   URxvt.selection-pastebin-url: http://www.ta-sa.org/files/txt/%
+

option-popup (enabled by default)
@@ -191,7 +218,7 @@ 
-   URxvt.selection-autotransform.0: s/^(\\S+):(\\d+):?$/vi +$2 \\Q$1\\E\\x0d/
+ 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 @@ -199,7 +226,24 @@ 

-   URxvt.selection-autotransform.0: s/^(S+):(d+):?$/\\x1b:e \\Q$1\\E\\x0d:$2\\x0d/
+ URxvt.selection-autotransform.0: s/^([^:[:space:]]+(\\d+):?$/\\x1b: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-autotransform.0: s/^ at (.*?) line (\\d+)\\.$/\x1b: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
@@ -477,6 +521,14 @@ resource in the rxvt(1) manpage).

+
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. +
+

on_focus_in $term
@@ -579,14 +631,6 @@

Messages have a size limit of 1023 bytes currently.

-
$is_safe = urxvt::safe
-
-
-Returns true when it is safe to do potentially unsafe things, such as -evaluating perl code specified by the user. This is true when urxvt was -started setuid or setgid. -
-

$time = urxvt::NOW
@@ -599,6 +643,22 @@ Mod3Mask, Mod4Mask, Mod5Mask, Button1Mask, Button2Mask, Button3Mask, Button4Mask, Button5Mask, AnyModifier
+
urxvt::NoEventMask, KeyPressMask, KeyReleaseMask, +ButtonPressMask, ButtonReleaseMask, EnterWindowMask, LeaveWindowMask, +PointerMotionMask, PointerMotionHintMask, Button1MotionMask, Button2MotionMask, +Button3MotionMask, Button4MotionMask, Button5MotionMask, ButtonMotionMask, +KeymapStateMask, ExposureMask, VisibilityChangeMask, StructureNotifyMask, +ResizeRedirectMask, SubstructureNotifyMask, SubstructureRedirectMask, +FocusChangeMask, PropertyChangeMask, ColormapChangeMask, OwnerGrabButtonMask
+
+
urxvt::KeyPress, KeyRelease, ButtonPress, ButtonRelease, MotionNotify, +EnterNotify, LeaveNotify, FocusIn, FocusOut, KeymapNotify, Expose, +GraphicsExpose, NoExpose, VisibilityNotify, CreateNotify, DestroyNotify, +UnmapNotify, MapNotify, MapRequest, ReparentNotify, ConfigureNotify, +ConfigureRequest, GravityNotify, ResizeRequest, CirculateNotify, +CirculateRequest, PropertyNotify, SelectionClear, SelectionRequest, +SelectionNotify, ColormapNotify, ClientMessage, MappingNotify
+
Various constants for use in X calls and event processing.
@@ -982,6 +1042,17 @@ Return the window id of the terminal window.

+
$term->vt_emask_add ($x_event_mask)
+
+
+Adds the specified events to the vt event mask. Useful e.g. when you want +to receive pointer events all the times: +
+
+
+   $term->vt_emask_add (urxvt::PointerMotionMask);
+
+

$window_width = $term->width
$window_height = $term->height
@@ -1004,7 +1075,7 @@
$nrow_plus_saveLines = $term->total_rows
-
$lines_in_scrollback = $term->nsaved
+
$topmost_scrollback_row = $term->top_row
Return various integers describing terminal characteristics. @@ -1043,8 +1114,8 @@
$view_start = $term->view_start ([$newvalue])
-Returns the negative row number of the topmost line. Minimum value is -0, which displays the normal terminal contents. Larger values scroll +Returns the row number of the topmost displayed line. Maximum value is +0, which displays the normal terminal contents. Lower values scroll this many lines into the scrollback buffer.

@@ -1065,7 +1136,7 @@ Returns the text of the entire row with number $row_number. Row 0 is the topmost terminal line, row $term->$ncol-1 is the bottommost terminal line. The scrollback buffer starts at line -1 and extends to -line -$term->nsaved. Nothing will be returned if a nonexistent line +line -$term->nsaved. Nothing will be returned if a nonexistent line is requested.