| … | |
… | |
| 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> |
