--- IO-AIO/AIO.pm	2006/10/30 23:30:29	1.91
+++ IO-AIO/AIO.pm	2006/11/08 01:59:58	1.93
@@ -973,9 +973,10 @@
 
 =item IO::AIO::poll_wait
 
-Wait till the result filehandle becomes ready for reading (simply does a
-C<select> on the filehandle. This is useful if you want to synchronously
-wait for some requests to finish).
+If there are any outstanding requests and none of them in the result
+phase, wait till the result filehandle becomes ready for reading (simply
+does a C<select> on the filehandle. This is useful if you want to
+synchronously wait for some requests to finish).
 
 See C<nreqs> for an example.
 
@@ -983,10 +984,10 @@
 
 Waits until some requests have been handled.
 
-Strictly equivalent to:
+Returns the number of requests processed, but is otherwise strictly
+equivalent to:
 
    IO::AIO::poll_wait, IO::AIO::poll_cb
-      if IO::AIO::nreqs;
 
 =item IO::AIO::flush