ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/libev/ev.pod
(Generate patch)

Comparing libev/ev.pod (file contents):
Revision 1.201 by root, Fri Oct 24 08:26:04 2008 UTC vs.
Revision 1.203 by root, Sun Oct 26 00:52:51 2008 UTC

531responsibility to either stop all watchers cleanly yourself I<before> 531responsibility to either stop all watchers cleanly yourself I<before>
532calling this function, or cope with the fact afterwards (which is usually 532calling this function, or cope with the fact afterwards (which is usually
533the easiest thing, you can just ignore the watchers and/or C<free ()> them 533the easiest thing, you can just ignore the watchers and/or C<free ()> them
534for example). 534for example).
535 535
536Note that certain global state, such as signal state, will not be freed by 536Note that certain global state, such as signal state (and installed signal
537this function, and related watchers (such as signal and child watchers) 537handlers), will not be freed by this function, and related watchers (such
538would need to be stopped manually. 538as signal and child watchers) would need to be stopped manually.
539 539
540In general it is not advisable to call this function except in the 540In general it is not advisable to call this function except in the
541rare occasion where you really need to free e.g. the signal handling 541rare occasion where you really need to free e.g. the signal handling
542pipe fds. If you need dynamically allocated loops it is better to use 542pipe fds. If you need dynamically allocated loops it is better to use
543C<ev_loop_new> and C<ev_loop_destroy>). 543C<ev_loop_new> and C<ev_loop_destroy>).
1043The default priority used by watchers when no priority has been set is 1043The default priority used by watchers when no priority has been set is
1044always C<0>, which is supposed to not be too high and not be too low :). 1044always C<0>, which is supposed to not be too high and not be too low :).
1045 1045
1046Setting a priority outside the range of C<EV_MINPRI> to C<EV_MAXPRI> is 1046Setting a priority outside the range of C<EV_MINPRI> to C<EV_MAXPRI> is
1047fine, as long as you do not mind that the priority value you query might 1047fine, as long as you do not mind that the priority value you query might
1048or might not have been adjusted to be within valid range. 1048or might not have been clamped to the valid range.
1049 1049
1050=item ev_invoke (loop, ev_TYPE *watcher, int revents) 1050=item ev_invoke (loop, ev_TYPE *watcher, int revents)
1051 1051
1052Invoke the C<watcher> with the given C<loop> and C<revents>. Neither 1052Invoke the C<watcher> with the given C<loop> and C<revents>. Neither
1053C<loop> nor C<revents> need to be valid as long as the watcher callback 1053C<loop> nor C<revents> need to be valid as long as the watcher callback

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines