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.203 by sf-exg, Fri Dec 2 09:03:43 2011 UTC vs.
Revision 1.214 by root, Wed Jun 6 15:26:32 2012 UTC

762use Scalar::Util (); 762use Scalar::Util ();
763use List::Util (); 763use List::Util ();
764 764
765our $VERSION = 1; 765our $VERSION = 1;
766our $TERM; 766our $TERM;
767our @TERM_INIT; 767our @TERM_INIT; # should go, prevents async I/O etc.
768our @TERM_EXT; 768our @TERM_EXT; # should go, prevents async I/O etc.
769our @HOOKNAME; 769our @HOOKNAME;
770our %HOOKTYPE = map +($HOOKNAME[$_] => $_), 0..$#HOOKNAME; 770our %HOOKTYPE = map +($HOOKNAME[$_] => $_), 0..$#HOOKNAME;
771our %OPTION; 771our %OPTION;
772 772
773our $LIBDIR; 773our $LIBDIR;
943 }; 943 };
944} 944}
945 945
946no warnings 'utf8'; 946no warnings 'utf8';
947 947
948sub parse_resource {
949 my ($term, $name, $isarg, $longopt, $flag, $value) = @_;
950
951 $term->scan_meta;
952
953 my $r = $term->{meta}{resource};
954 while (my ($pattern, $v) = each %$r) {
955 $name =~ y/-/./ if $isarg;
956
957 if (
958 $pattern =~ /\.$/
959 ? $pattern eq substr $name, 0, length $pattern
960 : $pattern eq $name
961 ) {
962 $name = "$urxvt::RESCLASS.$name";
963
964 push @TERM_EXT, $v->[0];
965
966 if ($v->[1] eq "boolean") {
967 $term->put_option_db ($name, $flag ? "true" : "false");
968 return 1;
969 } else {
970 $term->put_option_db ($name, $value);
971 return 1 + 2;
972 }
973 }
974 }
975
976 0
977}
978
979sub usage {
980 my ($term, $usage_type) = @_;
981
982 $term->scan_meta;
983
984 my $r = $term->{meta}{resource};
985
986 for my $pattern (sort keys %$r) {
987 my ($ext, $type, $desc) = @{ $r->{$pattern} };
988
989 $desc .= " (-pe $ext)";
990
991 if ($usage_type == 1) {
992 $pattern =~ y/./-/;
993 $pattern =~ s/-$/-.../g;
994
995 if ($type eq "boolean") {
996 urxvt::log sprintf " -%-30s %s\n", "/+$pattern", $desc;
997 } else {
998 urxvt::log sprintf " -%-30s %s\n", "$pattern $type", $desc;
999 }
1000 } else {
1001 $pattern =~ s/\.$/.*/g;
1002 urxvt::log sprintf " %-31s %s\n", "$pattern:", $type;
1003 }
1004 }
1005}
1006
948my $verbosity = $ENV{URXVT_PERL_VERBOSITY}; 1007my $verbosity = $ENV{URXVT_PERL_VERBOSITY};
949 1008
950sub verbose { 1009sub verbose {
951 my ($level, $msg) = @_; 1010 my ($level, $msg) = @_;
952 warn "$msg\n" if $level <= $verbosity; 1011 warn "$msg\n" if $level <= $verbosity;
988sub invoke { 1047sub invoke {
989 local $TERM = shift; 1048 local $TERM = shift;
990 my $htype = shift; 1049 my $htype = shift;
991 1050
992 if ($htype == 0) { # INIT 1051 if ($htype == 0) { # INIT
993 my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$ENV{HOME}/.urxvt/ext", "$LIBDIR/perl"); 1052 my @dirs = $TERM->perl_libdirs;
994 1053
995 my %ext_arg; 1054 my %ext_arg;
996 1055
997 { 1056 {
998 my @init = @TERM_INIT; 1057 my @init = @TERM_INIT;
1159=head2 The C<urxvt::anyevent> Class 1218=head2 The C<urxvt::anyevent> Class
1160 1219
1161The sole purpose of this class is to deliver an interface to the 1220The sole purpose of this class is to deliver an interface to the
1162C<AnyEvent> module - any module using it will work inside urxvt without 1221C<AnyEvent> module - any module using it will work inside urxvt without
1163further programming. The only exception is that you cannot wait on 1222further programming. The only exception is that you cannot wait on
1164condition variables, but non-blocking condvar use is ok. What this means 1223condition variables, but non-blocking condvar use is ok.
1165is that you cannot use blocking APIs, but the non-blocking variant should 1224
1166work. 1225In practical terms this means is that you cannot use blocking APIs, but
1226the non-blocking variant should work.
1167 1227
1168=cut 1228=cut
1169 1229
1170our $VERSION = '5.23'; 1230our $VERSION = '5.23';
1171 1231
1265 $self->{_pkg}{$pkg} = $proxy; 1325 $self->{_pkg}{$pkg} = $proxy;
1266 1326
1267 for my $name (@HOOKNAME) { 1327 for my $name (@HOOKNAME) {
1268 if (my $ref = $pkg->can ("on_" . lc $name)) { 1328 if (my $ref = $pkg->can ("on_" . lc $name)) {
1269 $proxy->enable ($name => $ref); 1329 $proxy->enable ($name => $ref);
1330 }
1331 }
1332}
1333
1334sub perl_libdirs {
1335 map { split /:/ }
1336 $_[0]->resource ("perl_lib"),
1337 $ENV{URXVT_PERL_LIB},
1338 "$ENV{HOME}/.urxvt/ext",
1339 "$LIBDIR/perl"
1340}
1341
1342sub scan_meta {
1343 my ($self) = @_;
1344 my @libdirs = perl_libdirs $self;
1345
1346 return if $self->{meta_libdirs} eq join "\x00", @libdirs;
1347
1348 my %meta;
1349
1350 $self->{meta_libdirs} = join "\x00", @libdirs;
1351 $self->{meta} = \%meta;
1352
1353 for my $dir (reverse @libdirs) {
1354 opendir my $fh, $dir
1355 or next;
1356 for my $ext (readdir $fh) {
1357 $ext ne "."
1358 and $ext ne ".."
1359 and open my $fh, "<", "$dir/$ext"
1360 or next;
1361
1362 while (<$fh>) {
1363 if (/^#:META:X_RESOURCE:(.*)/) {
1364 my ($pattern, $type, $desc) = split /:/, $1;
1365 $pattern =~ s/^%(\.|$)/$ext$1/g; # % in pattern == extension name
1366 if ($pattern =~ /[^a-zA-Z0-9\-\.]/) {
1367 warn "$dir/$ext: meta resource '$pattern' contains illegal characters (not alphanumeric nor . nor *)\n";
1368 } else {
1369 $meta{resource}{$pattern} = [$ext, $type, $desc];
1370 }
1371 } elsif (/^\s*(?:#|$)/) {
1372 # skip other comments and empty lines
1373 } else {
1374 last; # stop parsing on first non-empty non-comment line
1375 }
1376 }
1270 } 1377 }
1271 } 1378 }
1272} 1379}
1273 1380
1274=item $term = new urxvt::term $envhashref, $rxvtname, [arg...] 1381=item $term = new urxvt::term $envhashref, $rxvtname, [arg...]
1395 1502
1396This method should only be called during the C<on_start> hook, as there is 1503This method should only be called during the C<on_start> hook, as there is
1397only one resource database per display, and later invocations might return 1504only one resource database per display, and later invocations might return
1398the wrong resources. 1505the wrong resources.
1399 1506
1507=item $value = $term->x_resource_boolean ($pattern)
1508
1509Like C<x_resource>, above, but interprets the string value as a boolean
1510and returns C<1> for true values, C<0> for false values and C<undef> if
1511the resource or option isn't specified.
1512
1513You should always use this method to parse boolean resources.
1514
1515=cut
1516
1517sub x_resource_boolean {
1518 my $res = &x_resource;
1519
1520 $res =~ /^\s*(?:true|yes|on|1)\s*$/i ? 1 : defined $res && 0
1521}
1522
1400=item $success = $term->parse_keysym ($key, $octets) 1523=item $success = $term->parse_keysym ($key, $octets)
1401 1524
1402Adds a key binding exactly as specified via a resource. See the 1525Adds a key binding exactly as specified via a resource. See the
1403C<keysym> resource in the @@RXVT_NAME@@(1) manpage. 1526C<keysym> resource in the @@RXVT_NAME@@(1) manpage.
1404 1527
1628 1751
1629Adds the specified events to the vt event mask. Useful e.g. when you want 1752Adds the specified events to the vt event mask. Useful e.g. when you want
1630to receive pointer events all the times: 1753to receive pointer events all the times:
1631 1754
1632 $term->vt_emask_add (urxvt::PointerMotionMask); 1755 $term->vt_emask_add (urxvt::PointerMotionMask);
1756
1757=item $term->set_urgency ($set)
1758
1759Enable/disable the urgency hint on the toplevel window.
1633 1760
1634=item $term->focus_in 1761=item $term->focus_in
1635 1762
1636=item $term->focus_out 1763=item $term->focus_out
1637 1764

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines