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.57 by root, Sun Jan 8 08:43:11 2006 UTC vs.
Revision 1.65 by root, Mon Jan 9 19:25:57 2006 UTC

58 58
59=back 59=back
60 60
61=item option-popup (enabled by default) 61=item option-popup (enabled by default)
62 62
63Binds a popup menu to Ctrl-Button3 that lets you toggle (some) options at 63Binds a popup menu to Ctrl-Button2 that lets you toggle (some) options at
64runtime. 64runtime.
65
66=item selection-popup (enabled by default)
67
68Binds a popup menu to Ctrl-Button3 that lets you convert the selection
69text into various other formats/action.
65 70
66=item digital-clock 71=item digital-clock
67 72
68Displays a digital clock using the built-in overlay. 73Displays a digital clock using the built-in overlay.
69 74
200 205
201It is called before lines are scrolled out (so rows 0 .. min ($lines - 1, 206It is called before lines are scrolled out (so rows 0 .. min ($lines - 1,
202$nrow - 1) represent the lines to be scrolled out). C<$saved> is the total 207$nrow - 1) represent the lines to be scrolled out). C<$saved> is the total
203number of lines that will be in the scrollback buffer. 208number of lines that will be in the scrollback buffer.
204 209
205=item on_tty_activity $term *NYI*
206
207Called whenever the program(s) running in the urxvt window send output.
208
209=item on_osc_seq $term, $string 210=item on_osc_seq $term, $string
210 211
211Called whenever the B<ESC ] 777 ; string ST> command sequence (OSC = 212Called whenever the B<ESC ] 777 ; string ST> command sequence (OSC =
212operating system command) is processed. Cursor position and other state 213operating system command) is processed. Cursor position and other state
213information is up-to-date when this happens. For interoperability, the 214information is up-to-date when this happens. For interoperability, the
331newline. The module also overwrites the C<warn> builtin with a function 332newline. The module also overwrites the C<warn> builtin with a function
332that calls this function. 333that calls this function.
333 334
334Using this function has the advantage that its output ends up in the 335Using this function has the advantage that its output ends up in the
335correct place, e.g. on stderr of the connecting urxvtc client. 336correct place, e.g. on stderr of the connecting urxvtc client.
337
338=item $is_safe = urxvt::safe
339
340Returns true when it is safe to do potentially unsafe things, such as
341evaluating perl code specified by the user. This is true when urxvt was
342started setuid or setgid.
336 343
337=item $time = urxvt::NOW 344=item $time = urxvt::NOW
338 345
339Returns the "current time" (as per the event loop). 346Returns the "current time" (as per the event loop).
340 347
423 my $msg = join "", @_; 430 my $msg = join "", @_;
424 $msg .= "\n" 431 $msg .= "\n"
425 unless $msg =~ /\n$/; 432 unless $msg =~ /\n$/;
426 urxvt::warn ($msg); 433 urxvt::warn ($msg);
427 }; 434 };
435
436 delete $ENV{IFS};
437 delete $ENV{CDPATH};
438 delete $ENV{BASH_ENV};
439 $ENV{PATH} = "/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:/opt/bin:/opt/sbin";
428} 440}
429 441
430my @hook_count; 442my @hook_count;
431my $verbosity = $ENV{URXVT_PERL_VERBOSITY}; 443my $verbosity = $ENV{URXVT_PERL_VERBOSITY};
432 444
465 verbose 3, "loading extension '$path' into package '$pkg'"; 477 verbose 3, "loading extension '$path' into package '$pkg'";
466 478
467 open my $fh, "<:raw", $path 479 open my $fh, "<:raw", $path
468 or die "$path: $!"; 480 or die "$path: $!";
469 481
470 my $source = "package $pkg; use strict; use utf8;\n" 482 my $source = untaint "package $pkg; use strict; use utf8;\n"
471 . "use base urxvt::term::proxy::;\n" 483 . "use base urxvt::term::proxy::;\n"
472 . "#line 1 \"$path\"\n{\n" 484 . "#line 1 \"$path\"\n{\n"
473 . (do { local $/; <$fh> }) 485 . (do { local $/; <$fh> })
474 . "\n};\n1"; 486 . "\n};\n1";
475 487
476 $source =~ /(.*)/s and $source = $1; # untaint
477
478 eval $source or die "$path: $@"; 488 eval $source or die "$path: $@";
479 489
480 $pkg 490 $pkg
481 } 491 }
482} 492}
493 503
494 my %want_ext; 504 my %want_ext;
495 505
496 for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) { 506 for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) {
497 if ($_ eq "default") { 507 if ($_ eq "default") {
498 $want_ext{$_}++ for qw(selection option-popup); 508 $want_ext{$_}++ for qw(selection option-popup selection-popup);
499 } elsif (/^-(.*)$/) { 509 } elsif (/^-(.*)$/) {
500 delete $want_ext{$1}; 510 delete $want_ext{$1};
501 } else { 511 } else {
502 $want_ext{$_}++; 512 $want_ext{$_}++;
503 } 513 }
534 $proxy 544 $proxy
535 }, 545 },
536 @_, 546 @_,
537 ) and last; 547 ) and last;
538 }; 548 };
539 warn $@ if $@;#d# 549 if ($@) {
550 $TERM->ungrab; # better to lose the grab than the session
551 warn $@;
552 }
540 } 553 }
541 } 554 }
542 555
543 if ($htype == 1) { # DESTROY 556 if ($htype == 1) { # DESTROY
544 # remove hooks if unused 557 # remove hooks if unused
572 } 585 }
573 1 586 1
574 } or die "FATAL: unable to compile method forwarder: $@"; 587 } or die "FATAL: unable to compile method forwarder: $@";
575 588
576 goto &$urxvt::term::proxy::AUTOLOAD; 589 goto &$urxvt::term::proxy::AUTOLOAD;
590}
591
592sub urxvt::term::proxy::DESTROY {
593 # nop
577} 594}
578 595
579# urxvt::destroy_hook 596# urxvt::destroy_hook
580 597
581sub urxvt::destroy_hook::DESTROY { 598sub urxvt::destroy_hook::DESTROY {
1085 $offset / $self->{ncol} + $self->{beg}, 1102 $offset / $self->{ncol} + $self->{beg},
1086 $offset % $self->{ncol} 1103 $offset % $self->{ncol}
1087 ) 1104 )
1088} 1105}
1089 1106
1090=item ($row, $col) = $line->coord_of ($offset)
1091=item $text = $term->special_encode $string 1107=item $text = $term->special_encode $string
1092 1108
1093Converts a perl string into the special encoding used by rxvt-unicode, 1109Converts a perl string into the special encoding used by rxvt-unicode,
1094where one character corresponds to one screen cell. See 1110where one character corresponds to one screen cell. See
1095C<< $term->ROW_t >> for details. 1111C<< $term->ROW_t >> for details.
1097=item $string = $term->special_decode $text 1113=item $string = $term->special_decode $text
1098 1114
1099Converts rxvt-unicodes text reprsentation into a perl string. See 1115Converts rxvt-unicodes text reprsentation into a perl string. See
1100C<< $term->ROW_t >> for details. 1116C<< $term->ROW_t >> for details.
1101 1117
1118=item $success = $term->grab_button ($button, $modifiermask)
1119
1120Registers a synchronous button grab. See the XGrabButton manpage.
1121
1122=item $success = $term->grab ($eventtime[, $sync])
1123
1124Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or
1125synchronous (C<$sync> is true). Also remembers the grab timestampe.
1126
1127=item $term->allow_events_async
1128
1129Calls XAllowEvents with AsyncBoth for the most recent grab.
1130
1131=item $term->allow_events_sync
1132
1133Calls XAllowEvents with SyncBoth for the most recent grab.
1134
1135=item $term->allow_events_replay
1136
1137Calls XAllowEvents with both ReplayPointer and ReplayKeyboard for the most
1138recent grab.
1139
1140=item $term->ungrab
1141
1142Calls XUngrab for the most recent grab. Is called automatically on
1143evaluation errors, as it is better to lose the grab in the error case as
1144the session.
1145
1102=back 1146=back
1103 1147
1104=cut 1148=cut
1105 1149
1106package urxvt::popup; 1150package urxvt::popup;
1129 $sep ||= "═"; 1173 $sep ||= "═";
1130 1174
1131 $self->add_item ({ 1175 $self->add_item ({
1132 rend => { normal => "\x1b[0;30;47m", hover => "\x1b[0;30;47m", active => "\x1b[0;30;47m" }, 1176 rend => { normal => "\x1b[0;30;47m", hover => "\x1b[0;30;47m", active => "\x1b[0;30;47m" },
1133 text => "", 1177 text => "",
1134 render => sub { $sep x $urxvt::TERM->ncol }, 1178 render => sub { $sep x $self->{term}->ncol },
1135 activate => sub { }, 1179 activate => sub { },
1136 }); 1180 });
1137} 1181}
1138 1182
1139sub add_title { 1183sub add_title {
1147} 1191}
1148 1192
1149sub add_button { 1193sub add_button {
1150 my ($self, $text, $cb) = @_; 1194 my ($self, $text, $cb) = @_;
1151 1195
1152 $self->add_item ({ type => "button", text => "[ $text ]", activate => $cb}); 1196 $self->add_item ({ type => "button", text => $text, activate => $cb});
1153} 1197}
1154 1198
1155sub add_toggle { 1199sub add_toggle {
1156 my ($self, $text, $cb, $value) = @_; 1200 my ($self, $text, $cb, $value) = @_;
1157 1201
1158 my $item; $item = { 1202 my $item; $item = {
1159 type => "button", 1203 type => "button",
1160 text => " $text", 1204 text => " $text",
1161 value => $value, 1205 value => $value,
1162 render => sub { ($item->{value} ? "* " : " ") . $text }, 1206 render => sub { ($_[0]{value} ? "* " : " ") . $text },
1163 activate => sub { $cb->($item->{value} = !$item->{value}); }, 1207 activate => sub { $cb->($_[0]{value} = !$_[0]{value}); },
1164 }; 1208 };
1165 1209
1166 $self->add_item ($item); 1210 $self->add_item ($item);
1167} 1211}
1168 1212
1169sub show { 1213sub show {
1170 my ($self) = @_; 1214 my ($self) = @_;
1171 1215
1172 local $urxvt::popup::self = $self; 1216 local $urxvt::popup::self = $self;
1173 1217
1218 local $ENV{LC_ALL} = $self->{term}->locale;
1219
1174 urxvt->new ("--perl-lib" => "", "--perl-ext-common" => "", "-pty-fd" => -1, "-sl" => 0, "-b" => 0, 1220 urxvt->new ("--perl-lib" => "", "--perl-ext-common" => "", "-pty-fd" => -1, "-sl" => 0, "-b" => 0,
1175 "--transient-for" => $self->{term}->parent, 1221 "--transient-for" => $self->{term}->parent,
1222 "-display" => $self->{term}->display_id,
1176 "-pe" => "urxvt-popup") 1223 "-pe" => "urxvt-popup")
1177 or die "unable to create popup window\n"; 1224 or die "unable to create popup window\n";
1178} 1225}
1179 1226
1180sub DESTROY { 1227sub DESTROY {
1181 my ($self) = @_; 1228 my ($self) = @_;
1182 1229
1230 delete $self->{term}{_destroy}{$self};
1183 $self->{term}->ungrab; 1231 $self->{term}->ungrab;
1184} 1232}
1185 1233
1186=head2 The C<urxvt::timer> Class 1234=head2 The C<urxvt::timer> Class
1187 1235
1291This variable controls the verbosity level of the perl extension. Higher 1339This variable controls the verbosity level of the perl extension. Higher
1292numbers indicate more verbose output. 1340numbers indicate more verbose output.
1293 1341
1294=over 4 1342=over 4
1295 1343
1296=item =0 - only fatal messages 1344=item == 0 - fatal messages
1297 1345
1298=item =3 - script loading and management 1346=item >= 3 - script loading and management
1299 1347
1300=item =10 - all events received 1348=item >=10 - all events received
1301 1349
1302=back 1350=back
1303 1351
1304=head1 AUTHOR 1352=head1 AUTHOR
1305 1353

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines