Avoid defining recommended functions in terms of deprecated ones

This commit is contained in:
Nick Mathewson 2012-11-18 18:59:19 -05:00
parent 3db0737ae6
commit 96584866cd

View File

@ -39,7 +39,7 @@
to signals or regular timeouts. to signals or regular timeouts.
Libevent is meant to replace the event loop found in event driven network Libevent is meant to replace the event loop found in event driven network
servers. An application just needs to call event_dispatch() and then add or servers. An application just needs to call event_base_dispatch() and then add or
remove events dynamically without having to change the event loop. remove events dynamically without having to change the event loop.
@ -750,7 +750,7 @@ int event_base_loopexit(struct event_base *, const struct timeval *);
event_base_loopbreak() is typically invoked from this event's callback. event_base_loopbreak() is typically invoked from this event's callback.
This behavior is analogous to the "break;" statement. This behavior is analogous to the "break;" statement.
Subsequent invocations of event_loop() will proceed normally. Subsequent invocations of event_base_loop() will proceed normally.
@param eb the event_base structure returned by event_init() @param eb the event_base structure returned by event_init()
@return 0 if successful, or -1 if an error occurred @return 0 if successful, or -1 if an error occurred
@ -778,7 +778,7 @@ int event_base_loopbreak(struct event_base *);
int event_base_loopcontinue(struct event_base *); int event_base_loopcontinue(struct event_base *);
/** /**
Checks if the event loop was told to exit by event_loopexit(). Checks if the event loop was told to exit by event_base_loopexit().
This function will return true for an event_base at every point after This function will return true for an event_base at every point after
event_loopexit() is called, until the event loop is next entered. event_loopexit() is called, until the event loop is next entered.
@ -792,10 +792,10 @@ int event_base_loopcontinue(struct event_base *);
int event_base_got_exit(struct event_base *); int event_base_got_exit(struct event_base *);
/** /**
Checks if the event loop was told to abort immediately by event_loopbreak(). Checks if the event loop was told to abort immediately by event_base_loopbreak().
This function will return true for an event_base at every point after This function will return true for an event_base at every point after
event_loopbreak() is called, until the event loop is next entered. event_base_loopbreak() is called, until the event loop is next entered.
@param eb the event_base structure returned by event_init() @param eb the event_base structure returned by event_init()
@return true if event_base_loopbreak() was called on this event base, @return true if event_base_loopbreak() was called on this event base,
@ -1001,7 +1001,7 @@ void event_free(struct event *);
/** /**
Schedule a one-time event Schedule a one-time event
The function event_base_once() is similar to event_set(). However, it The function event_base_once() is similar to event_new(). However, it
schedules a callback to be called exactly once, and does not require the schedules a callback to be called exactly once, and does not require the
caller to prepare an event structure. caller to prepare an event structure.
@ -1039,7 +1039,7 @@ int event_base_once(struct event_base *, evutil_socket_t, short, event_callback_
If the event in the ev argument already has a scheduled timeout, calling If the event in the ev argument already has a scheduled timeout, calling
event_add() replaces the old timeout with the new one if tv is non-NULL. event_add() replaces the old timeout with the new one if tv is non-NULL.
@param ev an event struct initialized via event_set() @param ev an event struct initialized via event_assign() or event_new()
@param timeout the maximum amount of time to wait for the event, or NULL @param timeout the maximum amount of time to wait for the event, or NULL
to wait forever to wait forever
@return 0 if successful, or -1 if an error occurred @return 0 if successful, or -1 if an error occurred