--- libev/ev.3 2020/01/22 13:33:44 1.120 +++ libev/ev.3 2020/03/18 12:21:48 1.121 @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "LIBEV 3" -.TH LIBEV 3 "2020-01-22" "libev-4.31" "libev - high performance full featured event loop" +.TH LIBEV 3 "2020-03-12" "libev-4.31" "libev - high performance full featured event loop" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -1774,8 +1774,9 @@ that, while the watcher is active, you can look at the member and expect some sensible content, but you must not modify it (you can modify it while the watcher is stopped to your hearts content), or \fI[read\-write]\fR, which -means you can expect it to have some sensible content while the watcher -is active, but you can also modify it. Modifying it may not do something +means you can expect it to have some sensible content while the watcher is +active, but you can also modify it (within the same thread as the event +loop, i.e. without creating data races). Modifying it may not do something sensible or take immediate effect (or do anything at all), but libev will not crash or malfunction in any way. .PP @@ -1966,10 +1967,10 @@ starting an io watcher watching for no events you should do so. .IP "ev_io_modify (ev_io *, int events)" 4 .IX Item "ev_io_modify (ev_io *, int events)" -Similar to \f(CW\*(C`ev_io_set\*(C'\fR, but only changes the event mask. Using this might -be faster with some backends, as libev can assume that the \f(CW\*(C`fd\*(C'\fR still -refers to the same underlying file description, something it cannot do -when using \f(CW\*(C`ev_io_set\*(C'\fR. +Similar to \f(CW\*(C`ev_io_set\*(C'\fR, but only changes the requested events. Using this +might be faster with some backends, as libev can assume that the \f(CW\*(C`fd\*(C'\fR +still refers to the same underlying file description, something it cannot +do when using \f(CW\*(C`ev_io_set\*(C'\fR. .IP "int fd [no\-modify]" 4 .IX Item "int fd [no-modify]" The file descriptor being watched. While it can be read at any time, you