--- AnyEvent/lib/AnyEvent.pm	2008/04/24 03:19:28	1.57
+++ AnyEvent/lib/AnyEvent.pm	2008/04/25 01:05:26	1.60
@@ -209,15 +209,16 @@
 in 10 seconds") and based on wallclock time (absolute, "fire at 12
 o'clock").
 
-While most event loops expect timers to specified in a relative way, they use
-absolute time internally. This makes a difference when your clock "jumps",
-for example, when ntp decides to set your clock backwards from the wrong 2014-01-01 to
-2008-01-01, a watcher that you created to fire "after" a second might actually take
-six years to finally fire.
+While most event loops expect timers to specified in a relative way, they
+use absolute time internally. This makes a difference when your clock
+"jumps", for example, when ntp decides to set your clock backwards from
+the wrong date of 2014-01-01 to 2008-01-01, a watcher that is supposed to
+fire "after" a second might actually take six years to finally fire.
 
 AnyEvent cannot compensate for this. The only event loop that is conscious
-about these issues is L<EV>, which offers both relative (ev_timer) and
-absolute (ev_periodic) timers.
+about these issues is L<EV>, which offers both relative (ev_timer, based
+on true relative time) and absolute (ev_periodic, based on wallclock time)
+timers.
 
 AnyEvent always prefers relative timers, if available, matching the
 AnyEvent API.
@@ -228,7 +229,7 @@
 I<name> without any C<SIG> prefix, C<cb> is the Perl callback to
 be invoked whenever a signal occurs.
 
-Multiple signals occurances can be clumped together into one callback
+Multiple signal occurances can be clumped together into one callback
 invocation, and callback invocation will be synchronous. synchronous means
 that it might take a while until the signal gets handled by the process,
 but it is guarenteed not to interrupt any other callbacks.
@@ -423,7 +424,7 @@
 
 use Carp;
 
-our $VERSION = '3.12';
+our $VERSION = '3.2';
 our $MODEL;
 
 our $AUTOLOAD;
@@ -458,6 +459,8 @@
          if (eval "require $model") {
             $MODEL = $model;
             warn "AnyEvent: loaded model '$model' (forced by \$PERL_ANYEVENT_MODEL), using it.\n" if $verbose > 1;
+         } else {
+            warn "AnyEvent: unable to load model '$model' (from \$PERL_ANYEVENT_MODEL):\n$@" if $verbose;
          }
       }
 
@@ -660,6 +663,14 @@
 
 =item C<PERL_ANYEVENT_VERBOSE>
 
+By default, AnyEvent will be completely silent except in fatal
+conditions. You can set this environment variable to make AnyEvent more
+talkative.
+
+When set to C<1> or higher, causes AnyEvent to warn about unexpected
+conditions, such as not being able to load the event model specified by
+C<PERL_ANYEVENT_MODEL>.
+
 When set to C<2> or higher, cause AnyEvent to report to STDERR which event
 model it chooses.