--- Linux-AIO/README	2005/07/10 01:02:51	1.4
+++ Linux-AIO/README	2005/08/17 16:57:53	1.7
@@ -4,7 +4,12 @@
 SYNOPSIS
      use Linux::AIO;
 
+     # This module has been mostly superseded by IO::AIO.
+
 DESCRIPTION
+    *This module has been mostly superseded by IO::AIO, which is API
+    compatible.*
+
     This module implements asynchronous I/O using the means available to
     Linux - clone. It does not hook into the POSIX aio_* functions because
     Linux does not yet support these in the kernel (even as of 2.6.12, only
@@ -35,6 +40,11 @@
     All functions that expect a filehandle will also accept a file
     descriptor.
 
+    The filenames you pass to these routines *must* be absolute. The reason
+    is that at the time the request is being executed, the current working
+    directory could have changed. Alternatively, you can make sure that you
+    never change the current working directory.
+
     Linux::AIO::min_parallel $nthreads
         Set the minimum number of AIO threads to $nthreads. The default is
         1, which means a single asynchronous operation can be done at one
@@ -89,13 +99,17 @@
 
         Example: wait till there are no outstanding requests anymore:
 
-           Linux::AIO::poll_wait while Linux::AIO::nreqs;
+           Linux::AIO::poll_wait, Linux::AIO::poll_cb
+              while Linux::AIO::nreqs;
 
     aio_open $pathname, $flags, $mode, $callback
         Asynchronously open or create a file and call the callback with the
         filedescriptor (NOT a perl filehandle, sorry for that, but watch
         out, this might change in the future).
 
+        The pathname passed to "aio_open" must be absolute. See API NOTES,
+        above, for an explanation.
+
         The $mode argument is a bitmask. See the "Fcntl" module for a list.
         They are the same as used in "sysopen".
 
@@ -103,8 +117,7 @@
 
            aio_open "/etc/passwd", O_RDONLY, 0, sub {
               if ($_[0] >= 0) {
-                 open my $fh, "<&$_[0]";   # create a copy for perl
-                 aio_close $_[0], sub { }; # close the aio handle
+                 open my $fh, "<&=$_[0]";
                  print "open successful, fh is $fh\n";
                  ...
               } else {
@@ -151,6 +164,9 @@
         will be called after the stat and the results will be available
         using "stat _" or "-s _" etc...
 
+        The pathname passed to "aio_stat" must be absolute. See API NOTES,
+        above, for an explanation.
+
         Currently, the stats are always 64-bit-stats, i.e. instead of
         returning an error when stat'ing a large file, the results will be
         silently truncated unless perl itself is compiled with large file
@@ -182,7 +198,7 @@
        - aio_open gives a fd, but all other functions expect a perl filehandle.
 
 SEE ALSO
-    Coro.
+    Coro, IO::AIO.
 
 AUTHOR
      Marc Lehmann <schmorp@schmorp.de>