--- libev/ev.pod 2014/04/26 14:28:48 1.432 +++ libev/ev.pod 2014/05/02 07:05:42 1.433 @@ -684,11 +684,12 @@ =item ev_loop_fork (loop) -This function sets a flag that causes subsequent C iterations to -reinitialise the kernel state for backends that have one. Despite the -name, you can call it anytime, but it makes most sense after forking, in -the child process. You I call it (or use C) in the -child before resuming or calling C. +This function sets a flag that causes subsequent C iterations +to reinitialise the kernel state for backends that have one. Despite +the name, you can call it anytime you are allowed to start or stop +watchers (except inside an C callback), but it makes most +sense after forking, in the child process. You I call it (or use +C) in the child before resuming or calling C. Again, you I to call it on I loop that you want to re-use after a fork, I. This is @@ -2909,13 +2910,13 @@ prepare watchers get invoked before the process blocks and check watchers afterwards. -You I call C or similar functions that enter -the current event loop from either C or C -watchers. Other loops than the current one are fine, however. The -rationale behind this is that you do not need to check for recursion in -those watchers, i.e. the sequence will always be C, blocking, -C so if you have one watcher of each kind they will always be -called in pairs bracketing the blocking call. +You I call C (or similar functions that enter the +current event loop) or C from either C or +C watchers. Other loops than the current one are fine, +however. The rationale behind this is that you do not need to check +for recursion in those watchers, i.e. the sequence will always be +C, blocking, C so if you have one watcher of each +kind they will always be called in pairs bracketing the blocking call. Their main purpose is to integrate other event mechanisms into libev and their use is somewhat advanced. They could be used, for example, to track @@ -3265,7 +3266,7 @@ =head3 The special problem of life after fork - how is it possible? -Most uses of C consist of forking, then some simple calls to set +Most uses of C consist of forking, then some simple calls to set up/change the process environment, followed by a call to C. This sequence should be handled by libev without any problems.