ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvtperl.3.html
(Generate patch)

Comparing rxvt-unicode/doc/rxvtperl.3.html (file contents):
Revision 1.44 by root, Thu Jul 6 18:56:10 2006 UTC vs.
Revision 1.50 by root, Sat Feb 17 20:36:36 2007 UTC

… …
69 rxvt --perl-lib $HOME -pe grab_test</pre> 69 rxvt --perl-lib $HOME -pe grab_test</pre>
70<p> 70<p>
71</p> 71</p>
72<hr /> 72<hr />
73<h1><a name="description">DESCRIPTION</a></h1> 73<h1><a name="description">DESCRIPTION</a></h1>
74<p>Everytime a terminal object gets created, extension scripts specified via 74<p>Every time a terminal object gets created, extension scripts specified via
75the <code>perl</code> resource are loaded and associated with it.</p> 75the <code>perl</code> resource are loaded and associated with it.</p>
76<p>Scripts are compiled in a 'use strict' and 'use utf8' environment, and 76<p>Scripts are compiled in a 'use strict' and 'use utf8' environment, and
77thus must be encoded as UTF-8.</p> 77thus must be encoded as UTF-8.</p>
78<p>Each script will only ever be loaded once, even in rxvtd, where 78<p>Each script will only ever be loaded once, even in rxvtd, where
79scripts will be shared (but not enabled) for all terminals.</p> 79scripts will be shared (but not enabled) for all terminals.</p>
… …
115 ...</pre> 115 ...</pre>
116</dd> 116</dd>
117<dd> 117<dd>
118<p>The index number (0, 1...) must not have any holes, and each regex must 118<p>The index number (0, 1...) must not have any holes, and each regex must
119contain at least one pair of capturing parentheses, which will be used for 119contain at least one pair of capturing parentheses, which will be used for
120the match. For example, the followign adds a regex that matches everything 120the match. For example, the following adds a regex that matches everything
121between two vertical bars:</p> 121between two vertical bars:</p>
122</dd> 122</dd>
123<dd> 123<dd>
124<pre> 124<pre>
125 URxvt.selection.pattern-0: \\|([^|]+)\\|</pre> 125 URxvt.selection.pattern-0: \\|([^|]+)\\|</pre>
… …
194onto <code>@{ $term-</code>{selection_popup_hook} }&gt;, which gets called whenever the 194onto <code>@{ $term-</code>{selection_popup_hook} }&gt;, which gets called whenever the
195popup is being displayed.</p> 195popup is being displayed.</p>
196</dd> 196</dd>
197<dd> 197<dd>
198<p>It's sole argument is the popup menu, which can be modified. The selection 198<p>It's sole argument is the popup menu, which can be modified. The selection
199is in <code>$_</code>, which can be used to decide wether to add something or not. 199is in <code>$_</code>, which can be used to decide whether to add something or not.
200It should either return nothing or a string and a code reference. The 200It should either return nothing or a string and a code reference. The
201string will be used as button text and the code reference will be called 201string will be used as button text and the code reference will be called
202when the button gets activated and should transform <code>$_</code>.</p> 202when the button gets activated and should transform <code>$_</code>.</p>
203</dd> 203</dd>
204<dd> 204<dd>
… …
317</li> 317</li>
318<dt><strong><a name="item_tabbed">tabbed</a></strong> 318<dt><strong><a name="item_tabbed">tabbed</a></strong>
319 319
320<dd> 320<dd>
321<p>This transforms the terminal into a tabbar with additional terminals, that 321<p>This transforms the terminal into a tabbar with additional terminals, that
322is, it implements what is commonly refered to as ``tabbed terminal''. The topmost line 322is, it implements what is commonly referred to as ``tabbed terminal''. The topmost line
323displays a ``[NEW]'' button, which, when clicked, will add a new tab, followed by one 323displays a ``[NEW]'' button, which, when clicked, will add a new tab, followed by one
324button per tab.</p> 324button per tab.</p>
325</dd> 325</dd>
326<dd> 326<dd>
327<p>Clicking a button will activate that tab. Pressing <strong>Shift-Left</strong> and 327<p>Clicking a button will activate that tab. Pressing <strong>Shift-Left</strong> and
… …
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
345indices.</p> 345indices.</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
352make them clickable. When middle-clicked, the program specified in the 352matching a certain pattern and make it clickable. When clicked with the
353mouse button specified in the <code>matcher.button</code> resource (default 2, or
354middle), the program specified in the <code>matcher.launcher</code> resource
353resource <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
354the URL as first argument.</p> 356with the matched text as first argument. The default configuration is
357suitable for matching URLs and launching a web browser, like the
358former ``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
363with numbered patterns, in a manner similar to the ``selection'' extension.
364The 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.keysym.C-Delete: perl:matcher
374 URxvt.matcher.button: 1
375 URxvt.matcher.pattern.1: \\bwww\\.[\\w-]+\\.[\\w./?&amp;@#-]*[\\w/-]
376 URxvt.matcher.pattern.2: \\B(/\\S+?):(\\d+)(?=:|$)
377 URxvt.matcher.launcher.2: gvim +$2 $1</pre>
355</dd> 378</dd>
356</li> 379</li>
357<dt><strong><a name="item_xim_2donthespot">xim-onthespot</a></strong> 380<dt><strong><a name="item_xim_2donthespot">xim-onthespot</a></strong>
358 381
359<dd> 382<dd>
… …
369<dd> 392<dd>
370<pre> 393<pre>
371 rxvt -pt OnTheSpot -pe xim-onthespot</pre> 394 rxvt -pt OnTheSpot -pe xim-onthespot</pre>
372</dd> 395</dd>
373</li> 396</li>
397<dt><strong><a name="item_kuake_3chotkey_3e">kuake&lt;hotkey&gt;</a></strong>
398
399<dd>
400<p>A very primitive quake-console-like extension. It was inspired by a
401description of how the programs <code>kuake</code> and <code>yakuake</code> work: Whenever the
402user presses a global accelerator key (by default <code>F10</code>), the terminal
403will show or hide itself. Another press of the accelerator key will hide
404or show it again.</p>
405</dd>
406<dd>
407<p>Initially, the window will not be shown when using this extension.</p>
408</dd>
409<dd>
410<p>This is useful if you need a single terminal thats not using any desktop
411space most of the time but is quickly available at the press of a key.</p>
412</dd>
413<dd>
414<p>The accelerator key is grabbed regardless of any modifiers, so this
415extension will actually grab a physical key just for this function.</p>
416</dd>
417<dd>
418<p>If you want a quake-like animation, tell your window manager to do so
419(fvwm can do it).</p>
420</dd>
421</li>
374<dt><strong><a name="item_automove_2dbackground">automove-background</a></strong> 422<dt><strong><a name="item_automove_2dbackground">automove-background</a></strong>
375 423
376<dd> 424<dd>
377<p>This is basically a very small extension that dynamically changes the 425<p>This is basically a very small extension that dynamically changes the
378background pixmap offset to the window position, in effect creating the 426background pixmap offset to the window position, in effect creating the
379same effect as pseudo transparency with a custom pixmap. No scaling is 427same effect as pseudo transparency with a custom pixmap. No scaling is
380supported in this mode. Exmaple:</p> 428supported in this mode. Example:</p>
381</dd> 429</dd>
382<dd> 430<dd>
383<pre> 431<pre>
384 rxvt -pixmap background.xpm -pe automove-background</pre> 432 rxvt -pixmap background.xpm -pe automove-background</pre>
385</dd> 433</dd>
… …
463for the filename):</p> 511for the filename):</p>
464</dd> 512</dd>
465<dd> 513<dd>
466<pre> 514<pre>
467 URxvt.selection-pastebin.url: <a href="http://www.ta-sa.org/files/txt/%">http://www.ta-sa.org/files/txt/%</a></pre> 515 URxvt.selection-pastebin.url: <a href="http://www.ta-sa.org/files/txt/%">http://www.ta-sa.org/files/txt/%</a></pre>
516</dd>
517<dd>
518<p><em>Note to xrdb users:</em> xrdb uses the C preprocessor, which might interpret
519the double <code>/</code> characters as comment start. Use <code>\057\057</code> instead,
520which works regardless of wether xrdb is used to parse the resource file
521or not.</p>
468</dd> 522</dd>
469</li> 523</li>
470<dt><strong><a name="item_example_2drefresh_2dhooks">example-refresh-hooks</a></strong> 524<dt><strong><a name="item_example_2drefresh_2dhooks">example-refresh-hooks</a></strong>
471 525
472<dd> 526<dd>
… …
520</dl> 574</dl>
521<p> 575<p>
522</p> 576</p>
523<h2><a name="extension_objects">Extension Objects</a></h2> 577<h2><a name="extension_objects">Extension Objects</a></h2>
524<p>Every perl extension is a perl class. A separate perl object is created 578<p>Every perl extension is a perl class. A separate perl object is created
525for each terminal and each extension and passed as the first parameter to 579for each terminal, and each terminal has its own set of extenion objects,
526hooks. So extensions can use their <code>$self</code> object without having to think 580which are passed as the first parameter to hooks. So extensions can use
527about other extensions, with the exception of methods and members that 581their <code>$self</code> object without having to think about clashes with other
582extensions or other terminals, with the exception of methods and members
528begin with an underscore character <code>_</code>: these are reserved for internal 583that begin with an underscore character <code>_</code>: these are reserved for
529use.</p> 584internal use.</p>
530<p>Although it isn't a <code>urxvt::term</code> object, you can call all methods of the 585<p>Although it isn't a <code>urxvt::term</code> object, you can call all methods of the
531<code>urxvt::term</code> class on this object.</p> 586<code>urxvt::term</code> class on this object.</p>
532<p>It has the following methods and data members:</p> 587<p>It has the following methods and data members:</p>
533<dl> 588<dl>
534<dt><strong><a name="item__urxvt_term">$urxvt_term = $self-&gt;{term}</a></strong> 589<dt><strong><a name="item__urxvt_term">$urxvt_term = $self-&gt;{term}</a></strong>
… …
556<p> 611<p>
557</p> 612</p>
558<h2><a name="hooks">Hooks</a></h2> 613<h2><a name="hooks">Hooks</a></h2>
559<p>The following subroutines can be declared in extension files, and will be 614<p>The following subroutines can be declared in extension files, and will be
560called whenever the relevant event happens.</p> 615called whenever the relevant event happens.</p>
561<p>The first argument passed to them is an extension oject as described in 616<p>The first argument passed to them is an extension object as described in
562the in the <code>Extension Objects</code> section.</p> 617the in the <code>Extension Objects</code> section.</p>
563<p><strong>All</strong> of these hooks must return a boolean value. If any of the called 618<p><strong>All</strong> of these hooks must return a boolean value. If any of the called
564hooks returns true, then the event counts as being <em>consumed</em>, and the 619hooks returns true, then the event counts as being <em>consumed</em>, and the
565relevant action might not be carried out by the C++ code.</p> 620relevant action might not be carried out by the C++ code.</p>
566<p><em>When in doubt, return a false value (preferably <code>()</code>). </em>&gt;</p> 621<p><em>When in doubt, return a false value (preferably <code>()</code>). </em>&gt;</p>
… …
578</li> 633</li>
579<dt><strong><a name="item_on_start__24term">on_start $term</a></strong> 634<dt><strong><a name="item_on_start__24term">on_start $term</a></strong>
580 635
581<dd> 636<dd>
582<p>Called at the very end of initialisation of a new terminal, just before 637<p>Called at the very end of initialisation of a new terminal, just before
583trying to map (display) the toplevel and returning to the mainloop.</p> 638trying to map (display) the toplevel and returning to the main loop.</p>
584</dd> 639</dd>
585</li> 640</li>
586<dt><strong><a name="item_on_destroy__24term">on_destroy $term</a></strong> 641<dt><strong><a name="item_on_destroy__24term">on_destroy $term</a></strong>
587 642
588<dd> 643<dd>
… …
629<p>Called whenever a selection has been copied, but before the selection is 684<p>Called whenever a selection has been copied, but before the selection is
630requested from the server. The selection text can be queried and changed 685requested from the server. The selection text can be queried and changed
631by calling <a href="#item_selection"><code>$term-&gt;selection</code></a>.</p> 686by calling <a href="#item_selection"><code>$term-&gt;selection</code></a>.</p>
632</dd> 687</dd>
633<dd> 688<dd>
634<p>Returning a true value aborts selection grabbing. It will still be hilighted.</p> 689<p>Returning a true value aborts selection grabbing. It will still be highlighted.</p>
635</dd> 690</dd>
636</li> 691</li>
637<dt><strong><a name="item_on_sel_extend__24term">on_sel_extend $term</a></strong> 692<dt><strong><a name="item_on_sel_extend__24term">on_sel_extend $term</a></strong>
638 693
639<dd> 694<dd>
640<p>Called whenever the user tries to extend the selection (e.g. with a double 695<p>Called whenever the user tries to extend the selection (e.g. with a double
641click) and is either supposed to return false (normal operation), or 696click) and is either supposed to return false (normal operation), or
642should extend the selection itelf and return true to suppress the built-in 697should extend the selection itself and return true to suppress the built-in
643processing. This can happen multiple times, as long as the callback 698processing. This can happen multiple times, as long as the callback
644returns true, it will be called on every further click by the user and is 699returns true, it will be called on every further click by the user and is
645supposed to enlarge the selection more and more, if possible.</p> 700supposed to enlarge the selection more and more, if possible.</p>
646</dd> 701</dd>
647<dd> 702<dd>
… …
649</dd> 704</dd>
650</li> 705</li>
651<dt><strong><a name="item_on_view_change__24term_2c__24offset">on_view_change $term, $offset</a></strong> 706<dt><strong><a name="item_on_view_change__24term_2c__24offset">on_view_change $term, $offset</a></strong>
652 707
653<dd> 708<dd>
654<p>Called whenever the view offset changes, i..e the user or program 709<p>Called whenever the view offset changes, i.e. the user or program
655scrolls. Offset <code>0</code> means display the normal terminal, positive values 710scrolls. Offset <code>0</code> means display the normal terminal, positive values
656show this many lines of scrollback.</p> 711show this many lines of scrollback.</p>
657</dd> 712</dd>
658</li> 713</li>
659<dt><strong><a name="item_on_scroll_back__24term_2c__24lines_2c__24saved">on_scroll_back $term, $lines, $saved</a></strong> 714<dt><strong><a name="item_on_scroll_back__24term_2c__24lines_2c__24saved">on_scroll_back $term, $lines, $saved</a></strong>
… …
692it from commands for other extensions, and this might be enforced in the 747it from commands for other extensions, and this might be enforced in the
693future.</p> 748future.</p>
694</dd> 749</dd>
695<dd> 750<dd>
696<p>Be careful not ever to trust (in a security sense) the data you receive, 751<p>Be careful not ever to trust (in a security sense) the data you receive,
697as its source can not easily be controleld (e-mail content, messages from 752as its source can not easily be controlled (e-mail content, messages from
698other users on the same system etc.).</p> 753other users on the same system etc.).</p>
699</dd> 754</dd>
700</li> 755</li>
701<dt><strong><a name="item_on_add_lines__24term_2c__24string">on_add_lines $term, $string</a></strong> 756<dt><strong><a name="item_on_add_lines__24term_2c__24string">on_add_lines $term, $string</a></strong>
702 757
… …
749</dd> 804</dd>
750</li> 805</li>
751<dt><strong><a name="item_on_user_command__24term_2c__24string">on_user_command $term, $string</a></strong> 806<dt><strong><a name="item_on_user_command__24term_2c__24string">on_user_command $term, $string</a></strong>
752 807
753<dd> 808<dd>
754<p>Called whenever the a user-configured event is being activated (e.g. via 809<p>Called whenever a user-configured event is being activated (e.g. via
755a <code>perl:string</code> action bound to a key, see description of the <strong>keysym</strong> 810a <code>perl:string</code> action bound to a key, see description of the <strong>keysym</strong>
756resource in the <code>rxvt(1)</code> manpage).</p> 811resource in the <code>rxvt(1)</code> manpage).</p>
757</dd> 812</dd>
758<dd> 813<dd>
759<p>The event is simply the action string. This interface is assumed to change 814<p>The event is simply the action string. This interface is assumed to change
… …
761</dd> 816</dd>
762</li> 817</li>
763<dt><strong><a name="item_on_resize_all_windows__24tern_2c__24new_width_2c__">on_resize_all_windows $tern, $new_width, $new_height</a></strong> 818<dt><strong><a name="item_on_resize_all_windows__24tern_2c__24new_width_2c__">on_resize_all_windows $tern, $new_width, $new_height</a></strong>
764 819
765<dd> 820<dd>
766<p>Called just after the new window size has been calculcated, but before 821<p>Called just after the new window size has been calculated, but before
767windows are actually being resized or hints are being set. If this hook 822windows are actually being resized or hints are being set. If this hook
768returns TRUE, setting of the window hints is being skipped.</p> 823returns TRUE, setting of the window hints is being skipped.</p>
769</dd> 824</dd>
770</li> 825</li>
771<dt><strong><a name="item_on_x_event__24term_2c__24event">on_x_event $term, $event</a></strong> 826<dt><strong><a name="item_on_x_event__24term_2c__24event">on_x_event $term, $event</a></strong>
… …
774<p>Called on every X event received on the vt window (and possibly other 829<p>Called on every X event received on the vt window (and possibly other
775windows). Should only be used as a last resort. Most event structure 830windows). Should only be used as a last resort. Most event structure
776members are not passed.</p> 831members are not passed.</p>
777</dd> 832</dd>
778</li> 833</li>
834<dt><strong><a name="item_on_root_event__24term_2c__24event">on_root_event $term, $event</a></strong>
835
836<dd>
837<p>Like <code>on_x_event</code>, but is called for events on the root window.</p>
838</dd>
839</li>
779<dt><strong><a name="item_on_focus_in__24term">on_focus_in $term</a></strong> 840<dt><strong><a name="item_on_focus_in__24term">on_focus_in $term</a></strong>
780 841
781<dd> 842<dd>
782<p>Called whenever the window gets the keyboard focus, before rxvt-unicode 843<p>Called whenever the window gets the keyboard focus, before rxvt-unicode
783does focus in processing.</p> 844does focus in processing.</p>
784</dd> 845</dd>
785</li> 846</li>
786<dt><strong><a name="item_on_focus_out__24term">on_focus_out $term</a></strong> 847<dt><strong><a name="item_on_focus_out__24term">on_focus_out $term</a></strong>
787 848
788<dd> 849<dd>
789<p>Called wheneever the window loses keyboard focus, before rxvt-unicode does 850<p>Called whenever the window loses keyboard focus, before rxvt-unicode does
790focus out processing.</p> 851focus out processing.</p>
791</dd> 852</dd>
792</li> 853</li>
793<dt><strong><a name="item_on_configure_notify__24term_2c__24event">on_configure_notify $term, $event</a></strong> 854<dt><strong><a name="item_on_configure_notify__24term_2c__24event">on_configure_notify $term, $event</a></strong>
794 855
… …
868</dd> 929</dd>
869</li> 930</li>
870<dt><strong><a name="item__urxvt__term_init">@urxvt::TERM_INIT</a></strong> 931<dt><strong><a name="item__urxvt__term_init">@urxvt::TERM_INIT</a></strong>
871 932
872<dd> 933<dd>
873<p>All coderefs in this array will be called as methods of the next newly 934<p>All code references in this array will be called as methods of the next newly
874created <code>urxvt::term</code> object (during the <code>on_init</code> phase). The array 935created <code>urxvt::term</code> object (during the <code>on_init</code> phase). The array
875gets cleared before the codereferences that were in it are being executed, 936gets cleared before the code references that were in it are being executed,
876so coderefs can push themselves onto it again if they so desire.</p> 937so references can push themselves onto it again if they so desire.</p>
877</dd>
878<dd> 938</dd>
939<dd>
879<p>This complements to the perl-eval commandline option, but gets executed 940<p>This complements to the perl-eval command line option, but gets executed
880first.</p> 941first.</p>
881</dd> 942</dd>
882</li> 943</li>
883<dt><strong><a name="item__urxvt__term_ext">@urxvt::TERM_EXT</a></strong> 944<dt><strong><a name="item__urxvt__term_ext">@urxvt::TERM_EXT</a></strong>
884 945
… …
918</li> 979</li>
919<dt><strong><a name="item__terms">@terms = urxvt::termlist</a></strong> 980<dt><strong><a name="item__terms">@terms = urxvt::termlist</a></strong>
920 981
921<dd> 982<dd>
922<p>Returns all urxvt::term objects that exist in this process, regardless of 983<p>Returns all urxvt::term objects that exist in this process, regardless of
923wether they are started, being destroyed etc., so be careful. Only term 984whether they are started, being destroyed etc., so be careful. Only term
924objects that have perl extensions attached will be returned (because there 985objects that have perl extensions attached will be returned (because there
925is no urxvt::term objet associated with others).</p> 986is no urxvt::term objet associated with others).</p>
926</dd> 987</dd>
927</li> 988</li>
928<dt><strong><a name="item__time">$time = urxvt::NOW</a></strong> 989<dt><strong><a name="item__time">$time = urxvt::NOW</a></strong>
… …
1077<p>Returns true if the option specified by <code>$optval</code> is enabled, and 1138<p>Returns true if the option specified by <code>$optval</code> is enabled, and
1078optionally change it. All option values are stored by name in the hash 1139optionally change it. All option values are stored by name in the hash
1079<code>%urxvt::OPTION</code>. Options not enabled in this binary are not in the hash.</p> 1140<code>%urxvt::OPTION</code>. Options not enabled in this binary are not in the hash.</p>
1080</dd> 1141</dd>
1081<dd> 1142<dd>
1082<p>Here is a a likely non-exhaustive list of option names, please see the 1143<p>Here is a likely non-exhaustive list of option names, please see the
1083source file <em>/src/optinc.h</em> to see the actual list:</p> 1144source file <em>/src/optinc.h</em> to see the actual list:</p>
1084</dd> 1145</dd>
1085<dd> 1146<dd>
1086<pre> 1147<pre>
1087 borderLess console cursorBlink cursorUnderline hold iconic insecure 1148 borderLess console cursorBlink cursorUnderline hold iconic insecure
… …
1112<dd> 1173<dd>
1113<p>Please note that resource strings will currently only be freed when the 1174<p>Please note that resource strings will currently only be freed when the
1114terminal is destroyed, so changing options frequently will eat memory.</p> 1175terminal is destroyed, so changing options frequently will eat memory.</p>
1115</dd> 1176</dd>
1116<dd> 1177<dd>
1117<p>Here is a a likely non-exhaustive list of resource names, not all of which 1178<p>Here is a likely non-exhaustive list of resource names, not all of which
1118are supported in every build, please see the source file <em>/src/rsinc.h</em> 1179are supported in every build, please see the source file <em>/src/rsinc.h</em>
1119to see the actual list:</p> 1180to see the actual list:</p>
1120</dd> 1181</dd>
1121<dd> 1182<dd>
1122<pre> 1183<pre>
… …
1469</dd> 1530</dd>
1470</li> 1531</li>
1471<dt><strong><a name="item_hidden_cursor">$cursor_is_hidden = $term-&gt;hidden_cursor</a></strong> 1532<dt><strong><a name="item_hidden_cursor">$cursor_is_hidden = $term-&gt;hidden_cursor</a></strong>
1472 1533
1473<dd> 1534<dd>
1474<p>Returns wether the cursor is currently hidden or not.</p> 1535<p>Returns whether the cursor is currently hidden or not.</p>
1475</dd> 1536</dd>
1476</li> 1537</li>
1477<dt><strong><a name="item_view_start">$view_start = $term-&gt;view_start ([$newvalue])</a></strong> 1538<dt><strong><a name="item_view_start">$view_start = $term-&gt;view_start ([$newvalue])</a></strong>
1478 1539
1479<dd> 1540<dd>
… …
1614</dd> 1675</dd>
1615</li> 1676</li>
1616<dt><strong><a name="item_special_decode">$string = $term-&gt;special_decode $text</a></strong> 1677<dt><strong><a name="item_special_decode">$string = $term-&gt;special_decode $text</a></strong>
1617 1678
1618<dd> 1679<dd>
1619<p>Converts rxvt-unicodes text reprsentation into a perl string. See 1680<p>Converts rxvt-unicodes text representation into a perl string. See
1620<a href="#item_row_t"><code>$term-&gt;ROW_t</code></a> for details.</p> 1681<a href="#item_row_t"><code>$term-&gt;ROW_t</code></a> for details.</p>
1621</dd> 1682</dd>
1622</li> 1683</li>
1623<dt><strong><a name="item_grab_button">$success = $term-&gt;grab_button ($button, $modifiermask[, $window = $term-&gt;vt])</a></strong> 1684<dt><strong><a name="item_grab_button">$success = $term-&gt;grab_button ($button, $modifiermask[, $window = $term-&gt;vt])</a></strong>
1624 1685
… …
1631</li> 1692</li>
1632<dt><strong><a name="item_grab">$success = $term-&gt;grab ($eventtime[, $sync])</a></strong> 1693<dt><strong><a name="item_grab">$success = $term-&gt;grab ($eventtime[, $sync])</a></strong>
1633 1694
1634<dd> 1695<dd>
1635<p>Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or 1696<p>Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or
1636synchronous (<code>$sync</code> is true). Also remembers the grab timestampe.</p> 1697synchronous (<code>$sync</code> is true). Also remembers the grab timestamp.</p>
1637</dd> 1698</dd>
1638</li> 1699</li>
1639<dt><strong><a name="item_allow_events_async">$term-&gt;allow_events_async</a></strong> 1700<dt><strong><a name="item_allow_events_async">$term-&gt;allow_events_async</a></strong>
1640 1701
1641<dd> 1702<dd>
… …
1839</dd> 1900</dd>
1840</li> 1901</li>
1841<dt><strong><a name="item_fd">$iow = $iow-&gt;fd ($fd)</a></strong> 1902<dt><strong><a name="item_fd">$iow = $iow-&gt;fd ($fd)</a></strong>
1842 1903
1843<dd> 1904<dd>
1844<p>Set the filedescriptor (not handle) to watch.</p> 1905<p>Set the file descriptor (not handle) to watch.</p>
1845</dd> 1906</dd>
1846</li> 1907</li>
1847<dt><strong><a name="item_events">$iow = $iow-&gt;events ($eventmask)</a></strong> 1908<dt><strong><a name="item_events">$iow = $iow-&gt;events ($eventmask)</a></strong>
1848 1909
1849<dd> 1910<dd>
… …
1859</dd> 1920</dd>
1860</li> 1921</li>
1861<dt><strong>$iow = $iow-&gt;stop</strong> 1922<dt><strong>$iow = $iow-&gt;stop</strong>
1862 1923
1863<dd> 1924<dd>
1864<p>Stop watching for events on the given filehandle.</p> 1925<p>Stop watching for events on the given file handle.</p>
1865</dd> 1926</dd>
1866</li> 1927</li>
1867</dl> 1928</dl>
1868<p> 1929<p>
1869</p> 1930</p>
… …
1926</dd> 1987</dd>
1927</li> 1988</li>
1928<dt><strong>$pw = $timer-&gt;start ($pid)</strong> 1989<dt><strong>$pw = $timer-&gt;start ($pid)</strong>
1929 1990
1930<dd> 1991<dd>
1931<p>Tells the wqtcher to start watching for process <code>$pid</code>.</p> 1992<p>Tells the watcher to start watching for process <code>$pid</code>.</p>
1932</dd> 1993</dd>
1933</li> 1994</li>
1934<dt><strong>$pw = $pw-&gt;stop</strong> 1995<dt><strong>$pw = $pw-&gt;stop</strong>
1935 1996
1936<dd> 1997<dd>
… …
1952 2013
1953<dt><strong><a name="item__3e_3d_3__2d_script_loading_and_management">&gt;= 3 - script loading and management</a></strong> 2014<dt><strong><a name="item__3e_3d_3__2d_script_loading_and_management">&gt;= 3 - script loading and management</a></strong>
1954 2015
1955<dt><strong><a name="item__3e_3d10__2d_all_called_hooks">&gt;=10 - all called hooks</a></strong> 2016<dt><strong><a name="item__3e_3d10__2d_all_called_hooks">&gt;=10 - all called hooks</a></strong>
1956 2017
1957<dt><strong><a name="item__3e_3d11__2d_hook_reutrn_values">&gt;=11 - hook reutrn values</a></strong> 2018<dt><strong><a name="item__3e_3d11__2d_hook_return_values">&gt;=11 - hook return values</a></strong>
1958 2019
1959</dl> 2020</dl>
1960<p> 2021<p>
1961</p> 2022</p>
1962<hr /> 2023<hr />

Diff Legend

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