--- cvsroot/EV/EV.pm	2008/04/26 03:34:24	1.90
+++ cvsroot/EV/EV.pm	2008/05/20 23:54:05	1.94
@@ -58,10 +58,10 @@
 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
@@ -76,7 +76,7 @@
 use strict;
 
 BEGIN {
-   our $VERSION = '3.31';
+   our $VERSION = '3.4';
    use XSLoader;
    XSLoader::load "EV", $VERSION;
 }
@@ -570,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