--- cvsroot/EV/README 2008/07/12 22:19:22 1.29 +++ cvsroot/EV/README 2008/10/23 04:56:49 1.30 @@ -56,10 +56,10 @@ This module provides an interface to libev (). While the documentation below is comprehensive, one might also consult the documentation of - libev itself () - for more subtle details on watcher semantics or some discussion on the - available backends, or how to force a specific backend with - "LIBEV_FLAGS", or just about in any case because it has much more + libev itself ( or + perldoc EV::libev) for more subtle details on watcher semantics or some + discussion on the available backends, or how to force a specific backend + with "LIBEV_FLAGS", or just about in any case because it has much more detailed information. This module is very fast and scalable. It is actually so fast that you @@ -68,6 +68,9 @@ and still be faster than with any other event loop currently supported in Perl. + MODULE EXPORTS + This module does not export any symbols. + EVENT LOOPS EV supports multiple event loops: There is a single "default event loop" that can handle everything including signals and child watchers, and any @@ -94,13 +97,16 @@ Create a new event loop as per the specified flags. Please refer to the "ev_loop_new ()" function description in the libev documentation () for more info. + ONS>, or locally-installed as EV::libev manpage) for more info. The loop will automatically be destroyed when it is no longer referenced by any watcher and the loop object goes out of scope. - Using "EV::FLAG_FORKCHECK" is recommended, as only the default event - loop is protected by this module. + If you are not embedding the loop, then Using "EV::FLAG_FORKCHECK" + is recommended, as only the default event loop is protected by this + module. If you *are* embedding this loop in the default loop, this + is not necessary, as "EV::embed" automatically does the right thing + on fork. $loop->loop_fork Must be called after a fork in the child, before entering or @@ -219,7 +225,8 @@ for I/O events and the minimum wait interval for timer events. See the libev documentation at for a more detailed discussion. + ROLLING_THE_EVENT_LOOP> (locally installed as EV::libev) for a more + detailed discussion. WATCHER OBJECTS A watcher is an object that gets created to record your interest in some @@ -772,7 +779,7 @@ See the libev documentation at for more details. + _when_one_backend_> (locally installed as EV::libev) for more details. In short, this watcher is most useful on BSD systems without working kqueue to still be able to handle a large number of sockets: