--- IO-AIO/AIO.pm	2006/10/22 00:53:47	1.56
+++ IO-AIO/AIO.pm	2006/10/22 01:28:31	1.57
@@ -605,18 +605,22 @@
 C<done> state, they will also finish. Otherwise they will continue to
 exist.
 
+That means after creating a group you have some time to add requests. And
+in the callbacks of those requests, you can add further requests to the
+group. And only when all those requests have finished will the the group
+itself finish.
+
 =over 4
 
 =item $grp->add (...)
 
 =item add $grp ...
 
-Add one or more
-Cancels the request, if possible. Has the effect of skipping execution
-when entering the B<execute> state and skipping calling the callback when
-entering the the B<result> state, but will leave the request otherwise
-untouched. That means that requests that currently execute will not be
-stopped and resources held by the request will not be freed prematurely.
+Add one or more requests to the group. Any type of L<IO::AIO::REQ> can
+be added, including other groups, as long as you do not create circular
+dependencies.
+
+Returns all its arguments.
 
 =back