summaryrefslogtreecommitdiffstats
path: root/src/write_queue.c
diff options
context:
space:
mode:
authorNeels Hofmeyr <nhofmeyr@sysmocom.de>2017-06-20 00:17:59 +0200
committerNeels Hofmeyr <nhofmeyr@sysmocom.de>2017-06-23 00:18:22 +0000
commit87e4550585c643e97e0003119b254251ac5ed1d4 (patch)
tree9287f66aba70e9253f4d62926c54dddeb492895e /src/write_queue.c
parent249fb71a2e124acb191b7cd4d2c3af6a45da4a5e (diff)
doxygen: enable AUTOBRIEF, drop \brief
Especially for short descriptions, it is annoying to have to type \brief for every single API doc. Drop all \brief and enable the AUTOBRIEF feature of doxygen, which always takes the first sentence of an API doc as the brief description. Change-Id: I11a8a821b065a128108641a2a63fb5a2b1916e87
Diffstat (limited to 'src/write_queue.c')
-rw-r--r--src/write_queue.c10
1 files changed, 5 insertions, 5 deletions
diff --git a/src/write_queue.c b/src/write_queue.c
index 1e4cda5a..d9297744 100644
--- a/src/write_queue.c
+++ b/src/write_queue.c
@@ -27,12 +27,12 @@
/*! \addtogroup write_queue
* @{
- * \brief write queue for writing \ref msgb to sockets/fd's
+ * write queue for writing \ref msgb to sockets/fd's
*/
/*! \file write_queue.c */
-/*! \brief Select loop function for write queue handling
+/*! Select loop function for write queue handling
* \param[in] fd osmocom file descriptor
* \param[in] what bit-mask of events that have happened
* \returns 0 on success; negative on error
@@ -85,7 +85,7 @@ err_badfd:
return 0;
}
-/*! \brief Initialize a \ref osmo_wqueue structure
+/*! Initialize a \ref osmo_wqueue structure
* \param[in] queue Write queue to operate on
* \param[in] max_length Maximum length of write queue
*/
@@ -100,7 +100,7 @@ void osmo_wqueue_init(struct osmo_wqueue *queue, int max_length)
INIT_LLIST_HEAD(&queue->msg_queue);
}
-/*! \brief Enqueue a new \ref msgb into a write queue
+/*! Enqueue a new \ref msgb into a write queue
* \param[in] queue Write queue to be used
* \param[in] data to-be-enqueued message buffer
* \returns 0 on success; negative on error
@@ -120,7 +120,7 @@ int osmo_wqueue_enqueue(struct osmo_wqueue *queue, struct msgb *data)
return 0;
}
-/*! \brief Clear a \ref osmo_wqueue
+/*! Clear a \ref osmo_wqueue
* \param[in] queue Write queue to be cleared
*
* This function will clear (remove/release) all messages in it.