--- cvsroot/EV/EV.pm	2009/12/01 13:56:33	1.124
+++ cvsroot/EV/EV.pm	2010/03/28 15:48:21	1.127
@@ -53,6 +53,15 @@
    EV::loop EV::LOOP_ONESHOT;  # block until at least one event could be handled
    EV::loop EV::LOOP_NONBLOCK; # try to handle same events, but do not block
 
+=head1 BEFORE YOU START USING THIS MODULE
+
+If you only need timer, I/O, signal, child and idle watchers and not the
+advanced functionality of this module, consider using L<AnyEvent> instead,
+specifically the simplified API described in L<AE>.
+
+When used with EV as backend, the L<AE> API is as fast as the native L<EV>
+API, but your programs/modules will still run with many other event loops.
+
 =head1 DESCRIPTION
 
 This module provides an interface to libev
@@ -81,7 +90,7 @@
 use common::sense;
 
 BEGIN {
-   our $VERSION = '3.8';
+   our $VERSION = '4.00';
    use XSLoader;
    XSLoader::load "EV", $VERSION;
 }
@@ -301,7 +310,7 @@
 When an error occurs or either the timeout or I/O watcher triggers, then
 the callback will be called with the received event set (in general
 you can expect it to be a combination of C<EV::ERROR>, C<EV::READ>,
-C<EV::WRITE> and C<EV::TIMEOUT>).
+C<EV::WRITE> and C<EV::TIMER>).
 
 EV::once doesn't return anything: the watchers stay active till either
 of them triggers, then they will be stopped and freed, and the callback
@@ -368,8 +377,7 @@
 same callback for multiple watchers. The event mask is named after the
 type, i.e. EV::child sets EV::CHILD, EV::prepare sets EV::PREPARE,
 EV::periodic sets EV::PERIODIC and so on, with the exception of I/O events
-(which can set both EV::READ and EV::WRITE bits), and EV::timer (which
-uses EV::TIMEOUT).
+(which can set both EV::READ and EV::WRITE bits).
 
 In the rare case where one wants to create a watcher but not start it at
 the same time, each constructor has a variant with a trailing C<_ns> in