--- AnyEvent/lib/AnyEvent.pm 2008/05/30 21:43:26 1.147 +++ AnyEvent/lib/AnyEvent.pm 2008/05/31 13:06:45 1.150 @@ -1,4 +1,4 @@ -=head1 => NAME +=head1 NAME AnyEvent - provide framework for multiple event loops @@ -20,6 +20,12 @@ $w->send; # wake up current and all future recv's $w->recv; # enters "main loop" till $condvar gets ->send +=head1 INTRODUCTION/TUTORIAL + +This manpage is mainly a reference manual. If you are interested +in a tutorial or some gentle introduction, have a look at the +L manpage. + =head1 WHY YOU SHOULD USE THIS MODULE (OR NOT) Glib, POE, IO::Async, Event... CPAN offers event models by the dozen @@ -593,8 +599,9 @@ replaces it before doing so. The callback will be called when the condition becomes "true", i.e. when -C or C are called. Calling C inside the callback -or at any later time is guaranteed not to block. +C or C are called, with the only argument being the condition +variable itself. Calling C inside the callback or at any later time +is guaranteed not to block. =back