--- IO-AIO/AIO.pm	2008/05/11 01:08:05	1.126
+++ IO-AIO/AIO.pm	2008/09/30 03:50:59	1.135
@@ -195,7 +195,7 @@
 use base 'Exporter';
 
 BEGIN {
-   our $VERSION = '3.01';
+   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
@@ -567,7 +567,7 @@
 destination) from C<$srcpath> to C<$dstpath> and call the callback with
 the C<0> (error) or C<-1> ok.
 
-This is a composite request that it creates the destination file with
+This is a composite request that creates the destination file with
 mode 0200 and copies the contents of the source file into it using
 C<aio_sendfile>, followed by restoring atime, mtime, access mode and
 uid/gid, in that order.
@@ -860,7 +860,7 @@
 =item aio_pathsync $path, $callback->($status)
 
 This request tries to open, fsync and close the given path. This is a
-composite request intended tosync directories after directory operations
+composite request intended to sync directories after directory operations
 (E.g. rename). This might not work on all operating systems or have any
 specific effect, but usually it makes sure that directory changes get
 written to disc. It works for anything that can be opened for read-only,
@@ -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: