ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/src/urxvt.pm
(Generate patch)

Comparing rxvt-unicode/src/urxvt.pm (file contents):
Revision 1.121 by root, Fri Jan 20 22:49:34 2006 UTC vs.
Revision 1.123 by root, Sat Jan 21 14:49:18 2006 UTC

… …
127bottom. C<Escape> leaves search mode and returns to the point where search 127bottom. C<Escape> leaves search mode and returns to the point where search
128was started, while C<Enter> or C<Return> stay at the current position and 128was started, while C<Enter> or C<Return> stay at the current position and
129additionally stores the first match in the current line into the primary 129additionally stores the first match in the current line into the primary
130selection. 130selection.
131 131
132=item selection-autotransform 132=item readline (enabled by default)
133
134This selection allows you to do automatic transforms on a selection
135whenever a selection is made.
136
137It works by specifying perl snippets (most useful is a single C<s///>
138operator) that modify C<$_> as resources:
139
140 URxvt.selection-autotransform.0: transform
141 URxvt.selection-autotransform.1: transform
142 ...
143
144For example, the following will transform selections of the form
145C<filename:number>, often seen in compiler messages, into C<vi +$filename
146$word>:
147
148 URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\\d+):?$/vi +$2 \\Q$1\\E\\x0d/
149
150And this example matches the same,but replaces it with vi-commands you can
151paste directly into your (vi :) editor:
152
153 URxvt.selection-autotransform.0: s/^([^:[:space:]]+(\\d+):?$/:e \\Q$1\\E\\x0d:$2\\x0d/
154
155Of course, this can be modified to suit your needs and your editor :)
156
157To expand the example above to typical perl error messages ("XXX at
158FILENAME line YYY."), you need a slightly more elaborate solution:
159
160 URxvt.selection.pattern-0: ( at .*? line \\d+[,.])
161 URxvt.selection-autotransform.0: s/^ at (.*?) line (\\d+)[,.]$/:e \\Q$1\E\\x0d:$2\\x0d/
162
163The first line tells the selection code to treat the unchanging part of
164every error message as a selection pattern, and the second line transforms
165the message into vi commands to load the file.
166
167=item readline
168 133
169A support package that tries to make editing with readline easier. At the 134A support package that tries to make editing with readline easier. At the
170moment, it reacts to clicking with the left mouse button by trying to 135moment, it reacts to clicking with the left mouse button by trying to
171move the text cursor to this position. It does so by generating as many 136move the text cursor to this position. It does so by generating as many
172cursor-left or cursor-right keypresses as required (the this only works 137cursor-left or cursor-right keypresses as required (the this only works
173for programs that correctly support wide characters). 138for programs that correctly support wide characters).
174 139
175It only works when clicking into the same line (possibly extended over 140To avoid too many false positives, this is only done when:
176multiple rows) as the text cursor and on the primary screen, to reduce the 141
177risk of misinterpreting. The normal selection isn't disabled, so quick 142=over 4
143
144=item - the mouse is on the same (multi-row-) line as the text cursor.
145
146=item - the primary screen is currently being displayed.
147
148=item - the text cursor is visible.
149
150=back
151
152The normal selection mechanism isn't disabled, so quick successive clicks
178successive clicks might interfere with selection creation in harmless 153might interfere with selection creation in harmless ways.
179ways. 154
155=item selection-autotransform
156
157This selection allows you to do automatic transforms on a selection
158whenever a selection is made.
159
160It works by specifying perl snippets (most useful is a single C<s///>
161operator) that modify C<$_> as resources:
162
163 URxvt.selection-autotransform.0: transform
164 URxvt.selection-autotransform.1: transform
165 ...
166
167For example, the following will transform selections of the form
168C<filename:number>, often seen in compiler messages, into C<vi +$filename
169$word>:
170
171 URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\\d+):?$/vi +$2 \\Q$1\\E\\x0d/
172
173And this example matches the same,but replaces it with vi-commands you can
174paste directly into your (vi :) editor:
175
176 URxvt.selection-autotransform.0: s/^([^:[:space:]]+(\\d+):?$/:e \\Q$1\\E\\x0d:$2\\x0d/
177
178Of course, this can be modified to suit your needs and your editor :)
179
180To expand the example above to typical perl error messages ("XXX at
181FILENAME line YYY."), you need a slightly more elaborate solution:
182
183 URxvt.selection.pattern-0: ( at .*? line \\d+[,.])
184 URxvt.selection-autotransform.0: s/^ at (.*?) line (\\d+)[,.]$/:e \\Q$1\E\\x0d:$2\\x0d/
185
186The first line tells the selection code to treat the unchanging part of
187every error message as a selection pattern, and the second line transforms
188the message into vi commands to load the file.
180 189
181=item tabbed 190=item tabbed
182 191
183This transforms the terminal into a tabbar with additional terminals, that 192This transforms the terminal into a tabbar with additional terminals, that
184is, it implements what is commonly refered to as "tabbed terminal". The topmost line 193is, it implements what is commonly refered to as "tabbed terminal". The topmost line
… …
769 $TERM->register_package ($_) for @pkg; 778 $TERM->register_package ($_) for @pkg;
770 } 779 }
771 780
772 for (grep $_, map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) { 781 for (grep $_, map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) {
773 if ($_ eq "default") { 782 if ($_ eq "default") {
774 $ext_arg{$_} ||= [] for qw(selection option-popup selection-popup searchable-scrollback); 783 $ext_arg{$_} ||= [] for qw(selection option-popup selection-popup searchable-scrollback readline);
775 } elsif (/^-(.*)$/) { 784 } elsif (/^-(.*)$/) {
776 delete $ext_arg{$1}; 785 delete $ext_arg{$1};
777 } elsif (/^([^<]+)<(.*)>$/) { 786 } elsif (/^([^<]+)<(.*)>$/) {
778 push @{ $ext_arg{$1} }, $2; 787 push @{ $ext_arg{$1} }, $2;
779 } else { 788 } else {
… …
1376 1385
1377=item $screen = $term->current_screen 1386=item $screen = $term->current_screen
1378 1387
1379Returns the currently displayed screen (0 primary, 1 secondary). 1388Returns the currently displayed screen (0 primary, 1 secondary).
1380 1389
1390=item $cursor_is_hidden = $term->hidden_cursor
1391
1392Returns wether the cursor is currently hidden or not.
1393
1381=item $view_start = $term->view_start ([$newvalue]) 1394=item $view_start = $term->view_start ([$newvalue])
1382 1395
1383Returns the row number of the topmost displayed line. Maximum value is 1396Returns the row number of the topmost displayed line. Maximum value is
1384C<0>, which displays the normal terminal contents. Lower values scroll 1397C<0>, which displays the normal terminal contents. Lower values scroll
1385this many lines into the scrollback buffer. 1398this many lines into the scrollback buffer.

Diff Legend

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