[ViewVC] Diff of: cvs/rxvt-unicode/src/urxvt.pm

Comparing rxvt-unicode/src/urxvt.pm (file contents):
Revision 1.144 by root, Mon Aug 7 15:59:44 2006 UTC vs.
Revision 1.147 by root, Tue Oct 3 11:32:20 2006 UTC

    URxvt.tabbed.tab-bg:    <colour-index, default 1>
 See I<COLOR AND GRAPHICS> in the @@RXVT_NAME@@(1) manpage for valid
 indices.
-=item mark-urls
+=item matcher
-Uses per-line display filtering (C<on_line_update>) to underline urls and
+Uses per-line display filtering (C<on_line_update>) to underline text
-make them clickable. When middle-clicked, the program specified in the
+matching a certain pattern and make it clickable. When clicked with the
-resource C<urlLauncher> (default C<x-www-browser>) will be started with
+mouse button specified in the C<matcher.button> resource (default 2, or
-the URL as first argument.
+middle), the program specified in the C<matcher.launcher> resource
+(default, the C<urlLauncher> resource, C<sensible-browser>) will be started
+with the matched text as first argument.  The default configuration is
+suitable for matching URLs and launching a web browser, like the
+former "mark-urls" extension.
+The default pattern to match URLs can be overridden with the
+C<matcher.pattern.0> resource, and additional patterns can be specified
+with numbered patterns, in a manner similar to the "selection" extension.
+The launcher can also be overridden on a per-pattern basis.
+Example configuration:
+    URxvt.perl-ext:           default,matcher
+    URxvt.urlLauncher:        sensible-browser
+    URxvt.matcher.button:     1
+    URxvt.matcher.pattern.1:  \\bwww\\.[\\w-]\\.[\\w./?&@#-]*[\\w/-]
+    URxvt.matcher.pattern.2:  \\B(/\\S+?):(\\d+)(?=:|$)
+    URxvt.matcher.launcher.2: gvim +$2 $1
 =item 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
 in the C<selection-pastebin-url> resource (again, the % is the placeholder
 for the filename):
    URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/%
+I<Note to xrdb users:> xrdb uses the C preprocessor, which might interpret
+the double C</> characters as comment start. Use C<\057\057> instead,
+which works regardless of wether xrdb is used to parse the resource file
+or not.
 =item 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.
 =back
 =head2 Extension Objects
 Every perl extension is a perl class. A separate perl object is created
-for each terminal and each extension and passed as the first parameter to
+for each terminal, and each terminal has its own set of extenion objects,
-hooks. So extensions can use their C<$self> object without having to think
+which are passed as the first parameter to hooks. So extensions can use
-about other extensions, with the exception of methods and members that
+their C<$self> object without having to think about clashes with other
+extensions or other terminals, with the exception of methods and members
-begin with an underscore character C<_>: these are reserved for internal
+that begin with an underscore character C<_>: these are reserved for
-use.
+internal use.
 Although it isn't a C<urxvt::term> object, you can call all methods of the
 C<urxvt::term> class on this object.
 It has the following methods and data members:

Diff Legend

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

Comparing rxvt-unicode/src/urxvt.pm (file contents): Revision 1.144 by root, Mon Aug 7 15:59:44 2006 UTC vs. Revision 1.147 by root, Tue Oct 3 11:32:20 2006 UTC

Diff Legend

Comparing rxvt-unicode/src/urxvt.pm (file contents):
Revision 1.144 by root, Mon Aug 7 15:59:44 2006 UTC vs.
Revision 1.147 by root, Tue Oct 3 11:32:20 2006 UTC