[PATCH 02/98] doxygen: score: adjust doc in apimutex.h to doxygen guidelines
Sebastian Huber
sebastian.huber at embedded-brains.de
Tue May 7 05:39:07 UTC 2019
From: Andreas Dachsberger <andreas.dachsberger at embedded-brains.de>
---
cpukit/include/rtems/score/apimutex.h | 12 +++++++-----
1 file changed, 7 insertions(+), 5 deletions(-)
diff --git a/cpukit/include/rtems/score/apimutex.h b/cpukit/include/rtems/score/apimutex.h
index a5aa2bf3c5..e118269c3f 100644
--- a/cpukit/include/rtems/score/apimutex.h
+++ b/cpukit/include/rtems/score/apimutex.h
@@ -28,8 +28,9 @@
* @ingroup RTEMSScore
*
* @brief Provides routines to ensure mutual exclusion on API level.
+ *
+ * @{
*/
-/**@{**/
#ifdef __cplusplus
extern "C" {
@@ -60,21 +61,21 @@ typedef struct {
/**
* @brief Acquires the specified API mutex.
*
- * @param[in] mutex The API mutex.
+ * @param[in, out] mutex The API mutex to acquire.
*/
void _API_Mutex_Lock( API_Mutex_Control *mutex );
/**
* @brief Releases the specified API mutex.
*
- * @param[in] mutex The API mutex.
+ * @param[in, out] mutex The API mutex to release.
*/
void _API_Mutex_Unlock( API_Mutex_Control *mutex );
/**
* @brief Checks if the specified API mutex is owned by the executing thread.
*
- * @param[in] mutex The API mutex.
+ * @param[in] mutex The API mutex to check the owner from.
*/
bool _API_Mutex_Is_owner( const API_Mutex_Control *mutex );
@@ -90,8 +91,9 @@ bool _API_Mutex_Is_owner( const API_Mutex_Control *mutex );
* When the APIs all use this for allocation and deallocation protection, then
* this possibly should be renamed and moved to a higher level in the
* hierarchy.
+ *
+ * @{
*/
-/**@{**/
void _RTEMS_Lock_allocator( void );
--
2.16.4
More information about the devel
mailing list