[ViewVC] Diff of: cvs/rxvt-unicode/src/urxvt.pm

Comparing rxvt-unicode/src/urxvt.pm (file contents):
Revision 1.59 by root, Mon Jan 9 00:34:36 2006 UTC vs.
Revision 1.69 by root, Mon Jan 9 22:41:41 2006 UTC

…		…
65		65
66	=item selection-popup (enabled by default)	66	=item selection-popup (enabled by default)
67		67
68	Binds a popup menu to Ctrl-Button3 that lets you convert the selection	68	Binds a popup menu to Ctrl-Button3 that lets you convert the selection
69	text into various other formats/action.	69	text into various other formats/action.
		70
		71	=item searchable-scrollback (enabled by default)
		72
		73	Adds regex search functionality to the scrollback buffer, triggered by a
		74	hotkey (default: C<M-s>). When in search mode, terminal input/output is
		75	suspended, C</> starts an incremental regex search, C<n> searches further,
		76	C<p> jumps to the previous match. C<enter> leaves search mode at the
		77	current position and C<escape> returns to the original position.
70		78
71	=item digital-clock	79	=item digital-clock
72		80
73	Displays a digital clock using the built-in overlay.	81	Displays a digital clock using the built-in overlay.
74		82
…		…
124	Either binary data or - more common - a text string encoded in a	132	Either binary data or - more common - a text string encoded in a
125	locale-specific way.	133	locale-specific way.
126		134
127	=back	135	=back
128		136
		137	=head2 Extension Objects
		138
		139	Very perl extension is a perl class. A separate perl object is created
		140	for each terminal and each extension and passed as the first parameter to
		141	hooks. So extensions can use their C<$self> object without having to think
		142	about other extensions, with the exception of methods and members that
		143	begin with an underscore character C<_>: these are reserved for internal
		144	use.
		145
		146	Although it isn't a C<urxvt::term> object, you can call all methods of the
		147	C<urxvt::term> class on this object.
		148
		149	It has the following methods and data members:
		150
		151	=over 4
		152
		153	=item $urxvt_term = $self->{term}
		154
		155	Returns the C<urxvt::term> object associated with this instance of the
		156	extension. This member I<must not> be changed in any way.
		157
		158	=item $self->enable ($hook_name => $cb, [$hook_name => $cb..])
		159
		160	Dynamically enable the given hooks (named without the C<on_> prefix) for
		161	this extension, replacing any previous hook. This is useful when you want
		162	to overwrite time-critical hooks only temporarily.
		163
		164	=item $self->disable ($hook_name[, $hook_name..])
		165
		166	Dynamically disable the given hooks.
		167
		168	=back
		169
129	=head2 Hooks	170	=head2 Hooks
130		171
131	The following subroutines can be declared in extension files, and will be	172	The following subroutines can be declared in extension files, and will be
132	called whenever the relevant event happens.	173	called whenever the relevant event happens.
133		174
134	The first argument passed to them is an object private to each terminal	175	The first argument passed to them is an extension oject as described in
135	and extension package. You can call all C<urxvt::term> methods on it, but	176	the in the C<Extension Objects> section.
136	its not a real C<urxvt::term> object. Instead, the real C<urxvt::term>
137	object that is shared between all packages is stored in the C<term>
138	member. It is, however, blessed intot he package of the extension script,
139	so for all practical purposes you can treat an extension script as a class.
140		177
141	All of them must return a boolean value. If it is true, then the event	178	B<All> of these hooks must return a boolean value. If it is true, then the
142	counts as being I<consumed>, and the invocation of other hooks is skipped,	179	event counts as being I<consumed>, and the invocation of other hooks is
143	and the relevant action might not be carried out by the C++ code.	180	skipped, and the relevant action might not be carried out by the C++ code.
144		181
145	When in doubt, return a false value (preferably C<()>).	182	I<< 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
…		…
204	than the scroll back buffer or the terminal.	241	than the scroll back buffer or the terminal.
205		242
206	It is called before lines are scrolled out (so rows 0 .. min ($lines - 1,	243	It is called before lines are scrolled out (so rows 0 .. min ($lines - 1,
207	$nrow - 1) represent the lines to be scrolled out). C<$saved> is the total	244	$nrow - 1) represent the lines to be scrolled out). C<$saved> is the total
208	number of lines that will be in the scrollback buffer.	245	number of lines that will be in the scrollback buffer.
209
210	=item on_tty_activity $term NYI
211
212	Called whenever the program(s) running in the urxvt window send output.
213		246
214	=item on_osc_seq $term, $string	247	=item on_osc_seq $term, $string
215		248
216	Called whenever the B<ESC ] 777 ; string ST> command sequence (OSC =	249	Called whenever the B<ESC ] 777 ; string ST> command sequence (OSC =
217	operating system command) is processed. Cursor position and other state	250	operating system command) is processed. Cursor position and other state
…		…
271	=item on_focus_out $term	304	=item on_focus_out $term
272		305
273	Called wheneever the window loses keyboard focus, before rxvt-unicode does	306	Called wheneever the window loses keyboard focus, before rxvt-unicode does
274	focus out processing.	307	focus out processing.
275		308
276	=item on_key_press $term, $event, $octets	309	=item on_key_press $term, $event, $keysym, $octets
277		310
278	=item on_key_release $term, $event	311	=item on_key_release $term, $event, $keysym
279		312
280	=item on_button_press $term, $event	313	=item on_button_press $term, $event
281		314
282	=item on_button_release $term, $event	315	=item on_button_release $term, $event
283		316
…		…
337	that calls this function.	370	that calls this function.
338		371
339	Using this function has the advantage that its output ends up in the	372	Using this function has the advantage that its output ends up in the
340	correct place, e.g. on stderr of the connecting urxvtc client.	373	correct place, e.g. on stderr of the connecting urxvtc client.
341		374
		375	=item $is_safe = urxvt::safe
		376
		377	Returns true when it is safe to do potentially unsafe things, such as
		378	evaluating perl code specified by the user. This is true when urxvt was
		379	started setuid or setgid.
		380
342	=item $time = urxvt::NOW	381	=item $time = urxvt::NOW
343		382
344	Returns the "current time" (as per the event loop).	383	Returns the "current time" (as per the event loop).
345		384
346	=item urxvt::CurrentTime	385	=item urxvt::CurrentTime
…		…
409		448
410	package urxvt;	449	package urxvt;
411		450
412	use utf8;	451	use utf8;
413	use strict;	452	use strict;
		453	use Carp ();
414	use Scalar::Util ();	454	use Scalar::Util ();
415	use List::Util ();	455	use List::Util ();
416		456
417	our $VERSION = 1;	457	our $VERSION = 1;
418	our $TERM;	458	our $TERM;
419	our @HOOKNAME;	459	our @HOOKNAME;
		460	our %HOOKTYPE = map +($HOOKNAME[$_] => $_), 0..$#HOOKNAME;
420	our %OPTION;	461	our %OPTION;
421	our $LIBDIR;	462	our $LIBDIR;
422		463
423	BEGIN {	464	BEGIN {
424	urxvt->bootstrap;	465	urxvt->bootstrap;
…		…
429	$msg .= "\n"	470	$msg .= "\n"
430	unless $msg =~ /\n$/;	471	unless $msg =~ /\n$/;
431	urxvt::warn ($msg);	472	urxvt::warn ($msg);
432	};	473	};
433		474
		475	delete $ENV{IFS};
		476	delete $ENV{CDPATH};
		477	delete $ENV{BASH_ENV};
434	$ENV{PATH} = "/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:/opt/bin:/opt/sbin";	478	$ENV{PATH} = "/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:/opt/bin:/opt/sbin";
435	delete $ENV{CDPATH};
436	}	479	}
437		480
438	my @hook_count;	481	my @hook_count;
439	my $verbosity = $ENV{URXVT_PERL_VERBOSITY};	482	my $verbosity = $ENV{URXVT_PERL_VERBOSITY};
440		483
441	sub verbose {	484	sub verbose {
442	my ($level, $msg) = @_;	485	my ($level, $msg) = @_;
443	warn "$msg\n" if $level <= $verbosity;	486	warn "$msg\n" if $level <= $verbosity;
444	}	487	}
445		488
446	# find on_xxx subs in the package and register them
447	# as hooks
448	sub register_package($) {
449	my ($pkg) = @_;
450
451	for my $htype (0.. $#HOOKNAME) {
452	my $name = $HOOKNAME[$htype];
453
454	my $ref = $pkg->can ("on_" . lc $name)
455	or next;
456
457	$TERM->{_hook}[$htype]{$pkg} = $ref;
458	$hook_count[$htype]++
459	or set_should_invoke $htype, 1;
460	}
461	}
462
463	my $extension_pkg = "extension0000";	489	my $extension_pkg = "extension0000";
464	my %extension_pkg;	490	my %extension_pkg;
465		491
466	# load a single script into its own package, once only	492	# load a single script into its own package, once only
467	sub extension_package($) {	493	sub extension_package($) {
…		…
473	verbose 3, "loading extension '$path' into package '$pkg'";	499	verbose 3, "loading extension '$path' into package '$pkg'";
474		500
475	open my $fh, "<:raw", $path	501	open my $fh, "<:raw", $path
476	or die "$path: $!";	502	or die "$path: $!";
477		503
		504	my $source = untaint
478	my $source = untaint "package $pkg; use strict; use utf8;\n"	505	"package $pkg; use strict; use utf8;\n"
479	. "use base urxvt::term::proxy::;\n"	506	. "use base urxvt::term::proxy::;\n"
480	. "#line 1 \"$path\"\n{\n"	507	. "#line 1 \"$path\"\n{\n"
481	. (do { local $/; <$fh> })	508	. (do { local $/; <$fh> })
482	. "\n};\n1";	509	. "\n};\n1";
483		510
		511	eval $source
484	eval $source or die "$path: $@";	512	or die "$path: $@";
485		513
486	$pkg	514	$pkg
487	}	515	}
488	}	516	}
489		517
…		…
495	my $htype = shift;	523	my $htype = shift;
496		524
497	if ($htype == 0) { # INIT	525	if ($htype == 0) { # INIT
498	my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$LIBDIR/perl");	526	my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$LIBDIR/perl");
499		527
500	my %want_ext;	528	my %ext_arg;
501		529
502	for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) {	530	for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) {
503	if ($_ eq "default") {	531	if ($_ eq "default") {
504	$want_ext{$_}++ for qw(selection option-popup selection-popup);	532	$ext_arg{$_} \|\|= [] for qw(selection option-popup selection-popup searchable-scrollback);
505	} elsif (/^-(.*)$/) {	533	} elsif (/^-(.*)$/) {
506	delete $want_ext{$1};	534	delete $ext_arg{$1};
		535	} elsif (/^([^<]+)<(.*)>$/) {
		536	push @{ $ext_arg{$1} }, $2;
507	} else {	537	} else {
508	$want_ext{$_}++;	538	$ext_arg{$_} \|\|= [];
509	}	539	}
510	}	540	}
511		541
512	for my $ext (keys %want_ext) {	542	while (my ($ext, $argv) = each %ext_arg) {
513	my @files = grep -f $_, map "$_/$ext", @dirs;	543	my @files = grep -f $_, map "$_/$ext", @dirs;
514		544
515	if (@files) {	545	if (@files) {
516	register_package extension_package $files[0];	546	$TERM->register_package (extension_package $files[0], $argv);
517	} else {	547	} else {
518	warn "perl extension '$ext' not found in perl library search path\n";	548	warn "perl extension '$ext' not found in perl library search path\n";
519	}	549	}
520	}	550	}
521		551
…		…
530	if $verbosity >= 10;	560	if $verbosity >= 10;
531		561
532	keys %$cb;	562	keys %$cb;
533		563
534	while (my ($pkg, $cb) = each %$cb) {	564	while (my ($pkg, $cb) = each %$cb) {
535	eval {	565	$retval = eval { $cb->($TERM->{_pkg}{$pkg}, @_) }
536	$retval = $cb->(
537	$TERM->{_pkg}{$pkg} \|\|= do {
538	my $proxy = bless { }, $pkg;
539	Scalar::Util::weaken ($proxy->{term} = $TERM);
540	$proxy
541	},
542	@_,
543	) and last;	566	and last;
544	};	567
545	if ($@) {	568	if ($@) {
546	$TERM->ungrab; # better to lose the grab than the session	569	$TERM->ungrab; # better to lose the grab than the session
547	warn $@;	570	warn $@;
548	}	571	}
549	}	572	}
550	}	573	}
551		574
552	if ($htype == 1) { # DESTROY	575	if ($htype == 1) { # DESTROY
553	# remove hooks if unused
554	if (my $hook = $TERM->{_hook}) {	576	if (my $hook = delete $TERM->{_hook}) {
555	for my $htype (0..$#$hook) {	577	for my $htype (0..$#$hook) {
556	$hook_count[$htype] -= scalar keys %{ $hook->[$htype] \|\| {} }	578	$hook_count[$htype] -= scalar keys %{ $hook->[$htype] \|\| {} }
557	or set_should_invoke $htype, 0;	579	or set_should_invoke $htype, 0;
558	}	580	}
559	}	581	}
…		…
568	$retval	590	$retval
569	}	591	}
570		592
571	# urxvt::term::proxy	593	# urxvt::term::proxy
572		594
573	sub urxvt::term::proxy::AUTOLOAD {	595	package urxvt::term::proxy;
574	$urxvt::term::proxy::AUTOLOAD =~ /:([^:]+)$/	596
		597	sub enable {
		598	my ($self, %hook) = @_;
		599	my $pkg = $self->{_pkg};
		600
		601	while (my ($name, $cb) = each %hook) {
		602	my $htype = $HOOKTYPE{uc $name};
		603	defined $htype
		604	or Carp::croak "unsupported hook type '$name'";
		605
		606	unless (exists $self->{term}{_hook}[$htype]{$pkg}) {
		607	$hook_count[$htype]++
		608	or urxvt::set_should_invoke $htype, 1;
		609	}
		610
		611	$self->{term}{_hook}[$htype]{$pkg} = $cb;
		612	}
		613	}
		614
		615	sub disable {
		616	my ($self, @hook) = @_;
		617	my $pkg = $self->{_pkg};
		618
		619	for my $name (@hook) {
		620	my $htype = $HOOKTYPE{uc $name};
		621	defined $htype
		622	or Carp::croak "unsupported hook type '$name'";
		623
		624	if (delete $self->{term}{_hook}[$htype]{$pkg}) {
		625	--$hook_count[$htype]
		626	or urxvt::set_should_invoke $htype, 0;
		627	}
		628	}
		629	}
		630
		631	our $AUTOLOAD;
		632
		633	sub AUTOLOAD {
		634	$AUTOLOAD =~ /:([^:]+)$/
575	or die "FATAL: \$AUTOLOAD '$urxvt::term::proxy::AUTOLOAD' unparsable";	635	or die "FATAL: \$AUTOLOAD '$AUTOLOAD' unparsable";
576		636
577	eval qq{	637	eval qq{
578	sub $urxvt::term::proxy::AUTOLOAD {	638	sub $AUTOLOAD {
579	my \$proxy = shift;	639	my \$proxy = shift;
580	\$proxy->{term}->$1 (\@_)	640	\$proxy->{term}->$1 (\@_)
581	}	641	}
582	1	642	1
583	} or die "FATAL: unable to compile method forwarder: $@";	643	} or die "FATAL: unable to compile method forwarder: $@";
584		644
585	goto &$urxvt::term::proxy::AUTOLOAD;	645	goto &$AUTOLOAD;
586	}	646	}
587		647
588	sub urxvt::term::proxy::DESTROY {	648	sub DESTROY {
589	# nop	649	# nop
590	}	650	}
591		651
592	# urxvt::destroy_hook	652	# urxvt::destroy_hook
593		653
…		…
660	${$_[0]}++;	720	${$_[0]}++;
661	}	721	}
662		722
663	sub urxvt::anyevent::condvar::wait {	723	sub urxvt::anyevent::condvar::wait {
664	unless (${$_[0]}) {	724	unless (${$_[0]}) {
665	require Carp;
666	Carp::croak ("AnyEvent->condvar blocking wait unsupported in urxvt, use a non-blocking API");	725	Carp::croak "AnyEvent->condvar blocking wait unsupported in urxvt, use a non-blocking API";
667	}	726	}
668	}	727	}
669		728
670	package urxvt::term;	729	package urxvt::term;
671		730
672	=head2 The C<urxvt::term> Class	731	=head2 The C<urxvt::term> Class
673		732
674	=over 4	733	=over 4
		734
		735	=cut
		736
		737	# find on_xxx subs in the package and register them
		738	# as hooks
		739	sub register_package {
		740	my ($self, $pkg, $argv) = @_;
		741
		742	my $proxy = bless {
		743	_pkg => $pkg,
		744	argv => $argv,
		745	}, $pkg;
		746	Scalar::Util::weaken ($proxy->{term} = $self);
		747
		748	$self->{_pkg}{$pkg} = $proxy;
		749
		750	for my $name (@HOOKNAME) {
		751	if (my $ref = $pkg->can ("on_" . lc $name)) {
		752	$proxy->enable ($name => $ref);
		753	}
		754	}
		755	}
675		756
676	=item $term->destroy	757	=item $term->destroy
677		758
678	Destroy the terminal object (close the window, free resources etc.).	759	Destroy the terminal object (close the window, free resources etc.).
679		760
…		…
733	my ($self, $name) = (shift, shift);	814	my ($self, $name) = (shift, shift);
734	unshift @_, $self, $name, ($name =~ s/\s\+\s(\d+)$// ? $1 : 0);	815	unshift @_, $self, $name, ($name =~ s/\s\+\s(\d+)$// ? $1 : 0);
735	&urxvt::term::_resource	816	&urxvt::term::_resource
736	}	817	}
737		818
		819	=item $success = $term->parse_keysym ($keysym_spec, $command_string)
		820
		821	Adds a keymap translation exactly as specified via a resource. See the
		822	C<keysym> resource in the @@RXVT_NAME@@(1) manpage.
		823
738	=item $rend = $term->rstyle ([$new_rstyle])	824	=item $rend = $term->rstyle ([$new_rstyle])
739		825
740	Return and optionally change the current rendition. Text that is output by	826	Return and optionally change the current rendition. Text that is output by
741	the terminal application will use this style.	827	the terminal application will use this style.
742		828
…		…
761		847
762	=item $oldtext = $term->selection ([$newtext])	848	=item $oldtext = $term->selection ([$newtext])
763		849
764	Return the current selection text and optionally replace it by C<$newtext>.	850	Return the current selection text and optionally replace it by C<$newtext>.
765		851
766	#=item $term->overlay ($x, $y, $text)	852	=item $term->overlay_simple ($x, $y, $text)
767	#	853
768	#Create a simple multi-line overlay box. See the next method for details.	854	Create a simple multi-line overlay box. See the next method for details.
769	#	855
770	#=cut	856	=cut
771	#	857
772	#sub urxvt::term::scr_overlay {	858	sub overlay_simple {
773	# my ($self, $x, $y, $text) = @_;	859	my ($self, $x, $y, $text) = @_;
774	#	860
775	# my @lines = split /\n/, $text;	861	my @lines = split /\n/, $text;
776	#	862
777	# my $w = 0;	863	my $w = List::Util::max map $self->strwidth ($_), @lines;
778	# for (map $self->strwidth ($_), @lines) {	864
779	# $w = $_ if $w < $_;
780	# }
781	#
782	# $self->scr_overlay_new ($x, $y, $w, scalar @lines);	865	my $overlay = $self->overlay ($x, $y, $w, scalar @lines);
783	# $self->scr_overlay_set (0, $_, $lines[$_]) for 0.. $#lines;	866	$overlay->set (0, $_, $lines[$_]) for 0.. $#lines;
784	#}	867
		868	$overlay
		869	}
785		870
786	=item $term->overlay ($x, $y, $width, $height[, $rstyle[, $border]])	871	=item $term->overlay ($x, $y, $width, $height[, $rstyle[, $border]])
787		872
788	Create a new (empty) overlay at the given position with the given	873	Create a new (empty) overlay at the given position with the given
789	width/height. C<$rstyle> defines the initial rendition style	874	width/height. C<$rstyle> defines the initial rendition style
…		…
856		941
857	=item $string = $term->locale_decode ($octets)	942	=item $string = $term->locale_decode ($octets)
858		943
859	Convert the given locale-encoded octets into a perl string.	944	Convert the given locale-encoded octets into a perl string.
860		945
		946	=item $term->scr_bell
		947
		948	Ring the bell!
		949
861	=item $term->scr_add_lines ($string)	950	=item $term->scr_add_lines ($string)
862		951
863	Write the given text string to the screen, as if output by the application	952	Write the given text string to the screen, as if output by the application
864	running inside the terminal. It may not contain command sequences (escape	953	running inside the terminal. It may not contain command sequences (escape
865	codes), but is free to use line feeds, carriage returns and tabs. The	954	codes), but is free to use line feeds, carriage returns and tabs. The
…		…
879		968
880	Write the octets given in C<$data> to the tty (i.e. as program input). To	969	Write the octets given in C<$data> to the tty (i.e. as program input). To
881	pass characters instead of octets, you should convert your strings first	970	pass characters instead of octets, you should convert your strings first
882	to the locale-specific encoding using C<< $term->locale_encode >>.	971	to the locale-specific encoding using C<< $term->locale_encode >>.
883		972
		973	=item $old_events = $term->pty_ev_events ([$new_events])
		974
		975	Replaces the event mask of the pty watcher by the given event mask. Can
		976	be used to suppress input and output handling to the pty/tty. See the
		977	description of C<< urxvt::timer->events >>. Make sure to always restore
		978	the previous value.
		979
884	=item $windowid = $term->parent	980	=item $windowid = $term->parent
885		981
886	Return the window id of the toplevel window.	982	Return the window id of the toplevel window.
887		983
888	=item $windowid = $term->vt	984	=item $windowid = $term->vt
…		…
912	=item $nrow_plus_saveLines = $term->total_rows	1008	=item $nrow_plus_saveLines = $term->total_rows
913		1009
914	=item $lines_in_scrollback = $term->nsaved	1010	=item $lines_in_scrollback = $term->nsaved
915		1011
916	Return various integers describing terminal characteristics.	1012	Return various integers describing terminal characteristics.
		1013
		1014	=item $lc_ctype = $term->locale
		1015
		1016	Returns the LC_CTYPE category string used by this rxvt-unicode.
		1017
		1018	=item $x_display = $term->display_id
		1019
		1020	Return the DISPLAY used by rxvt-unicode.
917		1021
918	=item $modifiermask = $term->ModLevel3Mask	1022	=item $modifiermask = $term->ModLevel3Mask
919		1023
920	=item $modifiermask = $term->ModMetaMask	1024	=item $modifiermask = $term->ModMetaMask
921		1025
…		…
1098	$offset / $self->{ncol} + $self->{beg},	1202	$offset / $self->{ncol} + $self->{beg},
1099	$offset % $self->{ncol}	1203	$offset % $self->{ncol}
1100	)	1204	)
1101	}	1205	}
1102		1206
1103	=item ($row, $col) = $line->coord_of ($offset)
1104	=item $text = $term->special_encode $string	1207	=item $text = $term->special_encode $string
1105		1208
1106	Converts a perl string into the special encoding used by rxvt-unicode,	1209	Converts a perl string into the special encoding used by rxvt-unicode,
1107	where one character corresponds to one screen cell. See	1210	where one character corresponds to one screen cell. See
1108	C<< $term->ROW_t >> for details.	1211	C<< $term->ROW_t >> for details.
…		…
1110	=item $string = $term->special_decode $text	1213	=item $string = $term->special_decode $text
1111		1214
1112	Converts rxvt-unicodes text reprsentation into a perl string. See	1215	Converts rxvt-unicodes text reprsentation into a perl string. See
1113	C<< $term->ROW_t >> for details.	1216	C<< $term->ROW_t >> for details.
1114		1217
		1218	=item $success = $term->grab_button ($button, $modifiermask)
		1219
		1220	Registers a synchronous button grab. See the XGrabButton manpage.
		1221
		1222	=item $success = $term->grab ($eventtime[, $sync])
		1223
		1224	Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or
		1225	synchronous (C<$sync> is true). Also remembers the grab timestampe.
		1226
		1227	=item $term->allow_events_async
		1228
		1229	Calls XAllowEvents with AsyncBoth for the most recent grab.
		1230
		1231	=item $term->allow_events_sync
		1232
		1233	Calls XAllowEvents with SyncBoth for the most recent grab.
		1234
		1235	=item $term->allow_events_replay
		1236
		1237	Calls XAllowEvents with both ReplayPointer and ReplayKeyboard for the most
		1238	recent grab.
		1239
		1240	=item $term->ungrab
		1241
		1242	Calls XUngrab for the most recent grab. Is called automatically on
		1243	evaluation errors, as it is better to lose the grab in the error case as
		1244	the session.
		1245
1115	=back	1246	=back
1116		1247
1117	=cut	1248	=cut
1118		1249
1119	package urxvt::popup;	1250	package urxvt::popup;
…		…
1137	}	1268	}
1138		1269
1139	sub add_separator {	1270	sub add_separator {
1140	my ($self, $sep) = @_;	1271	my ($self, $sep) = @_;
1141		1272
1142	$sep \|\|= "═";	1273	$sep \|\|= "=";
1143		1274
1144	$self->add_item ({	1275	$self->add_item ({
1145	rend => { normal => "\x1b[0;30;47m", hover => "\x1b[0;30;47m", active => "\x1b[0;30;47m" },	1276	rend => { normal => "\x1b[0;30;47m", hover => "\x1b[0;30;47m", active => "\x1b[0;30;47m" },
1146	text => "",	1277	text => "",
1147	render => sub { $sep x $urxvt::TERM->ncol },	1278	render => sub { $sep x $self->{term}->ncol },
1148	activate => sub { },	1279	activate => sub { },
1149	});	1280	});
1150	}	1281	}
1151		1282
1152	sub add_title {	1283	sub add_title {
…		…
1160	}	1291	}
1161		1292
1162	sub add_button {	1293	sub add_button {
1163	my ($self, $text, $cb) = @_;	1294	my ($self, $text, $cb) = @_;
1164		1295
1165	$self->add_item ({ type => "button", text => "[ $text ]", activate => $cb});	1296	$self->add_item ({ type => "button", text => $text, activate => $cb});
1166	}	1297	}
1167		1298
1168	sub add_toggle {	1299	sub add_toggle {
1169	my ($self, $text, $cb, $value) = @_;	1300	my ($self, $text, $cb, $value) = @_;
1170		1301
…		…
1182	sub show {	1313	sub show {
1183	my ($self) = @_;	1314	my ($self) = @_;
1184		1315
1185	local $urxvt::popup::self = $self;	1316	local $urxvt::popup::self = $self;
1186		1317
		1318	local $ENV{LC_ALL} = $self->{term}->locale;
		1319
1187	urxvt->new ("--perl-lib" => "", "--perl-ext-common" => "", "-pty-fd" => -1, "-sl" => 0, "-b" => 0,	1320	urxvt->new ("--perl-lib" => "", "--perl-ext-common" => "", "-pty-fd" => -1, "-sl" => 0, "-b" => 0,
1188	"--transient-for" => $self->{term}->parent,	1321	"--transient-for" => $self->{term}->parent,
		1322	"-display" => $self->{term}->display_id,
1189	"-pe" => "urxvt-popup")	1323	"-pe" => "urxvt-popup")
1190	or die "unable to create popup window\n";	1324	or die "unable to create popup window\n";
1191	}	1325	}
1192		1326
1193	sub DESTROY {	1327	sub DESTROY {
…		…
1256		1390
1257	$term->{socket} = ...	1391	$term->{socket} = ...
1258	$term->{iow} = urxvt::iow	1392	$term->{iow} = urxvt::iow
1259	->new	1393	->new
1260	->fd (fileno $term->{socket})	1394	->fd (fileno $term->{socket})
1261	->events (1) # wait for read data	1395	->events (urxvt::EVENT_READ)
1262	->start	1396	->start
1263	->cb (sub {	1397	->cb (sub {
1264	my ($iow, $revents) = @_;	1398	my ($iow, $revents) = @_;
1265	# $revents must be 1 here, no need to check	1399	# $revents must be 1 here, no need to check
1266	sysread $term->{socket}, my $buf, 8192	1400	sysread $term->{socket}, my $buf, 8192
…		…
1283		1417
1284	Set the filedescriptor (not handle) to watch.	1418	Set the filedescriptor (not handle) to watch.
1285		1419
1286	=item $iow = $iow->events ($eventmask)	1420	=item $iow = $iow->events ($eventmask)
1287		1421
1288	Set the event mask to watch. Bit #0 (value C<1>) enables watching for read	1422	Set the event mask to watch. The only allowed values are
1289	data, Bit #1 (value C<2>) enables watching for write data.	1423	C<urxvt::EVENT_READ> and C<urxvt::EVENT_WRITE>, which might be ORed
		1424	together, or C<urxvt::EVENT_NONE>.
1290		1425
1291	=item $iow = $iow->start	1426	=item $iow = $iow->start
1292		1427
1293	Start watching for requested events on the given handle.	1428	Start watching for requested events on the given handle.
1294		1429

Diff Legend

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

Comparing rxvt-unicode/src/urxvt.pm (file contents): Revision 1.59 by root, Mon Jan 9 00:34:36 2006 UTC vs. Revision 1.69 by root, Mon Jan 9 22:41:41 2006 UTC

Diff Legend

Comparing rxvt-unicode/src/urxvt.pm (file contents):
Revision 1.59 by root, Mon Jan 9 00:34:36 2006 UTC vs.
Revision 1.69 by root, Mon Jan 9 22:41:41 2006 UTC