--- IO-AIO/AIO.pm	2014/01/25 00:15:52	1.245
+++ IO-AIO/AIO.pm	2014/07/30 22:00:04	1.249
@@ -169,7 +169,7 @@
 use base 'Exporter';
 
 BEGIN {
-   our $VERSION = 4.2;
+   our $VERSION = 4.31;
 
    our @AIO_REQ = qw(aio_sendfile aio_seek aio_read aio_write aio_open aio_close
                      aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir aio_readdirx
@@ -229,7 +229,7 @@
    aio_link $srcpath, $dstpath, $callback->($status)
    aio_symlink $srcpath, $dstpath, $callback->($status)
    aio_readlink $pathname, $callback->($link)
-   aio_realpath $pathname, $callback->($link)
+   aio_realpath $pathname, $callback->($path)
    aio_rename $srcpath, $dstpath, $callback->($status)
    aio_mkdir $pathname, $mode, $callback->($status)
    aio_rmdir $pathname, $callback->($status)
@@ -724,8 +724,8 @@
 
 =item aio_allocate $fh, $mode, $offset, $len, $callback->($status)
 
-Allocates or freed disk space according to the C<$mode> argument. See the
-linux C<fallocate> docuemntation for details.
+Allocates or frees disk space according to the C<$mode> argument. See the
+linux C<fallocate> documentation for details.
 
 C<$mode> can currently be C<0> or C<IO::AIO::FALLOC_FL_KEEP_SIZE>
 to allocate space, or C<IO::AIO::FALLOC_FL_PUNCH_HOLE |
@@ -1933,7 +1933,7 @@
 blocks, and a bad way to reduce concurrency because it is inexact: Better
 use an C<aio_group> together with a feed callback.
 
-It's main use is in scripts without an event loop - when you want to stat
+Its main use is in scripts without an event loop - when you want to stat
 a lot of files, you can write somehting like this:
 
    IO::AIO::max_outstanding 32;
@@ -1983,8 +1983,10 @@
 
 =head3 MISCELLANEOUS FUNCTIONS
 
-IO::AIO implements some functions that might be useful, but are not
-asynchronous.
+IO::AIO implements some functions that are useful when you want to use
+some "Advanced I/O" function not available to in Perl, without going the
+"Asynchronous I/O" route. Many of these have an asynchronous C<aio_*>
+counterpart.
 
 =over 4
 
@@ -2112,7 +2114,7 @@
 
 =item IO::AIO::tee $r_fh, $w_fh, $length, $flags
 
-Calls the GNU/Linux C<tee(2)> syscall, see it's manpage and the
+Calls the GNU/Linux C<tee(2)> syscall, see its manpage and the
 description for C<IO::AIO::splice> above for details.
 
 =item $actual_size = IO::AIO::pipesize $r_fh[, $new_size]