… | |
… | |
343 | <dd> |
343 | <dd> |
344 | <p>See <em>COLOR AND GRAPHICS</em> in the <code>rxvt(1)</code> manpage for valid |
344 | <p>See <em>COLOR AND GRAPHICS</em> in the <code>rxvt(1)</code> manpage for valid |
345 | indices.</p> |
345 | indices.</p> |
346 | </dd> |
346 | </dd> |
347 | </li> |
347 | </li> |
348 | <dt><strong><a name="item_mark_2durls">mark-urls</a></strong> |
348 | <dt><strong><a name="item_matcher">matcher</a></strong> |
349 | |
349 | |
350 | <dd> |
350 | <dd> |
351 | <p>Uses per-line display filtering (<code>on_line_update</code>) to underline urls and |
351 | <p>Uses per-line display filtering (<code>on_line_update</code>) to underline text |
352 | make them clickable. When middle-clicked, the program specified in the |
352 | matching a certain pattern and make it clickable. When clicked with the |
|
|
353 | mouse button specified in the <code>matcher.button</code> resource (default 2, or |
|
|
354 | middle), the program specified in the <code>matcher.launcher</code> resource |
353 | resource <code>urlLauncher</code> (default <code>x-www-browser</code>) will be started with |
355 | (default, the <code>urlLauncher</code> resource, <code>sensible-browser</code>) will be started |
354 | the URL as first argument.</p> |
356 | with the matched text as first argument. The default configuration is |
|
|
357 | suitable for matching URLs and launching a web browser, like the |
|
|
358 | former ``mark-urls'' extension.</p> |
|
|
359 | </dd> |
|
|
360 | <dd> |
|
|
361 | <p>The default pattern to match URLs can be overridden with the |
|
|
362 | <code>matcher.pattern.0</code> resource, and additional patterns can be specified |
|
|
363 | with numbered patterns, in a manner similar to the ``selection'' extension. |
|
|
364 | The launcher can also be overridden on a per-pattern basis.</p> |
|
|
365 | </dd> |
|
|
366 | <dd> |
|
|
367 | <p>Example configuration:</p> |
|
|
368 | </dd> |
|
|
369 | <dd> |
|
|
370 | <pre> |
|
|
371 | URxvt.perl-ext: default,matcher |
|
|
372 | URxvt.urlLauncher: sensible-browser |
|
|
373 | URxvt.matcher.button: 1 |
|
|
374 | URxvt.matcher.pattern.1: \\bwww\\.[\\w-]+\\.[\\w./?&@#-]*[\\w/-] |
|
|
375 | URxvt.matcher.pattern.2: \\B(/\\S+?):(\\d+)(?=:|$) |
|
|
376 | URxvt.matcher.launcher.2: gvim +$2 $1</pre> |
355 | </dd> |
377 | </dd> |
356 | </li> |
378 | </li> |
357 | <dt><strong><a name="item_xim_2donthespot">xim-onthespot</a></strong> |
379 | <dt><strong><a name="item_xim_2donthespot">xim-onthespot</a></strong> |
358 | |
380 | |
359 | <dd> |
381 | <dd> |
… | |
… | |
488 | for the filename):</p> |
510 | for the filename):</p> |
489 | </dd> |
511 | </dd> |
490 | <dd> |
512 | <dd> |
491 | <pre> |
513 | <pre> |
492 | URxvt.selection-pastebin.url: <a href="http://www.ta-sa.org/files/txt/%">http://www.ta-sa.org/files/txt/%</a></pre> |
514 | URxvt.selection-pastebin.url: <a href="http://www.ta-sa.org/files/txt/%">http://www.ta-sa.org/files/txt/%</a></pre> |
|
|
515 | </dd> |
|
|
516 | <dd> |
|
|
517 | <p><em>Note to xrdb users:</em> xrdb uses the C preprocessor, which might interpret |
|
|
518 | the double <code>/</code> characters as comment start. Use <code>\057\057</code> instead, |
|
|
519 | which works regardless of wether xrdb is used to parse the resource file |
|
|
520 | or not.</p> |
493 | </dd> |
521 | </dd> |
494 | </li> |
522 | </li> |
495 | <dt><strong><a name="item_example_2drefresh_2dhooks">example-refresh-hooks</a></strong> |
523 | <dt><strong><a name="item_example_2drefresh_2dhooks">example-refresh-hooks</a></strong> |
496 | |
524 | |
497 | <dd> |
525 | <dd> |
… | |
… | |
545 | </dl> |
573 | </dl> |
546 | <p> |
574 | <p> |
547 | </p> |
575 | </p> |
548 | <h2><a name="extension_objects">Extension Objects</a></h2> |
576 | <h2><a name="extension_objects">Extension Objects</a></h2> |
549 | <p>Every perl extension is a perl class. A separate perl object is created |
577 | <p>Every perl extension is a perl class. A separate perl object is created |
550 | for each terminal and each extension and passed as the first parameter to |
578 | for each terminal, and each terminal has its own set of extenion objects, |
551 | hooks. So extensions can use their <code>$self</code> object without having to think |
579 | which are passed as the first parameter to hooks. So extensions can use |
552 | about other extensions, with the exception of methods and members that |
580 | their <code>$self</code> object without having to think about clashes with other |
|
|
581 | extensions or other terminals, with the exception of methods and members |
553 | begin with an underscore character <code>_</code>: these are reserved for internal |
582 | that begin with an underscore character <code>_</code>: these are reserved for |
554 | use.</p> |
583 | internal use.</p> |
555 | <p>Although it isn't a <code>urxvt::term</code> object, you can call all methods of the |
584 | <p>Although it isn't a <code>urxvt::term</code> object, you can call all methods of the |
556 | <code>urxvt::term</code> class on this object.</p> |
585 | <code>urxvt::term</code> class on this object.</p> |
557 | <p>It has the following methods and data members:</p> |
586 | <p>It has the following methods and data members:</p> |
558 | <dl> |
587 | <dl> |
559 | <dt><strong><a name="item__urxvt_term">$urxvt_term = $self->{term}</a></strong> |
588 | <dt><strong><a name="item__urxvt_term">$urxvt_term = $self->{term}</a></strong> |