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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines