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.61 by root, Mon Jan 9 01:36:56 2006 UTC vs.
Revision 1.72 by root, Mon Jan 9 23:30:01 2006 UTC

65 65
66=item selection-popup (enabled by default) 66=item selection-popup (enabled by default)
67 67
68Binds a popup menu to Ctrl-Button3 that lets you convert the selection 68Binds a popup menu to Ctrl-Button3 that lets you convert the selection
69text into various other formats/action. 69text into various other formats/action.
70
71=item searchable-scrollback (enabled by default)
72
73Adds regex search functionality to the scrollback buffer, triggered by a
74hotkey (default: C<M-s>). When in search mode, terminal input/output is
75suspended, C</> starts an incremental regex search, C<n> searches further,
76C<p> jumps to the previous match. C<enter> leaves search mode at the
77current position and C<escape> returns to the original position.
70 78
71=item digital-clock 79=item digital-clock
72 80
73Displays a digital clock using the built-in overlay. 81Displays a digital clock using the built-in overlay.
74 82
124Either binary data or - more common - a text string encoded in a 132Either binary data or - more common - a text string encoded in a
125locale-specific way. 133locale-specific way.
126 134
127=back 135=back
128 136
137=head2 Extension Objects
138
139Very perl extension is a perl class. A separate perl object is created
140for each terminal and each extension and passed as the first parameter to
141hooks. So extensions can use their C<$self> object without having to think
142about other extensions, with the exception of methods and members that
143begin with an underscore character C<_>: these are reserved for internal
144use.
145
146Although it isn't a C<urxvt::term> object, you can call all methods of the
147C<urxvt::term> class on this object.
148
149It has the following methods and data members:
150
151=over 4
152
153=item $urxvt_term = $self->{term}
154
155Returns the C<urxvt::term> object associated with this instance of the
156extension. This member I<must not> be changed in any way.
157
158=item $self->enable ($hook_name => $cb, [$hook_name => $cb..])
159
160Dynamically enable the given hooks (named without the C<on_> prefix) for
161this extension, replacing any previous hook. This is useful when you want
162to overwrite time-critical hooks only temporarily.
163
164=item $self->disable ($hook_name[, $hook_name..])
165
166Dynamically disable the given hooks.
167
168=back
169
129=head2 Hooks 170=head2 Hooks
130 171
131The following subroutines can be declared in extension files, and will be 172The following subroutines can be declared in extension files, and will be
132called whenever the relevant event happens. 173called whenever the relevant event happens.
133 174
134The first argument passed to them is an object private to each terminal 175The first argument passed to them is an extension oject as described in
135and extension package. You can call all C<urxvt::term> methods on it, but 176the in the C<Extension Objects> section.
136its not a real C<urxvt::term> object. Instead, the real C<urxvt::term>
137object that is shared between all packages is stored in the C<term>
138member. It is, however, blessed intot he package of the extension script,
139so for all practical purposes you can treat an extension script as a class.
140 177
141All of them must return a boolean value. If it is true, then the event 178B<All> of these hooks must return a boolean value. If it is true, then the
142counts as being I<consumed>, and the invocation of other hooks is skipped, 179event counts as being I<consumed>, and the invocation of other hooks is
143and the relevant action might not be carried out by the C++ code. 180skipped, and the relevant action might not be carried out by the C++ code.
144 181
145When in doubt, return a false value (preferably C<()>). 182I<< When in doubt, return a false value (preferably C<()>). >>
146 183
147=over 4 184=over 4
148 185
149=item on_init $term 186=item on_init $term
150 187
226can filter/change and output the text yourself by returning a true value 263can filter/change and output the text yourself by returning a true value
227and calling C<< $term->scr_add_lines >> yourself. Please note that this 264and calling C<< $term->scr_add_lines >> yourself. Please note that this
228might be very slow, however, as your hook is called for B<all> text being 265might be very slow, however, as your hook is called for B<all> text being
229output. 266output.
230 267
268=item on_tt_write $term, $octets
269
270Called whenever some data is written to the tty/pty and can be used to
271suppress or filter tty input.
272
231=item on_line_update $term, $row 273=item on_line_update $term, $row
232 274
233Called whenever a line was updated or changed. Can be used to filter 275Called whenever a line was updated or changed. Can be used to filter
234screen output (e.g. underline urls or other useless stuff). Only lines 276screen output (e.g. underline urls or other useless stuff). Only lines
235that are being shown will be filtered, and, due to performance reasons, 277that are being shown will be filtered, and, due to performance reasons,
267=item on_focus_out $term 309=item on_focus_out $term
268 310
269Called wheneever the window loses keyboard focus, before rxvt-unicode does 311Called wheneever the window loses keyboard focus, before rxvt-unicode does
270focus out processing. 312focus out processing.
271 313
272=item on_key_press $term, $event, $octets 314=item on_key_press $term, $event, $keysym, $octets
273 315
274=item on_key_release $term, $event 316=item on_key_release $term, $event, $keysym
275 317
276=item on_button_press $term, $event 318=item on_button_press $term, $event
277 319
278=item on_button_release $term, $event 320=item on_button_release $term, $event
279 321
333that calls this function. 375that calls this function.
334 376
335Using this function has the advantage that its output ends up in the 377Using this function has the advantage that its output ends up in the
336correct place, e.g. on stderr of the connecting urxvtc client. 378correct place, e.g. on stderr of the connecting urxvtc client.
337 379
380=item $is_safe = urxvt::safe
381
382Returns true when it is safe to do potentially unsafe things, such as
383evaluating perl code specified by the user. This is true when urxvt was
384started setuid or setgid.
385
338=item $time = urxvt::NOW 386=item $time = urxvt::NOW
339 387
340Returns the "current time" (as per the event loop). 388Returns the "current time" (as per the event loop).
341 389
342=item urxvt::CurrentTime 390=item urxvt::CurrentTime
405 453
406package urxvt; 454package urxvt;
407 455
408use utf8; 456use utf8;
409use strict; 457use strict;
458use Carp ();
410use Scalar::Util (); 459use Scalar::Util ();
411use List::Util (); 460use List::Util ();
412 461
413our $VERSION = 1; 462our $VERSION = 1;
414our $TERM; 463our $TERM;
415our @HOOKNAME; 464our @HOOKNAME;
465our %HOOKTYPE = map +($HOOKNAME[$_] => $_), 0..$#HOOKNAME;
416our %OPTION; 466our %OPTION;
417our $LIBDIR; 467our $LIBDIR;
418 468
419BEGIN { 469BEGIN {
420 urxvt->bootstrap; 470 urxvt->bootstrap;
439sub verbose { 489sub verbose {
440 my ($level, $msg) = @_; 490 my ($level, $msg) = @_;
441 warn "$msg\n" if $level <= $verbosity; 491 warn "$msg\n" if $level <= $verbosity;
442} 492}
443 493
444# find on_xxx subs in the package and register them
445# as hooks
446sub register_package($) {
447 my ($pkg) = @_;
448
449 for my $htype (0.. $#HOOKNAME) {
450 my $name = $HOOKNAME[$htype];
451
452 my $ref = $pkg->can ("on_" . lc $name)
453 or next;
454
455 $TERM->{_hook}[$htype]{$pkg} = $ref;
456 $hook_count[$htype]++
457 or set_should_invoke $htype, 1;
458 }
459}
460
461my $extension_pkg = "extension0000"; 494my $extension_pkg = "extension0000";
462my %extension_pkg; 495my %extension_pkg;
463 496
464# load a single script into its own package, once only 497# load a single script into its own package, once only
465sub extension_package($) { 498sub extension_package($) {
471 verbose 3, "loading extension '$path' into package '$pkg'"; 504 verbose 3, "loading extension '$path' into package '$pkg'";
472 505
473 open my $fh, "<:raw", $path 506 open my $fh, "<:raw", $path
474 or die "$path: $!"; 507 or die "$path: $!";
475 508
509 my $source = untaint
476 my $source = untaint "package $pkg; use strict; use utf8;\n" 510 "package $pkg; use strict; use utf8;\n"
477 . "use base urxvt::term::proxy::;\n" 511 . "use base urxvt::term::extension::;\n"
478 . "#line 1 \"$path\"\n{\n" 512 . "#line 1 \"$path\"\n{\n"
479 . (do { local $/; <$fh> }) 513 . (do { local $/; <$fh> })
480 . "\n};\n1"; 514 . "\n};\n1";
481 515
516 eval $source
482 eval $source or die "$path: $@"; 517 or die "$path: $@";
483 518
484 $pkg 519 $pkg
485 } 520 }
486} 521}
487 522
493 my $htype = shift; 528 my $htype = shift;
494 529
495 if ($htype == 0) { # INIT 530 if ($htype == 0) { # INIT
496 my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$LIBDIR/perl"); 531 my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$LIBDIR/perl");
497 532
498 my %want_ext; 533 my %ext_arg;
499 534
500 for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) { 535 for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) {
501 if ($_ eq "default") { 536 if ($_ eq "default") {
502 $want_ext{$_}++ for qw(selection option-popup selection-popup); 537 $ext_arg{$_} ||= [] for qw(selection option-popup selection-popup searchable-scrollback);
503 } elsif (/^-(.*)$/) { 538 } elsif (/^-(.*)$/) {
504 delete $want_ext{$1}; 539 delete $ext_arg{$1};
540 } elsif (/^([^<]+)<(.*)>$/) {
541 push @{ $ext_arg{$1} }, $2;
505 } else { 542 } else {
506 $want_ext{$_}++; 543 $ext_arg{$_} ||= [];
507 } 544 }
508 } 545 }
509 546
510 for my $ext (keys %want_ext) { 547 while (my ($ext, $argv) = each %ext_arg) {
511 my @files = grep -f $_, map "$_/$ext", @dirs; 548 my @files = grep -f $_, map "$_/$ext", @dirs;
512 549
513 if (@files) { 550 if (@files) {
514 register_package extension_package $files[0]; 551 $TERM->register_package (extension_package $files[0], $argv);
515 } else { 552 } else {
516 warn "perl extension '$ext' not found in perl library search path\n"; 553 warn "perl extension '$ext' not found in perl library search path\n";
517 } 554 }
518 } 555 }
519 556
528 if $verbosity >= 10; 565 if $verbosity >= 10;
529 566
530 keys %$cb; 567 keys %$cb;
531 568
532 while (my ($pkg, $cb) = each %$cb) { 569 while (my ($pkg, $cb) = each %$cb) {
533 eval { 570 $retval = eval { $cb->($TERM->{_pkg}{$pkg}, @_) }
534 $retval = $cb->(
535 $TERM->{_pkg}{$pkg} ||= do {
536 my $proxy = bless { }, $pkg;
537 Scalar::Util::weaken ($proxy->{term} = $TERM);
538 $proxy
539 },
540 @_,
541 ) and last; 571 and last;
542 }; 572
543 if ($@) { 573 if ($@) {
544 $TERM->ungrab; # better to lose the grab than the session 574 $TERM->ungrab; # better to lose the grab than the session
545 warn $@; 575 warn $@;
546 } 576 }
547 } 577 }
548 } 578 }
549 579
550 if ($htype == 1) { # DESTROY 580 if ($htype == 1) { # DESTROY
551 # remove hooks if unused
552 if (my $hook = $TERM->{_hook}) { 581 if (my $hook = delete $TERM->{_hook}) {
553 for my $htype (0..$#$hook) { 582 for my $htype (0..$#$hook) {
554 $hook_count[$htype] -= scalar keys %{ $hook->[$htype] || {} } 583 $hook_count[$htype] -= scalar keys %{ $hook->[$htype] || {} }
555 or set_should_invoke $htype, 0; 584 or set_should_invoke $htype, 0;
556 } 585 }
557 } 586 }
564 } 593 }
565 594
566 $retval 595 $retval
567} 596}
568 597
569# urxvt::term::proxy 598# urxvt::term::extension
570 599
571sub urxvt::term::proxy::AUTOLOAD { 600package urxvt::term::extension;
572 $urxvt::term::proxy::AUTOLOAD =~ /:([^:]+)$/ 601
602sub enable {
603 my ($self, %hook) = @_;
604 my $pkg = $self->{_pkg};
605
606 while (my ($name, $cb) = each %hook) {
607 my $htype = $HOOKTYPE{uc $name};
608 defined $htype
609 or Carp::croak "unsupported hook type '$name'";
610
611 unless (exists $self->{term}{_hook}[$htype]{$pkg}) {
612 $hook_count[$htype]++
613 or urxvt::set_should_invoke $htype, 1;
614 }
615
616 $self->{term}{_hook}[$htype]{$pkg} = $cb;
617 }
618}
619
620sub disable {
621 my ($self, @hook) = @_;
622 my $pkg = $self->{_pkg};
623
624 for my $name (@hook) {
625 my $htype = $HOOKTYPE{uc $name};
626 defined $htype
627 or Carp::croak "unsupported hook type '$name'";
628
629 if (delete $self->{term}{_hook}[$htype]{$pkg}) {
630 --$hook_count[$htype]
631 or urxvt::set_should_invoke $htype, 0;
632 }
633 }
634}
635
636our $AUTOLOAD;
637
638sub AUTOLOAD {
639 $AUTOLOAD =~ /:([^:]+)$/
573 or die "FATAL: \$AUTOLOAD '$urxvt::term::proxy::AUTOLOAD' unparsable"; 640 or die "FATAL: \$AUTOLOAD '$AUTOLOAD' unparsable";
574 641
575 eval qq{ 642 eval qq{
576 sub $urxvt::term::proxy::AUTOLOAD { 643 sub $AUTOLOAD {
577 my \$proxy = shift; 644 my \$proxy = shift;
578 \$proxy->{term}->$1 (\@_) 645 \$proxy->{term}->$1 (\@_)
579 } 646 }
580 1 647 1
581 } or die "FATAL: unable to compile method forwarder: $@"; 648 } or die "FATAL: unable to compile method forwarder: $@";
582 649
583 goto &$urxvt::term::proxy::AUTOLOAD; 650 goto &$AUTOLOAD;
584} 651}
585 652
586sub urxvt::term::proxy::DESTROY { 653sub DESTROY {
587 # nop 654 # nop
588} 655}
589 656
590# urxvt::destroy_hook 657# urxvt::destroy_hook
591 658
658 ${$_[0]}++; 725 ${$_[0]}++;
659} 726}
660 727
661sub urxvt::anyevent::condvar::wait { 728sub urxvt::anyevent::condvar::wait {
662 unless (${$_[0]}) { 729 unless (${$_[0]}) {
663 require Carp;
664 Carp::croak ("AnyEvent->condvar blocking wait unsupported in urxvt, use a non-blocking API"); 730 Carp::croak "AnyEvent->condvar blocking wait unsupported in urxvt, use a non-blocking API";
665 } 731 }
666} 732}
667 733
668package urxvt::term; 734package urxvt::term;
669 735
670=head2 The C<urxvt::term> Class 736=head2 The C<urxvt::term> Class
671 737
672=over 4 738=over 4
739
740=cut
741
742# find on_xxx subs in the package and register them
743# as hooks
744sub register_package {
745 my ($self, $pkg, $argv) = @_;
746
747 my $proxy = bless {
748 _pkg => $pkg,
749 argv => $argv,
750 }, $pkg;
751 Scalar::Util::weaken ($proxy->{term} = $self);
752
753 $self->{_pkg}{$pkg} = $proxy;
754
755 for my $name (@HOOKNAME) {
756 if (my $ref = $pkg->can ("on_" . lc $name)) {
757 $proxy->enable ($name => $ref);
758 }
759 }
760}
673 761
674=item $term->destroy 762=item $term->destroy
675 763
676Destroy the terminal object (close the window, free resources etc.). 764Destroy the terminal object (close the window, free resources etc.).
677 765
731 my ($self, $name) = (shift, shift); 819 my ($self, $name) = (shift, shift);
732 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0); 820 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0);
733 &urxvt::term::_resource 821 &urxvt::term::_resource
734} 822}
735 823
824=item $success = $term->parse_keysym ($keysym_spec, $command_string)
825
826Adds a keymap translation exactly as specified via a resource. See the
827C<keysym> resource in the @@RXVT_NAME@@(1) manpage.
828
736=item $rend = $term->rstyle ([$new_rstyle]) 829=item $rend = $term->rstyle ([$new_rstyle])
737 830
738Return and optionally change the current rendition. Text that is output by 831Return and optionally change the current rendition. Text that is output by
739the terminal application will use this style. 832the terminal application will use this style.
740 833
759 852
760=item $oldtext = $term->selection ([$newtext]) 853=item $oldtext = $term->selection ([$newtext])
761 854
762Return the current selection text and optionally replace it by C<$newtext>. 855Return the current selection text and optionally replace it by C<$newtext>.
763 856
764#=item $term->overlay ($x, $y, $text) 857=item $term->overlay_simple ($x, $y, $text)
765# 858
766#Create a simple multi-line overlay box. See the next method for details. 859Create a simple multi-line overlay box. See the next method for details.
767# 860
768#=cut 861=cut
769# 862
770#sub urxvt::term::scr_overlay { 863sub overlay_simple {
771# my ($self, $x, $y, $text) = @_; 864 my ($self, $x, $y, $text) = @_;
772# 865
773# my @lines = split /\n/, $text; 866 my @lines = split /\n/, $text;
774# 867
775# my $w = 0; 868 my $w = List::Util::max map $self->strwidth ($_), @lines;
776# for (map $self->strwidth ($_), @lines) { 869
777# $w = $_ if $w < $_;
778# }
779#
780# $self->scr_overlay_new ($x, $y, $w, scalar @lines); 870 my $overlay = $self->overlay ($x, $y, $w, scalar @lines);
781# $self->scr_overlay_set (0, $_, $lines[$_]) for 0.. $#lines; 871 $overlay->set (0, $_, $lines[$_]) for 0.. $#lines;
782#} 872
873 $overlay
874}
783 875
784=item $term->overlay ($x, $y, $width, $height[, $rstyle[, $border]]) 876=item $term->overlay ($x, $y, $width, $height[, $rstyle[, $border]])
785 877
786Create a new (empty) overlay at the given position with the given 878Create a new (empty) overlay at the given position with the given
787width/height. C<$rstyle> defines the initial rendition style 879width/height. C<$rstyle> defines the initial rendition style
854 946
855=item $string = $term->locale_decode ($octets) 947=item $string = $term->locale_decode ($octets)
856 948
857Convert the given locale-encoded octets into a perl string. 949Convert the given locale-encoded octets into a perl string.
858 950
951=item $term->scr_xor_span ($beg_row, $beg_col, $end_row, $end_col[, $rstyle])
952
953XORs the rendition values in the given span with the provided value
954(default: C<RS_RVid>). Useful in refresh hooks to provide effects similar
955to the selection.
956
957=item $term->scr_xor_rect ($beg_row, $beg_col, $end_row, $end_col[, $rstyle1[, $rstyle2]])
958
959Similar to C<scr_xor_span>, but xors a rectangle instead. Trailing
960whitespace will additionally be xored with the C<$rstyle2>, which defaults
961to C<RS_RVid | RS_Uline>, which removes reverse video again and underlines
962it instead.
963
964=item $term->scr_bell
965
966Ring the bell!
967
859=item $term->scr_add_lines ($string) 968=item $term->scr_add_lines ($string)
860 969
861Write the given text string to the screen, as if output by the application 970Write the given text string to the screen, as if output by the application
862running inside the terminal. It may not contain command sequences (escape 971running inside the terminal. It may not contain command sequences (escape
863codes), but is free to use line feeds, carriage returns and tabs. The 972codes), but is free to use line feeds, carriage returns and tabs. The
877 986
878Write the octets given in C<$data> to the tty (i.e. as program input). To 987Write the octets given in C<$data> to the tty (i.e. as program input). To
879pass characters instead of octets, you should convert your strings first 988pass characters instead of octets, you should convert your strings first
880to the locale-specific encoding using C<< $term->locale_encode >>. 989to the locale-specific encoding using C<< $term->locale_encode >>.
881 990
991=item $old_events = $term->pty_ev_events ([$new_events])
992
993Replaces the event mask of the pty watcher by the given event mask. Can
994be used to suppress input and output handling to the pty/tty. See the
995description of C<< urxvt::timer->events >>. Make sure to always restore
996the previous value.
997
882=item $windowid = $term->parent 998=item $windowid = $term->parent
883 999
884Return the window id of the toplevel window. 1000Return the window id of the toplevel window.
885 1001
886=item $windowid = $term->vt 1002=item $windowid = $term->vt
910=item $nrow_plus_saveLines = $term->total_rows 1026=item $nrow_plus_saveLines = $term->total_rows
911 1027
912=item $lines_in_scrollback = $term->nsaved 1028=item $lines_in_scrollback = $term->nsaved
913 1029
914Return various integers describing terminal characteristics. 1030Return various integers describing terminal characteristics.
1031
1032=item $lc_ctype = $term->locale
1033
1034Returns the LC_CTYPE category string used by this rxvt-unicode.
1035
1036=item $x_display = $term->display_id
1037
1038Return the DISPLAY used by rxvt-unicode.
915 1039
916=item $modifiermask = $term->ModLevel3Mask 1040=item $modifiermask = $term->ModLevel3Mask
917 1041
918=item $modifiermask = $term->ModMetaMask 1042=item $modifiermask = $term->ModMetaMask
919 1043
1109Converts rxvt-unicodes text reprsentation into a perl string. See 1233Converts rxvt-unicodes text reprsentation into a perl string. See
1110C<< $term->ROW_t >> for details. 1234C<< $term->ROW_t >> for details.
1111 1235
1112=item $success = $term->grab_button ($button, $modifiermask) 1236=item $success = $term->grab_button ($button, $modifiermask)
1113 1237
1114Registers a synchronous button grab. See XGrabButton. 1238Registers a synchronous button grab. See the XGrabButton manpage.
1115 1239
1116=item $success = $term->grab ($eventtime[, $sync]) 1240=item $success = $term->grab ($eventtime[, $sync])
1117 1241
1118Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or 1242Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or
1119synchronous (C<$sync> is true). Also remembers the grab timestampe. 1243synchronous (C<$sync> is true). Also remembers the grab timestampe.
1162} 1286}
1163 1287
1164sub add_separator { 1288sub add_separator {
1165 my ($self, $sep) = @_; 1289 my ($self, $sep) = @_;
1166 1290
1167 $sep ||= ""; 1291 $sep ||= "=";
1168 1292
1169 $self->add_item ({ 1293 $self->add_item ({
1170 rend => { normal => "\x1b[0;30;47m", hover => "\x1b[0;30;47m", active => "\x1b[0;30;47m" }, 1294 rend => { normal => "\x1b[0;30;47m", hover => "\x1b[0;30;47m", active => "\x1b[0;30;47m" },
1171 text => "", 1295 text => "",
1172 render => sub { $sep x $urxvt::TERM->ncol }, 1296 render => sub { $sep x $self->{term}->ncol },
1173 activate => sub { }, 1297 activate => sub { },
1174 }); 1298 });
1175} 1299}
1176 1300
1177sub add_title { 1301sub add_title {
1185} 1309}
1186 1310
1187sub add_button { 1311sub add_button {
1188 my ($self, $text, $cb) = @_; 1312 my ($self, $text, $cb) = @_;
1189 1313
1190 $self->add_item ({ type => "button", text => "[ $text ]", activate => $cb}); 1314 $self->add_item ({ type => "button", text => $text, activate => $cb});
1191} 1315}
1192 1316
1193sub add_toggle { 1317sub add_toggle {
1194 my ($self, $text, $cb, $value) = @_; 1318 my ($self, $text, $cb, $value) = @_;
1195 1319
1207sub show { 1331sub show {
1208 my ($self) = @_; 1332 my ($self) = @_;
1209 1333
1210 local $urxvt::popup::self = $self; 1334 local $urxvt::popup::self = $self;
1211 1335
1336 local $ENV{LC_ALL} = $self->{term}->locale;
1337
1212 urxvt->new ("--perl-lib" => "", "--perl-ext-common" => "", "-pty-fd" => -1, "-sl" => 0, "-b" => 0, 1338 urxvt->new ("--perl-lib" => "", "--perl-ext-common" => "", "-pty-fd" => -1, "-sl" => 0, "-b" => 0,
1213 "--transient-for" => $self->{term}->parent, 1339 "--transient-for" => $self->{term}->parent,
1340 "-display" => $self->{term}->display_id,
1214 "-pe" => "urxvt-popup") 1341 "-pe" => "urxvt-popup")
1215 or die "unable to create popup window\n"; 1342 or die "unable to create popup window\n";
1216} 1343}
1217 1344
1218sub DESTROY { 1345sub DESTROY {
1281 1408
1282 $term->{socket} = ... 1409 $term->{socket} = ...
1283 $term->{iow} = urxvt::iow 1410 $term->{iow} = urxvt::iow
1284 ->new 1411 ->new
1285 ->fd (fileno $term->{socket}) 1412 ->fd (fileno $term->{socket})
1286 ->events (1) # wait for read data 1413 ->events (urxvt::EVENT_READ)
1287 ->start 1414 ->start
1288 ->cb (sub { 1415 ->cb (sub {
1289 my ($iow, $revents) = @_; 1416 my ($iow, $revents) = @_;
1290 # $revents must be 1 here, no need to check 1417 # $revents must be 1 here, no need to check
1291 sysread $term->{socket}, my $buf, 8192 1418 sysread $term->{socket}, my $buf, 8192
1308 1435
1309Set the filedescriptor (not handle) to watch. 1436Set the filedescriptor (not handle) to watch.
1310 1437
1311=item $iow = $iow->events ($eventmask) 1438=item $iow = $iow->events ($eventmask)
1312 1439
1313Set the event mask to watch. Bit #0 (value C<1>) enables watching for read 1440Set the event mask to watch. The only allowed values are
1314data, Bit #1 (value C<2>) enables watching for write data. 1441C<urxvt::EVENT_READ> and C<urxvt::EVENT_WRITE>, which might be ORed
1442together, or C<urxvt::EVENT_NONE>.
1315 1443
1316=item $iow = $iow->start 1444=item $iow = $iow->start
1317 1445
1318Start watching for requested events on the given handle. 1446Start watching for requested events on the given handle.
1319 1447

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines