--- cvsroot/EV/EV.pm	2008/01/28 12:24:05	1.83
+++ cvsroot/EV/EV.pm	2008/05/20 19:52:12	1.93
@@ -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.0';
+   our $VERSION = '3.4';
    use XSLoader;
    XSLoader::load "EV", $VERSION;
 }
@@ -86,6 +92,7 @@
 @EV::Check::ISA    =
 @EV::Embed::ISA    =
 @EV::Fork::ISA     =
+@EV::Async::ISA    =
    "EV::Watcher";
 
 @EV::Loop::Default::ISA = "EV::Loop";
@@ -535,7 +542,7 @@
 at January 1st 2011 then it will run when the system time reaches or
 surpasses this time.
 
-=item * non-repeating interval timer ($interval > 0, $reschedule_cb = 0)
+=item * repeating interval timer ($interval > 0, $reschedule_cb = 0)
 
 In this mode the watcher will always be scheduled to time out at the
 next C<$at + N * $interval> time (for some integer N) and then repeat,
@@ -970,6 +977,28 @@
 
 =back
 
+=head3 ASYNC WATCHERS - how to wake up another event loop
+
+Async watchers are provided by EV, but have little use in perl directly, as perl
+neither supports threads nor direct access to signal handlers or other
+contexts where they could be of value.
+
+It is, however, possible to use them from the XS level.
+
+Please see the libev documentation for further details.
+
+=over 4
+
+=item $w = EV::async $callback
+
+=item $w = EV::async_ns $callback
+
+=item $w->send
+
+=item $bool = $w->async_pending
+
+=back
+
 
 =head1 PERL SIGNALS
 
@@ -1028,7 +1057,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