--- rxvt-unicode/doc/rxvtperl.3.html 2006/01/11 01:00:03 1.22 +++ rxvt-unicode/doc/rxvtperl.3.html 2006/01/12 12:10:06 1.26 @@ -87,12 +87,42 @@
--quoting-style=shell
.
+when the user extends selections (double-click and further clicks). Right
+now, it tries to select words, urls and complete shell-quoted
+arguments, which is very convenient, too, if your ls supports
+--quoting-style=shell
.
It also offers the following bindable keyboard command:
+A double-click usually selects the word under the cursor, further clicks +will enlarge the selection.
+The selection works by trying to match a number of regexes and displaying +them in increasing order of length. You can add your own regexes by +specifying resources of the form:
++ URxvt.selection.pattern-0: perl-regex + URxvt.selection.pattern-1: perl-regex + ...+
The index number (0, 1...) must not have any holes, and each regex 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: \\|([^|]+)\\|+
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 the following bindable keyboard command:
M-s
). When in search mode, normal terminal
-input/output is suspended.
+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 the
+screen.
/
starts an incremental regex search, n
searches further, p
or
-N
jump to the previous match, G
jumps to the bottom and clears the
-history, enter
leaves search mode at the current position and escape
-returns to the original position.
Inputting characters appends them to the regex and continues incremental
+search. BackSpace
removes a character from the regex, Up
and Down
+search upwards/downwards in the scrollback buffer, End
jumps to the
+bottom. Escape
leaves search mode and returns to the point where search
+was started, while Enter
or Return
stay at the current position and
+additionally stores the first match in the current line into the primary
+selection.
It works by specifying perl snippets (most useful is a single s///
+operator) that modify $_
as resources:
+ URxvt.selection-autotransform.0: transform + URxvt.selection-autotransform.1: transform + ...+
For example, the following will transform selections of the form
+filename:number
, often seen in compiler messages, into vi +$filename
+$word
:
+ URxvt.selection-autotransform.0: s/^(\\S+):(\\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/^(S+):(d+):?$/\\x1b:e \\Q$1\\E\\x0d:$2\\x0d/
on_line_update
) to underline 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.
See the selection example extension.
@@ -478,9 +551,7 @@ The current terminal. This variable stores the currenturxvt::term
object, whenever a callback/hook is executing.
urxvt
Package$rxvtname, arg...
. $envhashref
must be a reference to a %ENV>-like
-
hash which defines the environment of the new terminal.
+$rxvtname, arg...
. $envhashref
must be a reference to a %ENV
-like
+hash which defines the environment of the new terminal.
>Croaks (and probably outputs an error message) if the new instance +
Croaks (and probably outputs an error message) if the new instance
couldn't be created. Returns undef
if the new instance didn't
initialise perl, and the terminal object otherwise. The init
and
start
hooks will be called during this call.
$term->x_resource ("boldFont")
should return the
+same value as used by this instance of rxvt-unicode. Returns undef
if no
+resource with that pattern exists.
+This method should only be called during the on_start
hook, as there is
+only one resource database per display, and later invocations might return
+the wrong resources.
selection_beg
and
+selection_end
. If $rectangular
is true (default: false), a
+rectangular selection will be made. This is the prefered function to make
+a selection.
+on_sel_grab
hooks.
RS_RVid
). Useful in refresh hooks to provide effects similar
-to the selection.
+(default: RS_RVid
), which MUST NOT contain font styles. Useful in
+refresh hooks to provide effects similar to the selection.
scr_xor_span
, but xors a rectangle instead. Trailing
whitespace will additionally be xored with the $rstyle2
, which defaults
to RS_RVid | RS_Uline
, which removes reverse video again and underlines
-it instead.
+it instead. Both styles MUST NOT contain font styles.