--- IO-AIO/AIO.pm 2011/05/19 23:57:12 1.191 +++ IO-AIO/AIO.pm 2011/05/20 00:00:03 1.192 @@ -1419,6 +1419,13 @@ will still be ready when C returns, so normally you don't have to do anything special to have it called later. +Apart from calling C when the event filehandle becomes +ready, it can be beneficial to call this function from loops which submit +a lot of requests, to make sure the results get processed when they become +available and not just when the loop is finished and the event loop takes +over again. This function returns very fast when there are no outstanding +requests. + Example: Install an Event watcher that automatically calls IO::AIO::poll_cb with high priority (more examples can be found in the SYNOPSIS section, at the top of this document):