From: root <root>
Date: Wed, 14 Nov 2007 05:02:07 +0000 (+0000)
Subject: better ev_loop docs
X-Git-Tag: rel-0_9~2
X-Git-Url: https://git.llucax.com/software/libev.git/commitdiff_plain/6bdef28fc792013d0a97d94efd1659fde7921dbd?ds=inline

better ev_loop docs
---

diff --git a/ev.pod b/ev.pod
index f26f84b..f9b6a83 100644
--- a/ev.pod
+++ b/ev.pod
@@ -241,6 +241,24 @@ This flags value could be used to implement alternative looping
 constructs, but the C<prepare> and C<check> watchers provide a better and
 more generic mechanism.
 
+Here are the gory details of what ev_loop does:
+
+   1. If there are no active watchers (reference count is zero), return.
+   2. Queue and immediately call all prepare watchers.
+   3. If we have been forked, recreate the kernel state.
+   4. Update the kernel state with all outstanding changes.
+   5. Update the "event loop time".
+   6. Calculate for how long to block.
+   7. Block the process, waiting for events.
+   8. Update the "event loop time" and do time jump handling.
+   9. Queue all outstanding timers.
+  10. Queue all outstanding periodics.
+  11. If no events are pending now, queue all idle watchers.
+  12. Queue all check watchers.
+  13. Call all queued watchers in reverse order (i.e. check watchers first).
+  14. If ev_unloop has been called or EVLOOP_ONESHOT or EVLOOP_NONBLOCK
+      was used, return, otherwise continue with step #1.
+
 =item ev_unloop (loop, how)
 
 Can be used to make a call to C<ev_loop> return early (but only after it