--- cvsroot/EV/README	2009/04/28 00:50:57	1.32
+++ cvsroot/EV/README	2009/07/17 14:49:33	1.33
@@ -4,50 +4,50 @@
 
 SYNOPSIS
        use EV;
-       
-   # TIMERS
-       
-   my $w = EV::timer 2, 0, sub {
+   
+       # TIMERS
+   
+       my $w = EV::timer 2, 0, sub {
           warn "is called after 2s";
        };
-       
-   my $w = EV::timer 2, 2, sub {
+   
+       my $w = EV::timer 2, 2, sub {
           warn "is called roughly every 2s (repeat = 2)";
        };
-       
-   undef $w; # destroy event watcher again
-       
-   my $w = EV::periodic 0, 60, 0, sub {
+   
+       undef $w; # destroy event watcher again
+   
+       my $w = EV::periodic 0, 60, 0, sub {
           warn "is called every minute, on the minute, exactly";
        };
-       
-   # IO
-       
-   my $w = EV::io *STDIN, EV::READ, sub {
+   
+       # IO
+   
+       my $w = EV::io *STDIN, EV::READ, sub {
           my ($w, $revents) = @_; # all callbacks receive the watcher and event mask
           warn "stdin is readable, you entered: ", <STDIN>;
        };
-       
-   # SIGNALS
-       
-   my $w = EV::signal 'QUIT', sub {
+   
+       # SIGNALS
+   
+       my $w = EV::signal 'QUIT', sub {
           warn "sigquit received\n";
        };
-       
-   # CHILD/PID STATUS CHANGES
-      
-   my $w = EV::child 666, 0, sub {
+   
+       # CHILD/PID STATUS CHANGES
+  
+       my $w = EV::child 666, 0, sub {
           my ($w, $revents) = @_;
           my $status = $w->rstatus;
        };
-      
-   # STAT CHANGES
+  
+       # STAT CHANGES
        my $w = EV::stat "/etc/passwd", 10, sub {
           my ($w, $revents) = @_;
           warn $w->path, " has changed somehow.\n";
        };
-       
-   # MAINLOOP
+   
+       # MAINLOOP
        EV::loop;           # loop until EV::unloop is called or all watchers stop
        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
@@ -265,6 +265,14 @@
         ROLLING_THE_EVENT_LOOP> (locally installed as EV::libev) for a more
         detailed discussion.
 
+    $count = EV::pending_count
+    $count = $loop->pending_count
+        Returns the number of currently pending watchers.
+
+    EV::invoke_pending
+    $loop->invoke_pending
+        Invoke all currently pending watchers.
+
 WATCHER OBJECTS
     A watcher is an object that gets created to record your interest in some
     event. For instance, if you want to wait for STDIN to become readable,
@@ -822,8 +830,8 @@
     kqueue to still be able to handle a large number of sockets:
 
        my $socket_loop;
-      
-   # check wether we use SELECT or POLL _and_ KQUEUE is supported
+  
+       # check wether we use SELECT or POLL _and_ KQUEUE is supported
        if (
          (EV::backend & (EV::BACKEND_POLL | EV::BACKEND_SELECT))
          && (EV::supported_backends & EV::embeddable_backends & EV::BACKEND_KQUEUE)
@@ -831,8 +839,8 @@
          # use kqueue for sockets
          $socket_loop = new EV::Loop EV::BACKEND_KQUEUE | EV::FLAG_NOENV;
        }
-      
-   # use the default loop otherwise
+  
+       # use the default loop otherwise
        $socket_loop ||= EV::default_loop;
 
     $w = EV::embed $otherloop[, $callback]
@@ -849,8 +857,8 @@
 
    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.
+    as perl neither supports threads running in parallel 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.
 
@@ -879,10 +887,11 @@
     This ensures that perl gets into control for a short time to handle any
     pending signals, and also ensures (slightly) slower overall operation.
 
-THREADS
-    Threads are not supported by this module in any way. Perl pseudo-threads
-    is evil stuff and must die. As soon as Perl gains real threads I will
-    work on thread support for it.
+ITHREADS
+    Ithreads are not supported by this module in any way. Perl
+    pseudo-threads is evil stuff and must die. Real threads as provided by
+    Coro are fully supported (and enhanced support is available via
+    Coro::EV).
 
 FORK
     Most of the "improved" event delivering mechanisms of modern operating