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

Comparing libev/ev.pod (file contents):
Revision 1.329 by root, Sun Oct 24 20:16:00 2010 UTC vs.
Revision 1.332 by root, Sun Oct 24 23:30:23 2010 UTC

300An event loop is described by a C<struct ev_loop *> (the C<struct> is 300An event loop is described by a C<struct ev_loop *> (the C<struct> is
301I<not> optional in this case unless libev 3 compatibility is disabled, as 301I<not> optional in this case unless libev 3 compatibility is disabled, as
302libev 3 had an C<ev_loop> function colliding with the struct name). 302libev 3 had an C<ev_loop> function colliding with the struct name).
303 303
304The library knows two types of such loops, the I<default> loop, which 304The library knows two types of such loops, the I<default> loop, which
305supports signals and child events, and dynamically created event loops 305supports child process events, and dynamically created event loops which
306which do not. 306do not.
307 307
308=over 4 308=over 4
309 309
310=item struct ev_loop *ev_default_loop (unsigned int flags) 310=item struct ev_loop *ev_default_loop (unsigned int flags)
311 311
1114The event loop has been resumed in the child process after fork (see 1114The event loop has been resumed in the child process after fork (see
1115C<ev_fork>). 1115C<ev_fork>).
1116 1116
1117=item C<EV_CLEANUP> 1117=item C<EV_CLEANUP>
1118 1118
1119The event loop is abotu to be destroyed (see C<ev_cleanup>). 1119The event loop is about to be destroyed (see C<ev_cleanup>).
1120 1120
1121=item C<EV_ASYNC> 1121=item C<EV_ASYNC>
1122 1122
1123The given async watcher has been asynchronously notified (see C<ev_async>). 1123The given async watcher has been asynchronously notified (see C<ev_async>).
1124 1124
4872=back 4872=back
4873 4873
4874 4874
4875=head1 PORTING FROM LIBEV 3.X TO 4.X 4875=head1 PORTING FROM LIBEV 3.X TO 4.X
4876 4876
4877The major version 4 introduced some minor incompatible changes to the API. 4877The major version 4 introduced some incompatible changes to the API.
4878 4878
4879At the moment, the C<ev.h> header file tries to implement superficial 4879At the moment, the C<ev.h> header file provides compatibility definitions
4880compatibility, so most programs should still compile. Those might be 4880for all changes, so most programs should still compile. The compatibility
4881removed in later versions of libev, so better update early than late. 4881layer might be removed in later versions of libev, so better update to the
4882new API early than late.
4882 4883
4883=over 4 4884=over 4
4885
4886=item C<EV_COMPAT3> backwards compatibility mechanism
4887
4888The backward compatibility mechanism can be controlled by
4889C<EV_COMPAT3>. See L<PREPROCESSOR SYMBOLS/MACROS> in the L<EMBEDDING>
4890section.
4884 4891
4885=item C<ev_default_destroy> and C<ev_default_fork> have been removed 4892=item C<ev_default_destroy> and C<ev_default_fork> have been removed
4886 4893
4887These calls can be replaced easily by their C<ev_loop_xxx> counterparts: 4894These calls can be replaced easily by their C<ev_loop_xxx> counterparts:
4888 4895
4914ev_loop> anymore and C<EV_TIMER> now follows the same naming scheme 4921ev_loop> anymore and C<EV_TIMER> now follows the same naming scheme
4915as all other watcher types. Note that C<ev_loop_fork> is still called 4922as all other watcher types. Note that C<ev_loop_fork> is still called
4916C<ev_loop_fork> because it would otherwise clash with the C<ev_fork> 4923C<ev_loop_fork> because it would otherwise clash with the C<ev_fork>
4917typedef. 4924typedef.
4918 4925
4919=item C<EV_COMPAT3> backwards compatibility mechanism
4920
4921The backward compatibility mechanism can be controlled by
4922C<EV_COMPAT3>. See L<PREPROCESSOR SYMBOLS/MACROS> in the L<EMBEDDING>
4923section.
4924
4925=item C<EV_MINIMAL> mechanism replaced by C<EV_FEATURES> 4926=item C<EV_MINIMAL> mechanism replaced by C<EV_FEATURES>
4926 4927
4927The preprocessor symbol C<EV_MINIMAL> has been replaced by a different 4928The preprocessor symbol C<EV_MINIMAL> has been replaced by a different
4928mechanism, C<EV_FEATURES>. Programs using C<EV_MINIMAL> usually compile 4929mechanism, C<EV_FEATURES>. Programs using C<EV_MINIMAL> usually compile
4929and work, but the library code will of course be larger. 4930and work, but the library code will of course be larger.

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines