--- IO-AIO/AIO.pm	2008/05/12 00:32:42	1.127
+++ IO-AIO/AIO.pm	2008/09/06 07:14:52	1.133
@@ -195,7 +195,7 @@
 use base 'Exporter';
 
 BEGIN {
-   our $VERSION = '3.02';
+   our $VERSION = '3.07';
 
    our @AIO_REQ = qw(aio_sendfile aio_read aio_write aio_open aio_close
                      aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir
@@ -1015,10 +1015,11 @@
 C<done> state, they will also finish. Otherwise they will continue to
 exist.
 
-That means after creating a group you have some time to add requests. And
-in the callbacks of those requests, you can add further requests to the
-group. And only when all those requests have finished will the the group
-itself finish.
+That means after creating a group you have some time to add requests
+(precisely before the callback has been invoked, which is only done within
+the C<poll_cb>). And in the callbacks of those requests, you can add
+further requests to the group. And only when all those requests have
+finished will the the group itself finish.
 
 =over 4
 
@@ -1119,12 +1120,14 @@
 =item IO::AIO::poll_cb
 
 Process some outstanding events on the result pipe. You have to call this
-regularly. Returns the number of events processed. Returns immediately
-when no events are outstanding. The amount of events processed depends on
-the settings of C<IO::AIO::max_poll_req> and C<IO::AIO::max_poll_time>.
+regularly. Returns C<0> if all events could be processed, or C<-1> if it
+returned earlier for whatever reason. Returns immediately when no events
+are outstanding. The amount of events processed depends on the settings of
+C<IO::AIO::max_poll_req> and C<IO::AIO::max_poll_time>.
 
 If not all requests were processed for whatever reason, the filehandle
-will still be ready when C<poll_cb> returns.
+will still be ready when C<poll_cb> returns, so normally you don't have to
+do anything special to have it called later.
 
 Example: Install an Event watcher that automatically calls
 IO::AIO::poll_cb with high priority: