--- AnyEvent/lib/AnyEvent.pm	2008/05/10 00:57:31	1.110
+++ AnyEvent/lib/AnyEvent.pm	2008/05/10 01:04:42	1.112
@@ -551,15 +551,16 @@
 have created an AnyEvent watcher anyway, that is, as late as possible at
 runtime.
 
-=item $guard = AnyEvent::on_detect { BLOCK }
+=item $guard = AnyEvent::post_detect { BLOCK }
 
 Arranges for the code block to be executed as soon as the event model is
 autodetected (or immediately if this has already happened).
 
 If called in scalar or list context, then it creates and returns an object
-that automatically removes the callback again when it is destroyed.
+that automatically removes the callback again when it is destroyed. See
+L<Coro::BDB> for a case where this is useful.
 
-=item @AnyEvent::on_detect
+=item @AnyEvent::post_detect
 
 If there are any code references in this array (you can C<push> to it
 before or after loading AnyEvent), then they will called directly after
@@ -569,7 +570,7 @@
 if it contains a true value then the event loop has already been detected,
 and the array will be ignored.
 
-Best use C<AnyEvent::on_detect { BLOCK }> instead.
+Best use C<AnyEvent::post_detect { BLOCK }> instead.
 
 =back
 
@@ -721,9 +722,9 @@
 
 our %method = map +($_ => 1), qw(io timer signal child condvar one_event DESTROY);
 
-our @on_detect;
+our @post_detect;
 
-sub on_detect(&) {
+sub post_detect(&) {
    my ($cb) = @_;
 
    if ($MODEL) {
@@ -731,7 +732,7 @@
 
       1
    } else {
-      push @on_detect, $cb;
+      push @post_detect, $cb;
 
       defined wantarray
          ? bless \$cb, "AnyEvent::Util::Guard"
@@ -740,7 +741,7 @@
 }
 
 sub AnyEvent::Util::Guard::DESTROY {
-   @on_detect = grep $_ != ${$_[0]}, @on_detect;
+   @post_detect = grep $_ != ${$_[0]}, @post_detect;
 }
 
 sub detect() {
@@ -792,7 +793,7 @@
       unshift @ISA, $MODEL;
       push @{"$MODEL\::ISA"}, "AnyEvent::Base";
 
-      (shift @on_detect)->() while @on_detect;
+      (shift @post_detect)->() while @post_detect;
    }
 
    $MODEL