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

Comparing libev/ev.pod (file contents):
Revision 1.286 by root, Tue Mar 16 00:26:41 2010 UTC vs.
Revision 1.287 by root, Tue Mar 16 00:43:22 2010 UTC

… …
3891If you need to shave off some kilobytes of code at the expense of some 3891If you need to shave off some kilobytes of code at the expense of some
3892speed (but with the full API), you can define this symbol to request 3892speed (but with the full API), you can define this symbol to request
3893certain subsets of functionality. The default is to enable all features 3893certain subsets of functionality. The default is to enable all features
3894that can be enabled on the platform. 3894that can be enabled on the platform.
3895 3895
3896Note that using autoconf will usually override most of the features, so
3897using this symbol makes sense mostly when embedding libev.
3898
3899A typical way to use this symbol is to define it to C<0> (or to a bitset 3896A typical way to use this symbol is to define it to C<0> (or to a bitset
3900with some broad features you want) and then selectively re-enable 3897with some broad features you want) and then selectively re-enable
3901additional parts you want, for example if you want everything minimal, 3898additional parts you want, for example if you want everything minimal,
3902but multiple event loop support, async and child watchers and the poll 3899but multiple event loop support, async and child watchers and the poll
3903backend, use this: 3900backend, use this:
… …
3934=item C<4> - full API configuration 3931=item C<4> - full API configuration
3935 3932
3936This enables priorities (sets C<EV_MAXPRI>=2 and C<EV_MINPRI>=-2), and 3933This enables priorities (sets C<EV_MAXPRI>=2 and C<EV_MINPRI>=-2), and
3937enables multiplicity (C<EV_MULTIPLICITY>=1). 3934enables multiplicity (C<EV_MULTIPLICITY>=1).
3938 3935
3936=item C<8> - full API
3937
3939It also enables a lot of the "lesser used" core API functions. See C<ev.h> 3938This enables a lot of the "lesser used" API functions. See C<ev.h> for
3940for details on which parts of the API are still available without this 3939details on which parts of the API are still available without this
3941feature, and do not complain if this subset changes over time. 3940feature, and do not complain if this subset changes over time.
3942 3941
3943=item C<8> - enable all optional watcher types 3942=item C<16> - enable all optional watcher types
3944 3943
3945Enables all optional watcher types. If you want to selectively enable 3944Enables all optional watcher types. If you want to selectively enable
3946only some watcher types other than I/O and timers (e.g. prepare, 3945only some watcher types other than I/O and timers (e.g. prepare,
3947embed, async, child...) you can enable them manually by defining 3946embed, async, child...) you can enable them manually by defining
3948C<EV_watchertype_ENABLE> to C<1> instead. 3947C<EV_watchertype_ENABLE> to C<1> instead.
3949 3948
3950=item C<16> - enable all backends 3949=item C<32> - enable all backends
3951 3950
3952This enables all backends - without this feature, you need to enable at 3951This enables all backends - without this feature, you need to enable at
3953least one backend manually (C<EV_USE_SELECT> is a good choice). 3952least one backend manually (C<EV_USE_SELECT> is a good choice).
3954 3953
3955=item C<32> - enable OS-specific "helper" APIs 3954=item C<64> - enable OS-specific "helper" APIs
3956 3955
3957Enable inotify, eventfd, signalfd and similar OS-specific helper APIs by 3956Enable inotify, eventfd, signalfd and similar OS-specific helper APIs by
3958default. 3957default.
3959 3958
3960=back 3959=back
… …
4103file. 4102file.
4104 4103
4105The usage in rxvt-unicode is simpler. It has a F<ev_cpp.h> header file 4104The usage in rxvt-unicode is simpler. It has a F<ev_cpp.h> header file
4106that everybody includes and which overrides some configure choices: 4105that everybody includes and which overrides some configure choices:
4107 4106
4108 #define EV_FEATURES 0 4107 #define EV_FEATURES 8
4109 #define EV_USE_SELECT 1 4108 #define EV_USE_SELECT 1
4109 #define EV_PREPARE_ENABLE 1
4110 #define EV_IDLE_ENABLE 1
4111 #define EV_SIGNAL_ENABLE 1
4112 #define EV_CHILD_ENABLE 1
4113 #define EV_USE_STDEXCEPT 0
4110 #define EV_CONFIG_H <config.h> 4114 #define EV_CONFIG_H <config.h>
4111 4115
4112 #include "ev++.h" 4116 #include "ev++.h"
4113 4117
4114And a F<ev_cpp.C> implementation file that contains libev proper and is compiled: 4118And a F<ev_cpp.C> implementation file that contains libev proper and is compiled:

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines