--- Linux-AIO/AIO.pm	2005/07/10 01:03:06	1.31
+++ Linux-AIO/AIO.pm	2005/07/10 16:33:04	1.33
@@ -38,6 +38,11 @@
 
 All functions that expect a filehandle will also accept a file descriptor.
 
+The filenames you pass to these routines I<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.
+
 =over 4
 
 =cut
@@ -116,7 +121,8 @@
 
 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;
 
 =item aio_open $pathname, $flags, $mode, $callback
 
@@ -183,6 +189,9 @@
 be called after the stat and the results will be available using C<stat _>
 or C<-s _> etc...
 
+The pathname passed to C<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 support.