--- cvsroot/libev/README.embed 2007/11/08 17:56:30 1.8 +++ cvsroot/libev/README.embed 2007/11/09 20:55:09 1.15 @@ -17,11 +17,17 @@ This will automatically include ev.h, too, and should be done in a single C source file only to provide the function implementations. To - use it, do the same for ev.h in all users: + use it, do the same for ev.h in all files wishing to use this API + (best done by writing a wrapper around ev.h that you can include + instead and where you can put other configuration options): #define EV_STANDALONE 1 #include "ev.h" + Both header files and implementation files can be compiled with a C++ + compiler (at least, thats a stated goal, and breakage will be treated + as a bug). + You need the following files in your source tree, or in a directory in your include path (e.g. in libev/ when using -Ilibev): @@ -31,7 +37,7 @@ ev_wrap.h ev_win32.c - ev_select.c only when select backend is enabled (which is by default) + ev_select.c only when select backend is enabled (which is is by default) ev_poll.c only when poll backend is enabled (disabled by default) ev_epoll.c only when the epoll backend is enabled (disabled by default) ev_kqueue.c only when the kqueue backend is enabled (disabled by default) @@ -124,6 +130,18 @@ will be detected at runtime and routed around by disabling this backend. + EV_H + + The name of the ev.h header file used to include it. The default + if undefined is in event.h and "ev.h" in ev.c. This can + be used to virtually rename the ev.h header file in case of + conflicts. + + EV_EVENT_H + + Similarly to EV_H, this macro cna be used to override event.c's idea + of how the event.h header can be found. + EV_COMMON By default, all watchers have a "void *data" member. By redefining @@ -152,6 +170,14 @@ event loop pointer argument. Instead, all functions act on the single default loop. + EV_CB_DECLARE(type) + EV_CB_INVOKE(watcher,revents) + + Can be used to change the callback member declaration in each + watcher, and the way callbacks are invoked. Must expand to a struct + member definition and a statement, respectively. See the ev.v + header file for their default definitions. + EXAMPLES For a real-world example of a program the includes libev