--- IO-AIO/AIO.pm	2009/06/30 07:33:58	1.159
+++ IO-AIO/AIO.pm	2009/11/30 22:22:13	1.168
@@ -188,13 +188,12 @@
 
 use Carp ();
 
-no warnings;
-use strict 'vars';
+use common::sense;
 
 use base 'Exporter';
 
 BEGIN {
-   our $VERSION = '3.26';
+   our $VERSION = '3.31';
 
    our @AIO_REQ = qw(aio_sendfile aio_read aio_write aio_open aio_close
                      aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir aio_readdirx
@@ -637,7 +636,7 @@
 
 Try to copy the I<file> (directories not supported as either source or
 destination) from C<$srcpath> to C<$dstpath> and call the callback with
-the C<0> (error) or C<-1> ok.
+a status of C<0> (ok) or C<-1> (error, see C<$!>).
 
 This is a composite request that creates the destination file with
 mode 0200 and copies the contents of the source file into it using
@@ -659,7 +658,7 @@
    aioreq_pri $pri;
    add $grp aio_open $src, O_RDONLY, 0, sub {
       if (my $src_fh = $_[0]) {
-         my @stat = stat $src_fh; # hmm, might bock over nfs?
+         my @stat = stat $src_fh; # hmm, might block over nfs?
 
          aioreq_pri $pri;
          add $grp aio_open $dst, O_CREAT | O_WRONLY | O_TRUNC, 0200, sub {
@@ -716,7 +715,7 @@
 
 Try to move the I<file> (directories not supported as either source or
 destination) from C<$srcpath> to C<$dstpath> and call the callback with
-the C<0> (error) or C<-1> ok.
+a status of C<0> (ok) or C<-1> (error, see C<$!>).
 
 This is a composite request that tries to rename(2) the file first; if
 rename fails with C<EXDEV>, it copies the file with C<aio_copy> and, if
@@ -960,6 +959,9 @@
 written to disc. It works for anything that can be opened for read-only,
 not just directories.
 
+Future versions of this function might fall back to other methods when
+C<fsync> on the directory fails (such as calling C<sync>).
+
 Passes C<0> when everything went ok, and C<-1> on error.
 
 =cut
@@ -1133,6 +1135,9 @@
 Cancel all subrequests and clears any feeder, but not the group request
 itself. Useful when you queued a lot of events but got a result early.
 
+The group request will finish normally (you cannot add requests to the
+group).
+
 =item $grp->result (...)
 
 Set the result value(s) that will be passed to the group callback when all