--- IO-AIO/AIO.pm	2017/09/22 05:20:39	1.275
+++ IO-AIO/AIO.pm	2017/09/22 12:17:49	1.277
@@ -1081,7 +1081,7 @@
 names, directories you can recurse into (directories), and ones you cannot
 recurse into (everything else, including symlinks to directories).
 
-C<aio_scandir> is a composite request that creates of many sub requests_
+C<aio_scandir> is a composite request that generates many sub requests.
 C<$maxreq> specifies the maximum number of outstanding aio requests that
 this function generates. If it is C<< <= 0 >>, then a suitable default
 will be chosen (currently 4).
@@ -1610,8 +1610,8 @@
 nowhere at all), while the directory fd, if available on the system,
 will still point to the original directory. Most functions accepting a
 pathname will use the directory fd on newer systems, and the string on
-older systems. Some functions (such as realpath) will always rely on the
-string form of the pathname.
+older systems. Some functions (such as C<aio_realpath>) will always rely on
+the string form of the pathname.
 
 So this functionality is mainly useful to get some protection against
 C<chdir>, to easily get an absolute path out of a relative path for future
@@ -2087,7 +2087,8 @@
 tricks, while still failing. You can query the resulting limit using
 C<IO::AIO::get_fdlimit>.
 
-If an error occurs, returns C<undef> and sets C<$!>.
+If an error occurs, returns C<undef> and sets C<$!>, otherwise returns
+true.
 
 =item IO::AIO::sendfile $ofh, $ifh, $offset, $count