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.110 by root, Thu Jan 19 16:22:13 2006 UTC vs.
Revision 1.112 by root, Thu Jan 19 21:02:06 2006 UTC

34find them in F<@@RXVT_LIBDIR@@/urxvt/perl/>. 34find them in F<@@RXVT_LIBDIR@@/urxvt/perl/>.
35 35
36You can activate them like this: 36You can activate them like this:
37 37
38 @@RXVT_NAME@@ -pe <extensionname> 38 @@RXVT_NAME@@ -pe <extensionname>
39
40Or by adding them to the resource for extensions loaded by default:
41
42 URxvt.perl-ext-common: default,automove-background,selection-autotransform
39 43
40=over 4 44=over 4
41 45
42=item selection (enabled by default) 46=item selection (enabled by default)
43 47
299called whenever the relevant event happens. 303called whenever the relevant event happens.
300 304
301The first argument passed to them is an extension oject as described in 305The first argument passed to them is an extension oject as described in
302the in the C<Extension Objects> section. 306the in the C<Extension Objects> section.
303 307
304B<All> of these hooks must return a boolean value. If it is true, then the 308B<All> of these hooks must return a boolean value. If any of the called
305event counts as being I<consumed>, and the invocation of other hooks is 309hooks returns true, then the event counts as being I<consumed>, and the
306skipped, and the relevant action might not be carried out by the C++ code. 310relevant action might not be carried out by the C++ code.
307 311
308I<< When in doubt, return a false value (preferably C<()>). >> 312I<< When in doubt, return a false value (preferably C<()>). >>
309 313
310=over 4 314=over 4
311 315
312=item on_init $term 316=item on_init $term
313 317
314Called after a new terminal object has been initialized, but before 318Called after a new terminal object has been initialized, but before
315windows are created or the command gets run. Most methods are unsafe to 319windows are created or the command gets run. Most methods are unsafe to
316call or deliver senseless data, as terminal size and other characteristics 320call or deliver senseless data, as terminal size and other characteristics
317have not yet been determined. You can safely query and change resources, 321have not yet been determined. You can safely query and change resources
318though. 322and options, though. For many purposes the C<on_start> hook is a better
323place.
324
325=item on_start $term
326
327Called at the very end of initialisation of a new terminal, just before
328returning to the mainloop.
319 329
320=item on_reset $term 330=item on_reset $term
321 331
322Called after the screen is "reset" for any reason, such as resizing or 332Called after the screen is "reset" for any reason, such as resizing or
323control sequences. Here is where you can react on changes to size-related 333control sequences. Here is where you can react on changes to size-related
324variables. 334variables.
325
326=item on_start $term
327
328Called at the very end of initialisation of a new terminal, just before
329returning to the mainloop.
330 335
331=item on_child_start $term, $pid 336=item on_child_start $term, $pid
332 337
333Called just after the child process has been C<fork>ed. 338Called just after the child process has been C<fork>ed.
334 339
730 if $verbosity >= 10; 735 if $verbosity >= 10;
731 736
732 keys %$cb; 737 keys %$cb;
733 738
734 while (my ($pkg, $cb) = each %$cb) { 739 while (my ($pkg, $cb) = each %$cb) {
735 $retval = eval { $cb->($TERM->{_pkg}{$pkg}, @_) } 740 $retval ||= eval { $cb->($TERM->{_pkg}{$pkg}, @_) };
736 and last;
737 741
738 if ($@) { 742 if ($@) {
739 $TERM->ungrab; # better to lose the grab than the session 743 $TERM->ungrab; # better to lose the grab than the session
740 warn $@; 744 warn $@;
741 } 745 }

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines