--- IO-AIO/AIO.pm	2006/10/22 13:33:28	1.60
+++ IO-AIO/AIO.pm	2006/10/22 13:52:11	1.61
@@ -354,10 +354,10 @@
 you can recurse into (directories or links to them), and ones you cannot
 recurse into (everything else).
 
-C<aio_scandir> is a composite request that consists of many sub
-requests. C<$maxreq> specifies the maximum number of outstanding aio
-requests that this function generates. If it is C<< <= 0 >>, then a
-suitable default will be chosen (currently 8).
+C<aio_scandir> is a composite request that creates of many sub requests_
+C<$maxreq> specifies the maximum number of outstanding aio requests that
+this function generates. If it is C<< <= 0 >>, then a suitable default
+will be chosen (currently 6).
 
 On error, the callback is called without arguments, otherwise it receives
 two array-refs with path-relative entry names.
@@ -406,7 +406,7 @@
 
    my $grp = aio_group $cb;
 
-   $maxreq = 8 if $maxreq <= 0;
+   $maxreq = 6 if $maxreq <= 0;
 
    # stat once
    add $grp aio_stat $path, sub {
@@ -754,17 +754,18 @@
 
 =item IO::AIO::min_parallel $nthreads
 
-Set the minimum number of AIO threads to C<$nthreads>. The current default
-is C<4>, which means four asynchronous operations can be done at one time
-(the number of outstanding operations, however, is unlimited).
+Set the minimum number of AIO threads to C<$nthreads>. The current
+default is C<8>, which means eight asynchronous operations can execute
+concurrently at any one time (the number of outstanding requests,
+however, is unlimited).
 
 IO::AIO starts threads only on demand, when an AIO request is queued and
 no free thread exists.
 
-It is recommended to keep the number of threads low, as some Linux
-kernel versions will scale negatively with the number of threads (higher
-parallelity => MUCH higher latency). With current Linux 2.6 versions, 4-32
-threads should be fine.
+It is recommended to keep the number of threads relatively low, as some
+Linux kernel versions will scale negatively with the number of threads
+(higher parallelity => MUCH higher latency). With current Linux 2.6
+versions, 4-32 threads should be fine.
 
 Under most circumstances you don't need to call this function, as the
 module selects a default that is suitable for low to moderate load.
@@ -815,7 +816,7 @@
    *$sym
 }
 
-min_parallel 4;
+min_parallel 8;
 
 END {
    max_parallel 0;