ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/src/urxvt.pm
(Generate patch)

Comparing rxvt-unicode/src/urxvt.pm (file contents):
Revision 1.130 by root, Wed Jan 25 15:32:48 2006 UTC vs.
Revision 1.131 by root, Sun Jan 29 20:51:28 2006 UTC

… …
666 666
667Using this function has the advantage that its output ends up in the 667Using this function has the advantage that its output ends up in the
668correct place, e.g. on stderr of the connecting urxvtc client. 668correct place, e.g. on stderr of the connecting urxvtc client.
669 669
670Messages have a size limit of 1023 bytes currently. 670Messages have a size limit of 1023 bytes currently.
671
672=item @terms = urxvt::termlist
673
674Returns all urxvt::term objects that exist in this process, regardless of
675wether they are started, being destroyed etc., so be careful. Only term
676objects that have perl extensions attached will be returned (because there
677is no urxvt::term objet associated with others).
671 678
672=item $time = urxvt::NOW 679=item $time = urxvt::NOW
673 680
674Returns the "current time" (as per the event loop). 681Returns the "current time" (as per the event loop).
675 682
… …
1056hash which defines the environment of the new terminal. 1063hash which defines the environment of the new terminal.
1057 1064
1058Croaks (and probably outputs an error message) if the new instance 1065Croaks (and probably outputs an error message) if the new instance
1059couldn't be created. Returns C<undef> if the new instance didn't 1066couldn't be created. Returns C<undef> if the new instance didn't
1060initialise perl, and the terminal object otherwise. The C<init> and 1067initialise perl, and the terminal object otherwise. The C<init> and
1061C<start> hooks will be called during this call. 1068C<start> hooks will be called before this call returns, and are free to
1069refer to global data (which is race free).
1062 1070
1063=cut 1071=cut
1064 1072
1065sub new { 1073sub new {
1066 my ($class, $env, @args) = @_; 1074 my ($class, $env, @args) = @_;
1067 1075
1076 $env or Carp::croak "environment hash missing in call to urxvt::term->new";
1077 @args or Carp::croak "name argument missing in call to urxvt::term->new";
1078
1068 _new ([ map "$_=$env->{$_}", keys %$env ], @args); 1079 _new ([ map "$_=$env->{$_}", keys %$env ], \@args);
1069} 1080}
1070 1081
1071=item $term->destroy 1082=item $term->destroy
1072 1083
1073Destroy the terminal object (close the window, free resources 1084Destroy the terminal object (close the window, free resources
… …
1627=item $string = $term->special_decode $text 1638=item $string = $term->special_decode $text
1628 1639
1629Converts rxvt-unicodes text reprsentation into a perl string. See 1640Converts rxvt-unicodes text reprsentation into a perl string. See
1630C<< $term->ROW_t >> for details. 1641C<< $term->ROW_t >> for details.
1631 1642
1632=item $success = $term->grab_button ($button, $modifiermask) 1643=item $success = $term->grab_button ($button, $modifiermask[, $window = $term->vt])
1633 1644
1645=item $term->ungrab_button ($button, $modifiermask[, $window = $term->vt])
1646
1634Registers a synchronous button grab. See the XGrabButton manpage. 1647Register/unregister a synchronous button grab. See the XGrabButton
1648manpage.
1635 1649
1636=item $success = $term->grab ($eventtime[, $sync]) 1650=item $success = $term->grab ($eventtime[, $sync])
1637 1651
1638Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or 1652Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or
1639synchronous (C<$sync> is true). Also remembers the grab timestampe. 1653synchronous (C<$sync> is true). Also remembers the grab timestampe.

Diff Legend

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