--- rxvt-unicode/src/perl/selection-autotransform 2011/11/20 11:09:22 1.8
+++ rxvt-unicode/src/perl/selection-autotransform 2012/06/10 17:31:53 1.11
@@ -1,5 +1,48 @@
#! perl
+#:META:X_RESOURCE:%.:string:autotransform expression
+
+=head1 NAME
+
+ selection-autotransform - automatically transform select text
+
+=head1 DESCRPIPTION
+
+This selection allows you to do automatic transforms on a selection
+whenever a selection is made.
+
+It works by specifying perl snippets (most useful is a single C
+operator) that modify C<$_> as resources:
+
+ URxvt.selection-autotransform.0: transform
+ URxvt.selection-autotransform.1: transform
+ ...
+
+For example, the following will transform selections of the form
+C, often seen in compiler messages, into C:
+
+ 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+):?$/: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+)[,.]$/: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.
+
+=cut
+
sub msg {
my ($self, $msg) = @_;
@@ -14,7 +57,7 @@
sub on_init {
my ($self) = @_;
- for (my $idx = 0; defined (my $res = $self->x_resource ("selection-autotransform.$idx")); $idx++) {
+ for (my $idx = 0; defined (my $res = $self->x_resource ("%.$idx")); $idx++) {
$res = $self->locale_decode ($res);
my $transform = eval "sub { $res }";