--- IO-AIO/AIO.pm	2006/10/25 08:20:14	1.76
+++ IO-AIO/AIO.pm	2006/10/25 17:57:30	1.77
@@ -136,7 +136,7 @@
                      aio_group aio_nop);
    our @EXPORT = (@AIO_REQ, qw(aioreq_pri aioreq_nice));
    our @EXPORT_OK = qw(poll_fileno poll_cb poll_wait flush
-                       min_parallel max_parallel max_outstanding nreqs);
+                       min_parallel max_parallel nreqs);
 
    @IO::AIO::GRP::ISA = 'IO::AIO::REQ';
 
@@ -684,10 +684,6 @@
 =item * You must not add requests to a group from within the group callback (or
 any later time).
 
-=item * This does not harmonise well with C<max_outstanding>, so best do
-not combine C<aio_group> with it. Groups and feeders are recommended for
-this kind of concurrency-limiting.
-
 =back
 
 Their lifetime, simplified, looks like this: when they are empty, they
@@ -863,21 +859,22 @@
 
 =item $oldnreqs = IO::AIO::max_outstanding $nreqs
 
-[DEPRECATED]
+[REMOVED]
 
-Sets the maximum number of outstanding requests to C<$nreqs>. If you
-try to queue up more than this number of requests, the caller will block until
-some requests have been handled.
+Pre-2.x versions used max_outstanding for a crude request queue length limit.
 
-The default is very large, so normally there is no practical limit. If you
-queue up many requests in a loop it often improves speed if you set
-this to a relatively low number, such as C<100>.
-
-This function does not work well together with C<aio_group>'s, and their
-feeder interface is better suited to limiting concurrency, so do not use
-this function.
+In 2.x+ you are advised to use a group and a feeder to limit
+concurrency. The max_outstanding feature ran very unstable (endless
+recursions causing segfaults, bad interaction with groups etc.) and was
+removed.
 
-Under normal circumstances you don't need to call this function.
+I am deeply sorry, but I am still on the hunt for a good limiting interface.
+
+Original description was as follows:
+
+Sets the maximum number of outstanding requests to C<$nreqs>. If you try
+to queue up more than this number of requests, the caller will block until
+some requests have been handled.
 
 =back