[PATCH 69/98] doxygen: score: adjust doc in smplockseq.h to doxygen guidelines

Sebastian Huber sebastian.huber at embedded-brains.de
Tue May 7 05:40:14 UTC 2019


From: Andreas Dachsberger <andreas.dachsberger at embedded-brains.de>

---
 cpukit/include/rtems/score/smplockseq.h | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/cpukit/include/rtems/score/smplockseq.h b/cpukit/include/rtems/score/smplockseq.h
index f65595a10b..ab07a04351 100644
--- a/cpukit/include/rtems/score/smplockseq.h
+++ b/cpukit/include/rtems/score/smplockseq.h
@@ -66,7 +66,7 @@ typedef struct {
  *
  * Concurrent initialization leads to unpredictable results.
  *
- * @param lock The SMP sequence lock control.
+ * @param[out] lock The SMP sequence lock control.
  */
 static inline void _SMP_sequence_lock_Initialize( SMP_sequence_lock_Control *lock )
 {
@@ -92,7 +92,7 @@ static inline void _SMP_sequence_lock_Destroy( SMP_sequence_lock_Control *lock )
  * current thread of execution is not interrupted indefinite since this would
  * starve readers.
  *
- * @param lock The SMP sequence lock control.
+ * @param[out] lock The SMP sequence lock control.
  *
  * @return The current sequence number.
  */
@@ -116,7 +116,7 @@ static inline unsigned int _SMP_sequence_lock_Write_begin(
 /**
  * @brief Ends an SMP sequence lock write operation.
  *
- * @param lock The SMP sequence lock control.
+ * @param[out] lock The SMP sequence lock control.
  * @param seq The sequence number returned by _SMP_sequence_lock_Write_begin().
  */
 static inline void _SMP_sequence_lock_Write_end(
@@ -132,7 +132,7 @@ static inline void _SMP_sequence_lock_Write_end(
  *
  * This function will not disable interrupts.
  *
- * @param lock The SMP sequence lock control.
+ * @param[out] lock The SMP sequence lock control.
  *
  * @return The current sequence number.
  */
@@ -147,12 +147,12 @@ static inline unsigned int _SMP_sequence_lock_Read_begin(
  * @brief Ends an SMP sequence lock read operation and indicates if a retry is
  * necessary.
  *
- * @param lock The SMP sequence lock control.
+ * @param[in, out] lock The SMP sequence lock control.
  * @param seq The sequence number returned by _SMP_sequence_lock_Read_begin().
  *
  * @retval true The read operation must be retried with a call to
  *   _SMP_sequence_lock_Read_begin().
- * @retval false Otherwise.
+ * @retval false The read operation need not be retried.
  */
 static inline bool _SMP_sequence_lock_Read_retry(
   SMP_sequence_lock_Control *lock,
@@ -165,7 +165,7 @@ static inline bool _SMP_sequence_lock_Read_retry(
   return seq != seq2 || seq % 2 != 0;
 }
 
-/**@}*/
+/** @} */
 
 #ifdef __cplusplus
 }
-- 
2.16.4




More information about the devel mailing list