score: Canonicalize Doxygen @file comments

Use common phrases for the file brief descriptions.

Update #3706.

1 files changed, 16 insertions, 9 deletions

diff --git a/cpukit/include/rtems/score/muteximpl.h b/cpukit/include/rtems/score/muteximpl.h
index aac55faf03..c75a9ab657 100644
--- a/cpukit/include/rtems/score/muteximpl.h
+++ b/cpukit/include/rtems/score/muteximpl.h
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup RTEMSScoreAPIMutex
+ * @ingroup RTEMSScoreSyslockMutex
  *
- * @brief Structures for the implementation of mutexes.
+ * @brief This header file provides the interfaces of the
+ *   @ref RTEMSScoreSyslockMutex.
  */
 
 /*
@@ -25,16 +26,22 @@
 
 #include <rtems/score/threadqimpl.h>
 
+#ifdef __cplusplus
+extern "C" {
+#endif /* __cplusplus */
+
 /**
- * @addtogroup RTEMSScoreAPIMutex
+ * @defgroup RTEMSScoreSyslockMutex System Lock Mutex Support
+ *
+ * @ingroup RTEMSScore
+ *
+ * @brief The System Lock Mutex Support helps to implement directives which use
+ *   data structures compatible with the data structures defined by the Newlib
+ *   provided <sys/lock.h> header file.
  *
  * @{
  */
 
-#ifdef __cplusplus
-extern "C" {
-#endif /* __cplusplus */
-
 typedef struct {
   Thread_queue_Syslock_queue Queue;
 } Mutex_Control;
@@ -44,10 +51,10 @@ typedef struct {
   unsigned int nest_level;
 } Mutex_recursive_Control;
 
+/** @} */
+
 #ifdef __cplusplus
 }
 #endif /* __cplusplus */
 
-/** @} */
-
 #endif /* _RTEMS_SCORE_MUTEXIMPL_H */