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.144 by root, Mon Aug 7 15:59:44 2006 UTC vs.
Revision 1.153 by root, Sat Jun 2 05:23:11 2007 UTC

… …
240 URxvt.tabbed.tab-bg: <colour-index, default 1> 240 URxvt.tabbed.tab-bg: <colour-index, default 1>
241 241
242See I<COLOR AND GRAPHICS> in the @@RXVT_NAME@@(1) manpage for valid 242See I<COLOR AND GRAPHICS> in the @@RXVT_NAME@@(1) manpage for valid
243indices. 243indices.
244 244
245=item mark-urls 245=item matcher
246 246
247Uses per-line display filtering (C<on_line_update>) to underline urls and 247Uses per-line display filtering (C<on_line_update>) to underline text
248make them clickable. When middle-clicked, the program specified in the 248matching a certain pattern and make it clickable. When clicked with the
249resource C<urlLauncher> (default C<x-www-browser>) will be started with 249mouse button specified in the C<matcher.button> resource (default 2, or
250the URL as first argument. 250middle), the program specified in the C<matcher.launcher> resource
251(default, the C<urlLauncher> resource, C<sensible-browser>) will be started
252with the matched text as first argument. The default configuration is
253suitable for matching URLs and launching a web browser, like the
254former "mark-urls" extension.
255
256The default pattern to match URLs can be overridden with the
257C<matcher.pattern.0> resource, and additional patterns can be specified
258with numbered patterns, in a manner similar to the "selection" extension.
259The launcher can also be overridden on a per-pattern basis.
260
261Example configuration:
262
263 URxvt.perl-ext: default,matcher
264 URxvt.urlLauncher: sensible-browser
265 URxvt.keysym.C-Delete: perl:matcher
266 URxvt.matcher.button: 1
267 URxvt.matcher.pattern.1: \\bwww\\.[\\w-]+\\.[\\w./?&@#-]*[\\w/-]
268 URxvt.matcher.pattern.2: \\B(/\\S+?):(\\d+)(?=:|$)
269 URxvt.matcher.launcher.2: gvim +$2 $1
251 270
252=item xim-onthespot 271=item xim-onthespot
253 272
254This (experimental) perl extension implements OnTheSpot editing. It does 273This (experimental) perl extension implements OnTheSpot editing. It does
255not work perfectly, and some input methods don't seem to work well with 274not work perfectly, and some input methods don't seem to work well with
… …
287same effect as pseudo transparency with a custom pixmap. No scaling is 306same effect as pseudo transparency with a custom pixmap. No scaling is
288supported in this mode. Example: 307supported in this mode. Example:
289 308
290 @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background 309 @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background
291 310
311L<http://wiki.archlinux.org/index.php/Perl_Background_Rotation/Extensions>
312shows how this extension can be used to implement an automatically blurred
313transparent background.
314
292=item block-graphics-to-ascii 315=item block-graphics-to-ascii
293 316
294A not very useful example of filtering all text output to the terminal 317A not very useful example of filtering all text output to the terminal
295by replacing all line-drawing characters (U+2500 .. U+259F) by a 318by replacing all line-drawing characters (U+2500 .. U+259F) by a
296similar-looking ascii character. 319similar-looking ascii character.
… …
345After a successful upload the selection will be replaced by the text given 368After a successful upload the selection will be replaced by the text given
346in the C<selection-pastebin-url> resource (again, the % is the placeholder 369in the C<selection-pastebin-url> resource (again, the % is the placeholder
347for the filename): 370for the filename):
348 371
349 URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/% 372 URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/%
373
374I<Note to xrdb users:> xrdb uses the C preprocessor, which might interpret
375the double C</> characters as comment start. Use C<\057\057> instead,
376which works regardless of wether xrdb is used to parse the resource file
377or not.
350 378
351=item example-refresh-hooks 379=item example-refresh-hooks
352 380
353Displays a very simple digital clock in the upper right corner of the 381Displays a very simple digital clock in the upper right corner of the
354window. Illustrates overwriting the refresh callbacks to create your own 382window. Illustrates overwriting the refresh callbacks to create your own
… …
395=back 423=back
396 424
397=head2 Extension Objects 425=head2 Extension Objects
398 426
399Every perl extension is a perl class. A separate perl object is created 427Every perl extension is a perl class. A separate perl object is created
400for each terminal and each extension and passed as the first parameter to 428for each terminal, and each terminal has its own set of extenion objects,
401hooks. So extensions can use their C<$self> object without having to think 429which are passed as the first parameter to hooks. So extensions can use
402about other extensions, with the exception of methods and members that 430their C<$self> object without having to think about clashes with other
431extensions or other terminals, with the exception of methods and members
403begin with an underscore character C<_>: these are reserved for internal 432that begin with an underscore character C<_>: these are reserved for
404use. 433internal use.
405 434
406Although it isn't a C<urxvt::term> object, you can call all methods of the 435Although it isn't a C<urxvt::term> object, you can call all methods of the
407C<urxvt::term> class on this object. 436C<urxvt::term> class on this object.
408 437
409It has the following methods and data members: 438It has the following methods and data members:
… …
966 995
967sub SET_COLOR($$$) { 996sub SET_COLOR($$$) {
968 SET_BGCOLOR (SET_FGCOLOR ($_[0], $_[1]), $_[2]) 997 SET_BGCOLOR (SET_FGCOLOR ($_[0], $_[1]), $_[2])
969} 998}
970 999
1000sub rend2mask {
1001 no strict 'refs';
1002 my ($str, $mask) = (@_, 0);
1003 my %color = ( fg => undef, bg => undef );
1004 my @failed;
1005 for my $spec ( split /\s+/, $str ) {
1006 if ( $spec =~ /^([fb]g)[_:-]?(\d+)/i ) {
1007 $color{lc($1)} = $2;
1008 } else {
1009 my $neg = $spec =~ s/^[-^]//;
1010 unless ( exists &{"RS_$spec"} ) {
1011 push @failed, $spec;
1012 next;
1013 }
1014 my $cur = &{"RS_$spec"};
1015 if ( $neg ) {
1016 $mask &= ~$cur;
1017 } else {
1018 $mask |= $cur;
1019 }
1020 }
1021 }
1022 ($mask, @color{qw(fg bg)}, \@failed)
1023}
1024
971# urxvt::term::extension 1025# urxvt::term::extension
972 1026
973package urxvt::term::extension; 1027package urxvt::term::extension;
974 1028
975sub enable { 1029sub enable {
… …
1086sub DESTROY { 1140sub DESTROY {
1087 $_[0][1]->stop; 1141 $_[0][1]->stop;
1088} 1142}
1089 1143
1090sub condvar { 1144sub condvar {
1091 bless \my $flag, urxvt::anyevent::condvar:: 1145 bless \my $flag, urxvt::anyevent::
1092} 1146}
1093 1147
1094sub urxvt::anyevent::condvar::broadcast { 1148sub broadcast {
1095 ${$_[0]}++; 1149 ${$_[0]}++;
1096} 1150}
1097 1151
1098sub urxvt::anyevent::condvar::wait { 1152sub wait {
1099 unless (${$_[0]}) { 1153 unless (${$_[0]}) {
1100 Carp::croak "AnyEvent->condvar blocking wait unsupported in urxvt, use a non-blocking API"; 1154 Carp::croak "AnyEvent->condvar blocking wait unsupported in urxvt, use a non-blocking API";
1101 } 1155 }
1156}
1157
1158sub one_event {
1159 Carp::croak "AnyEvent->one_event blocking wait unsupported in urxvt, use a non-blocking API";
1102} 1160}
1103 1161
1104package urxvt::term; 1162package urxvt::term;
1105 1163
1106=head2 The C<urxvt::term> Class 1164=head2 The C<urxvt::term> Class
… …
1926 1984
1927=cut 1985=cut
1928 1986
1929package urxvt::watcher; 1987package urxvt::watcher;
1930 1988
1931@urxvt::timer::ISA = __PACKAGE__;
1932@urxvt::iow::ISA = __PACKAGE__;
1933@urxvt::pw::ISA = __PACKAGE__;
1934@urxvt::iw::ISA = __PACKAGE__;
1935
1936=head2 The C<urxvt::timer> Class 1989=head2 The C<urxvt::timer> Class
1937 1990
1938This class implements timer watchers/events. Time is represented as a 1991This class implements timer watchers/events. Time is represented as a
1939fractional number of seconds since the epoch. Example: 1992fractional number of seconds since the epoch. Example:
1940 1993
… …
2125 http://software.schmorp.de/pkg/rxvt-unicode 2178 http://software.schmorp.de/pkg/rxvt-unicode
2126 2179
2127=cut 2180=cut
2128 2181
21291 21821
2183
2184# vim: sw=3:

Diff Legend

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