--- cvsroot/EV/README	2009/07/17 14:49:33	1.33
+++ cvsroot/EV/README	2010/10/21 02:46:59	1.36
@@ -52,6 +52,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
 
+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 AnyEvent instead,
+    specifically the simplified API described in AE.
+
+    When used with EV as backend, the AE API is as fast as the native EV
+    API, but your programs/modules will still run with many other event
+    loops.
+
 DESCRIPTION
     This module provides an interface to libev
     (<http://software.schmorp.de/pkg/libev.html>). While the documentation
@@ -237,7 +246,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 "EV::ERROR",
-        "EV::READ", "EV::WRITE" and "EV::TIMEOUT").
+        "EV::READ", "EV::WRITE" and "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
@@ -292,8 +301,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).
+    events (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 "_ns" in
@@ -368,7 +376,7 @@
     $previous_state = $w->keepalive ($bool)
         Normally, "EV::loop" will return when there are no active watchers
         (which is a "deadlock" because no progress can be made anymore).
-        This is convinient because it allows you to start your watchers (and
+        This is convenient because it allows you to start your watchers (and
         your jobs), call "EV::loop" once and when it returns you know that
         all your jobs are finished (or they forgot to register some watchers
         for their task :).
@@ -569,9 +577,15 @@
    SIGNAL WATCHERS - signal me when a signal gets signalled!
     $w = EV::signal $signal, $callback
     $w = EV::signal_ns $signal, $callback
+    $w = $loop->signal ($signal, $callback)
+    $w = $loop->signal_ns ($signal, $callback)
         Call the callback when $signal is received (the signal can be
         specified by number or by name, just as with "kill" or %SIG).
 
+        Only one event loop can grab a given signal - attempting to grab the
+        same signal from two EV loops will crash the program immediately or
+        cause data corruption.
+
         EV will grab the signal for the process (the kernel only allows one
         component to receive a signal at a time) when you start a signal
         watcher, and removes it again when you stop it. Perl does the same