… | |
… | |
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> |
|
|
491 | Creates 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) |
|
|
493 | if the new instance couldn't be created. Returns <code>undef</code> if the new |
|
|
494 | instance 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> |
501 | Fatally aborts execution with the given error message. Avoid at all |
491 | Fatally aborts execution with the given error message. Avoid at all |
502 | costs! The only time this is acceptable is when the terminal process |
492 | costs! The only time this is acceptable is when the terminal process |
… | |
… | |
511 | that calls this function. |
501 | that 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 |
515 | correct place, e.g. on stderr of the connecting urxvtc client.</p> |
505 | correct 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> |
… | |
… | |
612 | work.</p> |
605 | work.</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> |
|
|
613 | Creates 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>-like |
|
|
615 | <code></code>hash which defines the environment of the new terminal. |
|
|
616 | </dd> |
|
|
617 | <dd> |
|
|
618 | <p>>Croaks (and probably outputs an error message) if the new instance |
|
|
619 | couldn't be created. Returns <code>undef</code> if the new instance didn't |
|
|
620 | initialise 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->destroy</a></strong><br /> |
624 | <dt><strong><a name="item_destroy">$term->destroy</a></strong><br /> |
618 | </dt> |
625 | </dt> |
619 | <dd> |
626 | <dd> |
620 | Destroy the terminal object (close the window, free resources |
627 | Destroy the terminal object (close the window, free resources |
621 | etc.). Please note that rxvt will not exit as long as any event |
628 | etc.). Please note that rxvt will not exit as long as any event |
… | |
… | |
906 | </dt> |
913 | </dt> |
907 | <dd> |
914 | <dd> |
908 | Return various integers describing terminal characteristics. |
915 | Return 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->display_id</a></strong><br /> |
|
|
919 | </dt> |
|
|
920 | <dd> |
|
|
921 | Return the DISPLAY used by rxvt-unicode. |
|
|
922 | </dd> |
|
|
923 | <p></p> |
911 | <dt><strong><a name="item_locale">$lc_ctype = $term->locale</a></strong><br /> |
924 | <dt><strong><a name="item_locale">$lc_ctype = $term->locale</a></strong><br /> |
912 | </dt> |
925 | </dt> |
913 | <dd> |
926 | <dd> |
914 | Returns the LC_CTYPE category string used by this rxvt-unicode. |
927 | Returns 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->display_id</a></strong><br /> |
930 | <dt><strong><a name="item_env">$env = $term->env</a></strong><br /> |
918 | </dt> |
931 | </dt> |
919 | <dd> |
932 | <dd> |
920 | Return the DISPLAY used by rxvt-unicode. |
933 | Returns a copy of the environment in effect for the terminal as a hashref |
|
|
934 | similar to <code>\%ENV</code>. |
921 | </dd> |
935 | </dd> |
922 | <p></p> |
936 | <p></p> |
923 | <dt><strong><a name="item_modlevel3mask">$modifiermask = $term->ModLevel3Mask</a></strong><br /> |
937 | <dt><strong><a name="item_modlevel3mask">$modifiermask = $term->ModLevel3Mask</a></strong><br /> |
924 | </dt> |
938 | </dt> |
925 | <dt><strong><a name="item_modmetamask">$modifiermask = $term->ModMetaMask</a></strong><br /> |
939 | <dt><strong><a name="item_modmetamask">$modifiermask = $term->ModMetaMask</a></strong><br /> |