--- IO-AIO/AIO.pm	2016/07/18 07:48:01	1.264
+++ IO-AIO/AIO.pm	2016/08/09 11:37:53	1.266
@@ -1,6 +1,6 @@
 =head1 NAME
 
-IO::AIO - Asynchronous Input/Output
+IO::AIO - Asynchronous/Advanced Input/Output
 
 =head1 SYNOPSIS
 
@@ -60,6 +60,10 @@
 aio_write, so the remaining functionality would have to be implemented
 using threads anyway.
 
+In addition to asynchronous I/O, this module also exports some rather
+arcane interfaces, such as C<madvise> or linux's C<splice> system call,
+which is why the C<A> in C<AIO> can also mean I<advanced>.
+
 Although the module will work in the presence of other (Perl-) threads,
 it is currently not reentrant in any way, so use appropriate locking
 yourself, always call C<poll_cb> from within the same thread, or never
@@ -444,7 +448,7 @@
 
 Reads or writes C<$length> bytes from or to the specified C<$fh> and
 C<$offset> into the scalar given by C<$data> and offset C<$dataoffset>
-and calls the callback without the actual number of bytes read (or -1 on
+and calls the callback with the actual number of bytes read (or -1 on
 error, just like the syscall).
 
 C<aio_read> will, like C<sysread>, shrink or grow the C<$data> scalar to