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.21 by root, Tue Jan 10 19:46:28 2006 UTC vs.
Revision 1.22 by root, Wed Jan 11 01:00:03 2006 UTC

483</dl> 483</dl>
484<p> 484<p>
485</p> 485</p>
486<h2><a name="functions_in_the_urxvt_package">Functions in the <code>urxvt</code> Package</a></h2> 486<h2><a name="functions_in_the_urxvt_package">Functions in the <code>urxvt</code> Package</a></h2>
487<dl> 487<dl>
488<dt><strong><a name="item__24term__3d_new_urxvt__5barg_2e_2e_2e_5d">$term = new urxvt [arg...]</a></strong><br />
489</dt>
490<dd>
491Creates a new terminal, very similar as if you had started it with
492<code>system $binfile, arg...</code>. Croaks (and probably outputs an error message)
493if the new instance couldn't be created. Returns <code>undef</code> if the new
494instance didn't initialise perl, and the terminal object otherwise. The
495<code>init</code> and <a href="#item_start"><code>start</code></a> hooks will be called during the call.
496</dd>
497<p></p>
498<dt><strong><a name="item_urxvt_3a_3afatal__24errormessage">urxvt::fatal $errormessage</a></strong><br /> 488<dt><strong><a name="item_urxvt_3a_3afatal__24errormessage">urxvt::fatal $errormessage</a></strong><br />
499</dt> 489</dt>
500<dd> 490<dd>
501Fatally aborts execution with the given error message. Avoid at all 491Fatally aborts execution with the given error message. Avoid at all
502costs! The only time this is acceptable is when the terminal process 492costs! The only time this is acceptable is when the terminal process
511that calls this function. 501that calls this function.
512</dd> 502</dd>
513<dd> 503<dd>
514<p>Using this function has the advantage that its output ends up in the 504<p>Using this function has the advantage that its output ends up in the
515correct place, e.g. on stderr of the connecting urxvtc client.</p> 505correct place, e.g. on stderr of the connecting urxvtc client.</p>
506</dd>
507<dd>
508<p>Messages have a size limit of 1023 bytes currently.</p>
516</dd> 509</dd>
517<p></p> 510<p></p>
518<dt><strong><a name="item__24is_safe__3d_urxvt_3a_3asafe">$is_safe = urxvt::safe</a></strong><br /> 511<dt><strong><a name="item__24is_safe__3d_urxvt_3a_3asafe">$is_safe = urxvt::safe</a></strong><br />
519</dt> 512</dt>
520<dd> 513<dd>
612work.</p> 605work.</p>
613<p> 606<p>
614</p> 607</p>
615<h2><a name="the_urxvt__term_class">The <code>urxvt::term</code> Class</a></h2> 608<h2><a name="the_urxvt__term_class">The <code>urxvt::term</code> Class</a></h2>
616<dl> 609<dl>
610<dt><strong><a name="item__24term__3d_new_urxvt_3a_3aterm__24envhashref_2c__">$term = new urxvt::term $envhashref, $rxvtname, [arg...]</a></strong><br />
611</dt>
612<dd>
613Creates a new terminal, very similar as if you had started it with system
614<code>$rxvtname, arg...</code>. <code>$envhashref</code> must be a reference to a %ENV&gt;-like
615<code></code>hash which defines the environment of the new terminal.
616</dd>
617<dd>
618<p>&gt;Croaks (and probably outputs an error message) if the new instance
619couldn't be created. Returns <code>undef</code> if the new instance didn't
620initialise perl, and the terminal object otherwise. The <code>init</code> and
621<a href="#item_start"><code>start</code></a> hooks will be called during this call.</p>
622</dd>
623<p></p>
617<dt><strong><a name="item_destroy">$term-&gt;destroy</a></strong><br /> 624<dt><strong><a name="item_destroy">$term-&gt;destroy</a></strong><br />
618</dt> 625</dt>
619<dd> 626<dd>
620Destroy the terminal object (close the window, free resources 627Destroy the terminal object (close the window, free resources
621etc.). Please note that rxvt will not exit as long as any event 628etc.). Please note that rxvt will not exit as long as any event
906</dt> 913</dt>
907<dd> 914<dd>
908Return various integers describing terminal characteristics. 915Return various integers describing terminal characteristics.
909</dd> 916</dd>
910<p></p> 917<p></p>
918<dt><strong><a name="item_display_id">$x_display = $term-&gt;display_id</a></strong><br />
919</dt>
920<dd>
921Return the DISPLAY used by rxvt-unicode.
922</dd>
923<p></p>
911<dt><strong><a name="item_locale">$lc_ctype = $term-&gt;locale</a></strong><br /> 924<dt><strong><a name="item_locale">$lc_ctype = $term-&gt;locale</a></strong><br />
912</dt> 925</dt>
913<dd> 926<dd>
914Returns the LC_CTYPE category string used by this rxvt-unicode. 927Returns the LC_CTYPE category string used by this rxvt-unicode.
915</dd> 928</dd>
916<p></p> 929<p></p>
917<dt><strong><a name="item_display_id">$x_display = $term-&gt;display_id</a></strong><br /> 930<dt><strong><a name="item_env">$env = $term-&gt;env</a></strong><br />
918</dt> 931</dt>
919<dd> 932<dd>
920Return the DISPLAY used by rxvt-unicode. 933Returns a copy of the environment in effect for the terminal as a hashref
934similar to <code>\%ENV</code>.
921</dd> 935</dd>
922<p></p> 936<p></p>
923<dt><strong><a name="item_modlevel3mask">$modifiermask = $term-&gt;ModLevel3Mask</a></strong><br /> 937<dt><strong><a name="item_modlevel3mask">$modifiermask = $term-&gt;ModLevel3Mask</a></strong><br />
924</dt> 938</dt>
925<dt><strong><a name="item_modmetamask">$modifiermask = $term-&gt;ModMetaMask</a></strong><br /> 939<dt><strong><a name="item_modmetamask">$modifiermask = $term-&gt;ModMetaMask</a></strong><br />

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines