[rtems commit] doxygen: score: adjust doc in freechain.h to doxygen guidelines
Sebastian Huber
sebh at rtems.org
Mon May 13 05:52:27 UTC 2019
Module: rtems
Branch: master
Commit: d69b7a50bb94e415f54c3461f6f81c7c1eba89b9
Changeset: http://git.rtems.org/rtems/commit/?id=d69b7a50bb94e415f54c3461f6f81c7c1eba89b9
Author: Andreas Dachsberger <andreas.dachsberger at embedded-brains.de>
Date: Mon Apr 8 12:22:37 2019 +0200
doxygen: score: adjust doc in freechain.h to doxygen guidelines
Update #3706.
---
cpukit/include/rtems/score/freechain.h | 26 ++++++++++++++------------
1 file changed, 14 insertions(+), 12 deletions(-)
diff --git a/cpukit/include/rtems/score/freechain.h b/cpukit/include/rtems/score/freechain.h
index 6b1a154..e65eba1 100644
--- a/cpukit/include/rtems/score/freechain.h
+++ b/cpukit/include/rtems/score/freechain.h
@@ -28,6 +28,8 @@ extern "C" {
*
* @ingroup RTEMSScore
*
+ * @brief The Freechain Handler.
+ *
* The Freechain Handler is used to manage a chain of nodes, of which size can
* automatically increase when there is no free node left. This handler
* provides one data structure: Freechain_Control.
@@ -54,13 +56,13 @@ typedef struct {
* @brief Initializes a freechain.
*
* This routine initializes the freechain control structure to manage a chain
- * of nodes. In case the freechain is empty the extend handler is called to
+ * of nodes. In the case the freechain is empty the extend handler is called to
* get more nodes.
*
- * @param[in] freechain The freechain control to initialize.
- * @param[in] initial_nodes Array with the initial nodes.
- * @param[in] number_nodes The initial number of nodes.
- * @param[in] node_size The node size.
+ * @param[out] freechain The freechain control to initialize.
+ * @param[out] initial_nodes Array with the initial nodes.
+ * @param number_nodes The initial number of nodes.
+ * @param node_size The node size.
*/
RTEMS_INLINE_ROUTINE void _Freechain_Initialize(
Freechain_Control *freechain,
@@ -80,14 +82,14 @@ RTEMS_INLINE_ROUTINE void _Freechain_Initialize(
/**
* @brief Gets a node from the freechain.
*
- * @param[in] freechain The freechain control.
- * @param[in] allocator The allocator function.
- * @param[in] number_nodes_to_extend The number of nodes in case an extend is
+ * @param[in, out] freechain The freechain control.
+ * @param allocator The allocator function.
+ * @param number_nodes_to_extend The number of nodes in the case an extend is
* necessary due to an empty freechain.
* @param[in] node_size The node size.
*
* @retval NULL The freechain is empty and the extend operation failed.
- * @retval otherwise Pointer to a node. The node ownership passes to the
+ * @retval pointer Pointer to a node. The node ownership passes to the
* caller.
*/
void *_Freechain_Get(
@@ -100,8 +102,8 @@ void *_Freechain_Get(
/**
* @brief Puts a node back onto the freechain.
*
- * @param[in] freechain The freechain control.
- * @param[in] node The node to put back. The node may be @c NULL, in this case
+ * @param[in, out] freechain The freechain control.
+ * @param[out] node The node to put back. The node may be @c NULL, in this case
* the function does nothing.
*/
void _Freechain_Put(
@@ -109,7 +111,7 @@ void _Freechain_Put(
void *node
);
-/**@}*/
+/** @} */
#ifdef __cplusplus
}
More information about the vc
mailing list