From 7a5814ca02265a3c3a9e44713d3708eb4c8d7bb0 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Sun, 17 May 2015 14:32:09 +0200 Subject: update documentation for bus_poll MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- src/bus.c | 13 ++++++------- src/bus.h | 13 ++++++------- 2 files changed, 12 insertions(+), 14 deletions(-) (limited to 'src') diff --git a/src/bus.c b/src/bus.c index 0517f7a..7609de6 100644 --- a/src/bus.c +++ b/src/bus.c @@ -978,11 +978,8 @@ done: * misbehave, is `bus_poll` is written to expect * this function to have been called. * - * @param bus Bus information - * @param flags `BUS_NOWAIT` if the bus should fail and set `errno` to - * `EAGAIN` if there isn't already a message available on - * the bus when `bus_poll` is called - * @return 0 on success, -1 on error + * @param bus Bus information + * @return 0 on success, -1 on error */ int bus_poll_start(bus_t *bus) @@ -1020,8 +1017,10 @@ bus_poll_stop(const bus_t *bus) * started, the caller of this function should then * either call `bus_poll` again or `bus_poll_stop`. * - * @param bus Bus information - * @return The received message, `NULL` on error + * @param bus Bus information + * @param flags `BUS_NOWAIT` if the bus should fail and set `errno` to + * `EAGAIN` if there isn't already a message available on the bus + * @return The received message, `NULL` on error */ const char * bus_poll(bus_t *bus, int flags) diff --git a/src/bus.h b/src/bus.h index 9d3b436..36f3a0e 100644 --- a/src/bus.h +++ b/src/bus.h @@ -247,11 +247,8 @@ int bus_read_timed(const bus_t *bus, int (*callback)(const char *message, void * * misbehave, is `bus_poll` is written to expect * this function to have been called. * - * @param bus Bus information - * @param flags `BUS_NOWAIT` if the bus should fail and set `errno` to - * `EAGAIN` if there isn't already a message available on - * the bus when `bus_poll` is called - * @return 0 on success, -1 on error + * @param bus Bus information + * @return 0 on success, -1 on error */ int bus_poll_start(bus_t *bus); @@ -273,8 +270,10 @@ int bus_poll_stop(const bus_t *bus); * started, the caller of this function should then * either call `bus_poll` again or `bus_poll_stop`. * - * @param bus Bus information - * @return The received message, `NULL` on error + * @param bus Bus information + * @param flags `BUS_NOWAIT` if the bus should fail and set `errno` to + * `EAGAIN` if there isn't already a message available on the bus + * @return The received message, `NULL` on error */ const char *bus_poll(bus_t *bus, int flags); -- cgit v1.2.3-70-g09d2