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.111 by root, Thu Jan 19 19:52:54 2006 UTC vs.
Revision 1.112 by root, Thu Jan 19 21:02:06 2006 UTC

… …
303called whenever the relevant event happens. 303called whenever the relevant event happens.
304 304
305The 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
306the in the C<Extension Objects> section. 306the in the C<Extension Objects> section.
307 307
308B<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
309event 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
310skipped, and the relevant action might not be carried out by the C++ code. 310relevant action might not be carried out by the C++ code.
311 311
312I<< When in doubt, return a false value (preferably C<()>). >> 312I<< When in doubt, return a false value (preferably C<()>). >>
313 313
314=over 4 314=over 4
315 315
316=item on_init $term 316=item on_init $term
317 317
318Called after a new terminal object has been initialized, but before 318Called after a new terminal object has been initialized, but before
319windows 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
320call or deliver senseless data, as terminal size and other characteristics 320call or deliver senseless data, as terminal size and other characteristics
321have not yet been determined. You can safely query and change resources, 321have not yet been determined. You can safely query and change resources
322though. 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.
323 329
324=item on_reset $term 330=item on_reset $term
325 331
326Called 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
327control 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
328variables. 334variables.
329
330=item on_start $term
331
332Called at the very end of initialisation of a new terminal, just before
333returning to the mainloop.
334 335
335=item on_child_start $term, $pid 336=item on_child_start $term, $pid
336 337
337Called just after the child process has been C<fork>ed. 338Called just after the child process has been C<fork>ed.
338 339
… …
734 if $verbosity >= 10; 735 if $verbosity >= 10;
735 736
736 keys %$cb; 737 keys %$cb;
737 738
738 while (my ($pkg, $cb) = each %$cb) { 739 while (my ($pkg, $cb) = each %$cb) {
739 $retval = eval { $cb->($TERM->{_pkg}{$pkg}, @_) } 740 $retval ||= eval { $cb->($TERM->{_pkg}{$pkg}, @_) };
740 and last;
741 741
742 if ($@) { 742 if ($@) {
743 $TERM->ungrab; # better to lose the grab than the session 743 $TERM->ungrab; # better to lose the grab than the session
744 warn $@; 744 warn $@;
745 } 745 }

Diff Legend

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