--- cvsroot/EV/EV.pm	2008/04/15 04:41:57	1.87
+++ cvsroot/EV/EV.pm	2008/05/21 23:35:00	1.95
@@ -58,10 +58,16 @@
 This module provides an interface to libev
 (L<http://software.schmorp.de/pkg/libev.html>). While the documentation
 below is comprehensive, one might also consult the documentation of libev
-itself (L<http://cvs.schmorp.de/libev/ev.html>) for more subtle details on
-watcher semantics or some discussion on the available backends, or how to
-force a specific backend with C<LIBEV_FLAGS>, or just about in any case
-because it has much more detailed information.
+itself (L<http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod>) for more
+subtle details on watcher semantics or some discussion on the available
+backends, or how to force a specific backend with C<LIBEV_FLAGS>, or just
+about in any case because it has much more detailed information.
+
+This module is very fast and scalable. It is actually so fast that you
+can use it through the L<AnyEvent> module, stay portable to other event
+loops (if you don't rely on any watcher types not available through it)
+and still be faster than with any other event loop currently supported in
+Perl.
 
 =cut
 
@@ -70,7 +76,7 @@
 use strict;
 
 BEGIN {
-   our $VERSION = '3.2';
+   our $VERSION = '3.41';
    use XSLoader;
    XSLoader::load "EV", $VERSION;
 }
@@ -564,13 +570,14 @@
 time as second argument.
 
 I<This callback MUST NOT stop or destroy this or any other periodic
-watcher, ever>. If you need to stop it, return 1e30 and stop it
-afterwards.
+watcher, ever, and MUST NOT call any event loop functions or methods>. If
+you need to stop it, return 1e30 and stop it afterwards. You may create
+and start a C<EV::prepare> watcher for this task.
 
 It must return the next time to trigger, based on the passed time value
-(that is, the lowest time value larger than to the second argument). It
-will usually be called just before the callback will be triggered, but
-might be called at other times, too.
+(that is, the lowest time value larger than or equal to to the second
+argument). It will usually be called just before the callback will be
+triggered, but might be called at other times, too.
 
 This can be used to create very complex timers, such as a timer that
 triggers on each midnight, local time (actually 24 hours after the last
@@ -1051,7 +1058,8 @@
 
 L<EV::ADNS> (asynchronous DNS), L<Glib::EV> (makes Glib/Gtk2 use EV as
 event loop), L<EV::Glib> (embed Glib into EV), L<Coro::EV> (efficient
-coroutines with EV), L<Net::SNMP::EV> (asynchronous SNMP).
+coroutines with EV), L<Net::SNMP::EV> (asynchronous SNMP), L<AnyEvent> for
+event-loop agnostic and portable event driven programming.
 
 =head1 AUTHOR