score: Canonicalize Doxygen @file comments

Use common phrases for the file brief descriptions. Update #3706.
author: Sebastian Huber <sebastian.huber@embedded-brains.de> 2020-11-27 17:21:23 +0100
committer: Sebastian Huber <sebastian.huber@embedded-brains.de> 2020-12-02 07:45:53 +0100
commit: 9278f3d04f1e26071cb98a5e2940177abc40b6d8 (patch)
tree: 9f5d198e4af5ad22b96012a17ce0a23769acf01f /cpukit/score/src
parent: rtems: Canonicalize Doxygen @file comments (diff)
download: rtems-9278f3d04f1e26071cb98a5e2940177abc40b6d8.tar.bz2
242 files changed, 1292 insertions, 381 deletions
diff --git a/cpukit/score/src/allocatormutex.c b/cpukit/score/src/allocatormutex.c
index 3d2b7fa01e..bf4f88da52 100644
--- a/cpukit/score/src/allocatormutex.c
+++ b/cpukit/score/src/allocatormutex.c
@@ -1,3 +1,13 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreAPIMutex
+ *
+ * @brief This source file contains the implementation of
+ *   _RTEMS_Lock_allocator(), _RTEMS_Unlock_allocator(), and
+ *   _RTEMS_Allocator_is_owner().
+ */
+
 /*
  * Copyright (c) 2017 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/apimutexisowner.c b/cpukit/score/src/apimutexisowner.c
index 83c8f6fc5d..10a100b55c 100644
--- a/cpukit/score/src/apimutexisowner.c
+++ b/cpukit/score/src/apimutexisowner.c
@@ -2,6 +2,9 @@
  * @file
  *
  * @ingroup RTEMSScoreAPIMutex
+ *
+ * @brief This source file contains the implementation of
+ *   _API_Mutex_Is_owner().
  */
 
 /*
diff --git a/cpukit/score/src/apimutexlock.c b/cpukit/score/src/apimutexlock.c
index dadd9615c8..50edbe1688 100644
--- a/cpukit/score/src/apimutexlock.c
+++ b/cpukit/score/src/apimutexlock.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Acquires the specified API mutex.
- *
  * @ingroup RTEMSScoreAPIMutex
+ *
+ * @brief This source file contains the implementation of
+ *   _API_Mutex_Lock().
  */
 
 /*
diff --git a/cpukit/score/src/apimutexunlock.c b/cpukit/score/src/apimutexunlock.c
index 21d1d75771..c0631f05c1 100644
--- a/cpukit/score/src/apimutexunlock.c
+++ b/cpukit/score/src/apimutexunlock.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Releases the Specified API Mutex
- *
  * @ingroup RTEMSScoreAPIMutex
+ *
+ * @brief This source file contains the implementation of
+ *   _API_Mutex_Unlock().
  */
 
 /*
diff --git a/cpukit/score/src/chain.c b/cpukit/score/src/chain.c
index 47aa4a894f..a92c60fc49 100644
--- a/cpukit/score/src/chain.c
+++ b/cpukit/score/src/chain.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Initialize a Chain Header
- *
  * @ingroup RTEMSScoreChain
+ *
+ * @brief This source file contains the implementation of
+ *   _Chain_Initialize().
  */
 
 /*
diff --git a/cpukit/score/src/chainnodecount.c b/cpukit/score/src/chainnodecount.c
index 9f0bb38a28..0cd9f32e88 100644
--- a/cpukit/score/src/chainnodecount.c
+++ b/cpukit/score/src/chainnodecount.c
@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreChain
+ *
+ * @brief This source file contains the implementation of
+ *   _Chain_Node_count_unprotected().
+ */
 /*
  * Copyright (c) 2012 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/condition.c b/cpukit/score/src/condition.c
index 67d133feed..acc72fc1a6 100644
--- a/cpukit/score/src/condition.c
+++ b/cpukit/score/src/condition.c
@@ -1,3 +1,15 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScore
+ *
+ * @brief This source file contains the implementation of
+ *   _Condition_Wait(), _Condition_Wait_timed(), _Condition_Wait_recursive(),
+ *   _Condition_Wait_recursive_timed(),
+ *   _Condition_Wait_recursive_timed_ticks(), _Condition_Signal(), and
+ *   _Condition_Broadcast().
+ */
+
 /*
  * Copyright (c) 2015, 2016 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/configstackspacesize.c b/cpukit/score/src/configstackspacesize.c
index aca40640cf..ce3d7d4836 100644
--- a/cpukit/score/src/configstackspacesize.c
+++ b/cpukit/score/src/configstackspacesize.c
@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScore
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_configuration_get_stack_space_size().
+ */
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/score/src/corebarrier.c b/cpukit/score/src/corebarrier.c
index 28329b47f9..c9c9b04ed5 100644
--- a/cpukit/score/src/corebarrier.c
+++ b/cpukit/score/src/corebarrier.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Initialize CORE Barrier
- *  @ingroup RTEMSScoreBarrier
+ * @ingroup RTEMSScoreBarrier
+ *
+ * @brief This source file contains the implementation of
+ *   _CORE_barrier_Initialize().
  */
 
 /*
diff --git a/cpukit/score/src/corebarrierrelease.c b/cpukit/score/src/corebarrierrelease.c
index a2e68862b3..5d510107d6 100644
--- a/cpukit/score/src/corebarrierrelease.c
+++ b/cpukit/score/src/corebarrierrelease.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Manually releases the Barrier
- *
  * @ingroup RTEMSScoreBarrier
+ *
+ * @brief This source file contains the implementation of
+ *   _CORE_barrier_Do_flush().
  */
 
 /*
diff --git a/cpukit/score/src/corebarrierwait.c b/cpukit/score/src/corebarrierwait.c
index f45873ccb8..3da9b05953 100644
--- a/cpukit/score/src/corebarrierwait.c
+++ b/cpukit/score/src/corebarrierwait.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Wait For The Barrier
- *  @ingroup RTEMSScoreBarrier
+ * @ingroup RTEMSScoreBarrier
+ *
+ * @brief This source file contains the implementation of
+ *   _CORE_barrier_Seize().
  */
 
 /*
diff --git a/cpukit/score/src/coremsg.c b/cpukit/score/src/coremsg.c
index 967ce2355a..cf7f44ed17 100644
--- a/cpukit/score/src/coremsg.c
+++ b/cpukit/score/src/coremsg.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Initialize a Message Queue
- *  @ingroup RTEMSScoreMessageQueue
+ * @ingroup RTEMSScoreMessageQueue
+ *
+ * @brief This source file contains the implementation of
+ *   _CORE_message_queue_Initialize().
  */
 
 /*
diff --git a/cpukit/score/src/coremsgbroadcast.c b/cpukit/score/src/coremsgbroadcast.c
index d5c368d274..f119d49275 100644
--- a/cpukit/score/src/coremsgbroadcast.c
+++ b/cpukit/score/src/coremsgbroadcast.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Broadcast a Message to the Message Queue
- *  @ingroup RTEMSScoreMessageQueue
+ * @ingroup RTEMSScoreMessageQueue
+ *
+ * @brief This source file contains the implementation of
+ *   _CORE_message_queue_Broadcast().
  */
 
 /*
diff --git a/cpukit/score/src/coremsgclose.c b/cpukit/score/src/coremsgclose.c
index 98032dd3ad..1610d8166b 100644
--- a/cpukit/score/src/coremsgclose.c
+++ b/cpukit/score/src/coremsgclose.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Close a Message Queue
- *  @ingroup RTEMSScoreMessageQueue
+ * @ingroup RTEMSScoreMessageQueue
+ *
+ * @brief This source file contains the implementation of
+ *   _CORE_message_queue_Close().
  */
 
 /*
diff --git a/cpukit/score/src/coremsgflush.c b/cpukit/score/src/coremsgflush.c
index 11b40b2e2b..7330cdfe3d 100644
--- a/cpukit/score/src/coremsgflush.c
+++ b/cpukit/score/src/coremsgflush.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Flush Messages Routine
- *
  * @ingroup RTEMSScoreMessageQueue
+ *
+ * @brief This source file contains the implementation of
+ *   _CORE_message_queue_Flush().
  */
 
 /*
diff --git a/cpukit/score/src/coremsgflushwait.c b/cpukit/score/src/coremsgflushwait.c
index 03804ae335..c343147895 100644
--- a/cpukit/score/src/coremsgflushwait.c
+++ b/cpukit/score/src/coremsgflushwait.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Flush Waiting Threads.
- *
  * @ingroup RTEMSScoreMessageQueue
+ *
+ * @brief This source file contains the implementation of
+ *   _CORE_message_queue_Flush_waiting_threads().
  */
 
 /*
diff --git a/cpukit/score/src/coremsginsert.c b/cpukit/score/src/coremsginsert.c
index 1a2abc3c96..14b023d9e1 100644
--- a/cpukit/score/src/coremsginsert.c
+++ b/cpukit/score/src/coremsginsert.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreMessageQueue
  *
- * @brief Insert a Message into the Message Queue
+ * @brief This source file contains the implementation of
+ *   _CORE_message_queue_Insert_message().
  */
 
 /*
diff --git a/cpukit/score/src/coremsgseize.c b/cpukit/score/src/coremsgseize.c
index b2b9dbabdb..e44538ee17 100644
--- a/cpukit/score/src/coremsgseize.c
+++ b/cpukit/score/src/coremsgseize.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Seize a Message from the Message Queue
- *  @ingroup RTEMSScoreMessageQueue
+ * @ingroup RTEMSScoreMessageQueue
+ *
+ * @brief This source file contains the implementation of
+ *   _CORE_message_queue_Seize().
  */
 
 /*
diff --git a/cpukit/score/src/coremsgsubmit.c b/cpukit/score/src/coremsgsubmit.c
index 77fe30c0dd..fda000cc86 100644
--- a/cpukit/score/src/coremsgsubmit.c
+++ b/cpukit/score/src/coremsgsubmit.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief CORE Message Queue Submit
- *
  * @ingroup RTEMSScoreMessageQueue
+ *
+ * @brief This source file contains the implementation of
+ *   _CORE_message_queue_Submit().
  */
 
 /*
diff --git a/cpukit/score/src/coremutexseize.c b/cpukit/score/src/coremutexseize.c
index 5998935f29..77f13b3774 100644
--- a/cpukit/score/src/coremutexseize.c
+++ b/cpukit/score/src/coremutexseize.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Seize Mutex with Blocking
- *  @ingroup RTEMSScoreMutex
+ * @ingroup RTEMSScoreMutex
+ *
+ * @brief This source file contains the implementation of
+ *   _CORE_mutex_Seize_slow().
  */
 
 /*
diff --git a/cpukit/score/src/corerwlock.c b/cpukit/score/src/corerwlock.c
index 068a412861..516b696c91 100644
--- a/cpukit/score/src/corerwlock.c
+++ b/cpukit/score/src/corerwlock.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreRWLock
  *
- * @brief
+ * @brief This source file contains the implementation of
+ *   _CORE_RWLock_Initialize().
  */
 
 /*
diff --git a/cpukit/score/src/corerwlockobtainread.c b/cpukit/score/src/corerwlockobtainread.c
index ee74c3dc6d..2d084b1639 100644
--- a/cpukit/score/src/corerwlockobtainread.c
+++ b/cpukit/score/src/corerwlockobtainread.c
@@ -1,9 +1,10 @@
 /**
  * @file
- * 
+ *
  * @ingroup RTEMSScoreRWLock
  *
- * @brief Obtain RWLock for reading
+ * @brief This source file contains the implementation of
+ *   _CORE_RWLock_Seize_for_reading().
  */
 
 /*
diff --git a/cpukit/score/src/corerwlockobtainwrite.c b/cpukit/score/src/corerwlockobtainwrite.c
index ea0cdabcdc..4f1dbf5bd1 100644
--- a/cpukit/score/src/corerwlockobtainwrite.c
+++ b/cpukit/score/src/corerwlockobtainwrite.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreRWLock
  *
- * @brief RWLock Obtain for Writing
+ * @brief This source file contains the implementation of
+ *   _CORE_RWLock_Seize_for_writing().
  */
 
 /*
diff --git a/cpukit/score/src/corerwlockrelease.c b/cpukit/score/src/corerwlockrelease.c
index d79456872a..c309b31e8b 100644
--- a/cpukit/score/src/corerwlockrelease.c
+++ b/cpukit/score/src/corerwlockrelease.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Releases the RWLock
- *
  * @ingroup RTEMSScoreRWLock
+ *
+ * @brief This source file contains the implementation of
+ *   _CORE_RWLock_Surrender().
  */
 
 /*
diff --git a/cpukit/score/src/coresem.c b/cpukit/score/src/coresem.c
index 8f56da994f..f80e6d686a 100644
--- a/cpukit/score/src/coresem.c
+++ b/cpukit/score/src/coresem.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Core Semaphore Initialize
- *  @ingroup RTEMSScoreSemaphore
+ * @ingroup RTEMSScoreSemaphore
+ *
+ * @brief This source file contains the implementation of
+ *   _CORE_semaphore_Initialize().
  */
 
 /*
diff --git a/cpukit/score/src/coretod.c b/cpukit/score/src/coretod.c
index d402bb438d..2258714ad9 100644
--- a/cpukit/score/src/coretod.c
+++ b/cpukit/score/src/coretod.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Initializes the Time of Day Handler
- *
  * @ingroup RTEMSScoreTOD
+ *
+ * @brief This source file contains the definition of ::_TOD and the
+ *   implementation of _TOD_Lock(), _TOD_Unlock(), and _TOD_Is_owner().
  */
 
 /*  COPYRIGHT (c) 1989-2014.
diff --git a/cpukit/score/src/coretodadjust.c b/cpukit/score/src/coretodadjust.c
index e58d1e5d69..a746b0e004 100644
--- a/cpukit/score/src/coretodadjust.c
+++ b/cpukit/score/src/coretodadjust.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreTOD
  *
- * @brief Adjust the Time of Time
+ * @brief This source file contains the implementation of
+ *   _TOD_Adjust().
  */
 
 /*
diff --git a/cpukit/score/src/coretodhookdata.c b/cpukit/score/src/coretodhookdata.c
index c26b2ab813..299f59ef04 100644
--- a/cpukit/score/src/coretodhookdata.c
+++ b/cpukit/score/src/coretodhookdata.c
@@ -1,14 +1,15 @@
+/* SPDX-License-Identifier: BSD-2-Clause */
+
 /**
  * @file
  *
- * @brief TOD Hook Set
- *
  * @ingroup RTEMSScoreTODHooks
+ *
+ * @brief This source file contains the definition of
+ *   ::_TOD_Hooks.
  */
 
 /*
- *  SPDX-License-Identifier: BSD-2-Clause
- *
  *  COPYRIGHT (c) 2019.
  *  On-Line Applications Research Corporation (OAR).
  *
@@ -40,6 +41,5 @@
 
 #include <rtems/score/todimpl.h>
 #include <rtems/score/chainimpl.h>
- 
-Chain_Control _TOD_Hooks = CHAIN_INITIALIZER_EMPTY(_TOD_Hooks);
 
+Chain_Control _TOD_Hooks = CHAIN_INITIALIZER_EMPTY( _TOD_Hooks );
diff --git a/cpukit/score/src/coretodhookregister.c b/cpukit/score/src/coretodhookregister.c
index 794f3a1d1f..dbd3ddd22f 100644
--- a/cpukit/score/src/coretodhookregister.c
+++ b/cpukit/score/src/coretodhookregister.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Register Hook to be in TOD Hook Set
- *
  * @ingroup RTEMSScoreTODHooks
+ *
+ * @brief This source file contains the implementation of
+ *   _TOD_Hook_Register().
  */
 
 /*
@@ -40,7 +41,7 @@
 
 #include <rtems/score/todimpl.h>
 #include <rtems/score/chainimpl.h>
- 
+
 void _TOD_Hook_Register(
   TOD_Hook *hook
 )
@@ -48,7 +49,7 @@ void _TOD_Hook_Register(
   /*
    * At this time, this method does NOT have a Classic or POSIX API
    * that exports it. Any use of this method will be a direct call.
-   * It should only be called while NOT holding the TOD lock. 
+   * It should only be called while NOT holding the TOD lock.
    */
   _Assert( !_TOD_Is_owner() );
 
diff --git a/cpukit/score/src/coretodhookrun.c b/cpukit/score/src/coretodhookrun.c
index 10d3c57748..bf7d88efa9 100644
--- a/cpukit/score/src/coretodhookrun.c
+++ b/cpukit/score/src/coretodhookrun.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Run TOD Hook Set
- *
  * @ingroup RTEMSScoreTODHooks
+ *
+ * @brief This source file contains the implementation of
+ *   _TOD_Hook_Run().
  */
 
 /*
diff --git a/cpukit/score/src/coretodhookunregister.c b/cpukit/score/src/coretodhookunregister.c
index 72b11a158a..5adb8b4c3f 100644
--- a/cpukit/score/src/coretodhookunregister.c
+++ b/cpukit/score/src/coretodhookunregister.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Remove Hook from TOD Hook Set
- *
  * @ingroup RTEMSScoreTODHooks
+ *
+ * @brief This source file contains the implementation of
+ *   _TOD_Hook_Unregister().
  */
 
 /*
@@ -40,7 +41,7 @@
 
 #include <rtems/score/todimpl.h>
 #include <rtems/score/chainimpl.h>
- 
+
 void _TOD_Hook_Unregister(
   TOD_Hook *hook
 )
@@ -48,7 +49,7 @@ void _TOD_Hook_Unregister(
   /*
    * At this time, this method does NOT have a Classic or POSIX API
    * that exports it. Any use of this method will be a direct call.
-   * It should only be called while NOT holding the TOD lock. 
+   * It should only be called while NOT holding the TOD lock.
    */
   _Assert( !_TOD_Is_owner() );
 
diff --git a/cpukit/score/src/coretodset.c b/cpukit/score/src/coretodset.c
index 8d09af0ebd..5fc01215e0 100644
--- a/cpukit/score/src/coretodset.c
+++ b/cpukit/score/src/coretodset.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Set Time of Day Given a Timestamp
- *
  * @ingroup RTEMSScoreTOD
+ *
+ * @brief This source file contains the implementation of
+ *   _TOD_Set().
  */
 
 /*  COPYRIGHT (c) 1989-2007.
diff --git a/cpukit/score/src/coretodtickspersec.c b/cpukit/score/src/coretodtickspersec.c
index 107614c730..f4860975bc 100644
--- a/cpukit/score/src/coretodtickspersec.c
+++ b/cpukit/score/src/coretodtickspersec.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreTOD
  *
- * @brief Convert Ticks To Seconds
+ * @brief This source file contains the implementation of
+ *   TOD_TICKS_PER_SECOND_method().
  */
 
 /*  COPYRIGHT (c) 1989-2014.
diff --git a/cpukit/score/src/debugisthreaddispatchingallowed.c b/cpukit/score/src/debugisthreaddispatchingallowed.c
index e75c462ab5..7cb93b55f9 100644
--- a/cpukit/score/src/debugisthreaddispatchingallowed.c
+++ b/cpukit/score/src/debugisthreaddispatchingallowed.c
@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScore
+ *
+ * @brief This source file contains the implementation of
+ *   _Debug_Is_thread_dispatching_allowed().
+ */
 /*
  * Copyright (c) 2013-2014 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/freechain.c b/cpukit/score/src/freechain.c
index e5b1f84a63..7756b86cec 100644
--- a/cpukit/score/src/freechain.c
+++ b/cpukit/score/src/freechain.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreFreechain
  *
- * @brief Freechain Handler Implementation
+ * @brief This source file contains the implementation of
+ *   _Freechain_Extend(), _Freechain_Get(), and _Freechain_Put().
  */
 
 /*
diff --git a/cpukit/score/src/futex.c b/cpukit/score/src/futex.c
index de430a87ae..b65a843704 100644
--- a/cpukit/score/src/futex.c
+++ b/cpukit/score/src/futex.c
@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScore
+ *
+ * @brief This source file contains the implementation of
+ *   _Futex_Wait() and _Futex_Wake().
+ */
 /*
  * Copyright (c) 2015, 2016 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/heap.c b/cpukit/score/src/heap.c
index 429e8cdd9a..ca36f4a384 100644
--- a/cpukit/score/src/heap.c
+++ b/cpukit/score/src/heap.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreHeap
  *
- * @brief Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Heap_Initialize() and _Heap_Block_allocate().
  */
 
 /*
diff --git a/cpukit/score/src/heapallocate.c b/cpukit/score/src/heapallocate.c
index 4b8b3f0de6..663f7ac775 100644
--- a/cpukit/score/src/heapallocate.c
+++ b/cpukit/score/src/heapallocate.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreHeap
  *
- * @brief Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Heap_Allocate_aligned_with_boundary().
  */
 
 /*
diff --git a/cpukit/score/src/heapextend.c b/cpukit/score/src/heapextend.c
index 4c6166fba2..332bf1edec 100644
--- a/cpukit/score/src/heapextend.c
+++ b/cpukit/score/src/heapextend.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreHeap
  *
- * @brief Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Heap_Extend().
  */
 
 /*
diff --git a/cpukit/score/src/heapfree.c b/cpukit/score/src/heapfree.c
index 086cfe72d2..d2ab5d4d1d 100644
--- a/cpukit/score/src/heapfree.c
+++ b/cpukit/score/src/heapfree.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreHeap
  *
- * @brief Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Heap_Free().
  */
 
 /*
diff --git a/cpukit/score/src/heapgetfreeinfo.c b/cpukit/score/src/heapgetfreeinfo.c
index 2fed4d7c1b..a72ba1572c 100644
--- a/cpukit/score/src/heapgetfreeinfo.c
+++ b/cpukit/score/src/heapgetfreeinfo.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreHeap
  *
- * @brief Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Heap_Get_free_information().
  */
 
 /*
diff --git a/cpukit/score/src/heapgetinfo.c b/cpukit/score/src/heapgetinfo.c
index 2928e210fa..9388664276 100644
--- a/cpukit/score/src/heapgetinfo.c
+++ b/cpukit/score/src/heapgetinfo.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreHeap
  *
- * @brief Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Heap_Get_information().
  */
 
 /*
diff --git a/cpukit/score/src/heapgreedy.c b/cpukit/score/src/heapgreedy.c
index 980459ff46..dfb77a715b 100644
--- a/cpukit/score/src/heapgreedy.c
+++ b/cpukit/score/src/heapgreedy.c
@@ -3,7 +3,9 @@
  *
  * @ingroup RTEMSScoreHeap
  *
- * @brief Heap Handler API.
+ * @brief This source file contains the implementation of
+ *   _Heap_Greedy_allocate(), _Heap_Greedy_allocate_all_except_largest(), and
+ *   _Heap_Greedy_free().
  */
 
 /*
diff --git a/cpukit/score/src/heapiterate.c b/cpukit/score/src/heapiterate.c
index 22db510b4a..bf3f5416d4 100644
--- a/cpukit/score/src/heapiterate.c
+++ b/cpukit/score/src/heapiterate.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreHeap
  *
- * @brief _Heap_Iterate() implementation.
+ * @brief This source file contains the implementation of
+ *   _Heap_Iterate().
  */
 
 /*
diff --git a/cpukit/score/src/heapnoextend.c b/cpukit/score/src/heapnoextend.c
index 1788420e1c..99952e690c 100644
--- a/cpukit/score/src/heapnoextend.c
+++ b/cpukit/score/src/heapnoextend.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreHeap
  *
- * @brief Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Heap_No_extend().
  */
 
 /*
diff --git a/cpukit/score/src/heapresizeblock.c b/cpukit/score/src/heapresizeblock.c
index c0e1daa112..62d0b64b6b 100644
--- a/cpukit/score/src/heapresizeblock.c
+++ b/cpukit/score/src/heapresizeblock.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreHeap
  *
- * @brief Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Heap_Resize_block().
  */
 
 /*
diff --git a/cpukit/score/src/heapsizeofuserarea.c b/cpukit/score/src/heapsizeofuserarea.c
index 4f17073494..7a12ab53c8 100644
--- a/cpukit/score/src/heapsizeofuserarea.c
+++ b/cpukit/score/src/heapsizeofuserarea.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreHeap
  *
- * @brief Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Heap_Size_of_alloc_area().
  */
 
 /*
diff --git a/cpukit/score/src/heapwalk.c b/cpukit/score/src/heapwalk.c
index 50458437ee..dbcd0d4cd5 100644
--- a/cpukit/score/src/heapwalk.c
+++ b/cpukit/score/src/heapwalk.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreHeap
  *
- * @brief Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Heap_Walk().
  */
 
 /*
diff --git a/cpukit/score/src/interr.c b/cpukit/score/src/interr.c
index f59f352ba2..3f5ec2c473 100644
--- a/cpukit/score/src/interr.c
+++ b/cpukit/score/src/interr.c
@@ -3,7 +3,9 @@
  *
  * @ingroup RTEMSScoreIntErr
  *
- * @brief Initiates system termination
+ * @brief This source file contains the definition of ::_System_state_Current
+ *   and ::_Internal_errors_What_happened and implementation of _Terminate() and
+ *   _Internal_error().
  */
 
 /*
diff --git a/cpukit/score/src/iobase64.c b/cpukit/score/src/iobase64.c
index ab0498438d..bbf7658c2a 100644
--- a/cpukit/score/src/iobase64.c
+++ b/cpukit/score/src/iobase64.c
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: ISC */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreIO
+ *
+ * @brief This source file contains the implementation of
+ *   _IO_Base64().
+ */
+
 /*
  * Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
  * Copyright (C) 2004, 2005, 2007, 2009  Internet Systems Consortium, Inc. ("ISC")
diff --git a/cpukit/score/src/ioprintf.c b/cpukit/score/src/ioprintf.c
index 2fe65f41d0..107ffd94c4 100644
--- a/cpukit/score/src/ioprintf.c
+++ b/cpukit/score/src/ioprintf.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreIO
+ *
+ * @brief This source file contains the implementation of
+ *   _IO_Printf().
+ */
+
 /*
  * Copyright (c) 2017 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/iovprintf.c b/cpukit/score/src/iovprintf.c
index f3f8219261..0e8eb0b47b 100644
--- a/cpukit/score/src/iovprintf.c
+++ b/cpukit/score/src/iovprintf.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreIO
+ *
+ * @brief This source file contains the implementation of
+ *   _IO_Vprintf().
+ */
+
 /*-
  * SPDX-License-Identifier: BSD-3-Clause
  *
diff --git a/cpukit/score/src/isr.c b/cpukit/score/src/isr.c
index 826ad44df4..519532b283 100644
--- a/cpukit/score/src/isr.c
+++ b/cpukit/score/src/isr.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Initialize the ISR handler
- *  @ingroup RTEMSScoreISR
+ * @ingroup RTEMSScoreISR
+ *
+ * @brief This source file contains the definition of ::_ISR_Vector_table and
+ *   the implementation of _ISR_Handler_initialization().
  */
 
 /*
diff --git a/cpukit/score/src/isrisinprogress.c b/cpukit/score/src/isrisinprogress.c
index 52d6779800..eb7bbea8e4 100644
--- a/cpukit/score/src/isrisinprogress.c
+++ b/cpukit/score/src/isrisinprogress.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreISR
  *
- * @brief ISR Is In Progress Default Implementation
+ * @brief This source file contains the default implementation of
+ *   _ISR_Is_in_progress().
  */
 
 /*
diff --git a/cpukit/score/src/iterateoverthreads.c b/cpukit/score/src/iterateoverthreads.c
index 97c50538b8..05b03ac0ac 100644
--- a/cpukit/score/src/iterateoverthreads.c
+++ b/cpukit/score/src/iterateoverthreads.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Iterates Over All Threads
- *  @ingroup RTEMSScoreThread
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_iterate_over_all_threads().
  */
 
 /*
diff --git a/cpukit/score/src/kern_tc.c b/cpukit/score/src/kern_tc.c
index 1b65cf41ee..a93cfaeff0 100644
--- a/cpukit/score/src/kern_tc.c
+++ b/cpukit/score/src/kern_tc.c
@@ -1,3 +1,20 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreTimecounter
+ *
+ * @brief This source file contains the definition of
+ *  ::_Timecounter, ::_Timecounter_Time_second, and ::_Timecounter_Time_uptime
+ *  and the implementation of _Timecounter_Binuptime(),
+ *  _Timecounter_Nanouptime(), _Timecounter_Microuptime(),
+ *  _Timecounter_Bintime(), _Timecounter_Nanotime(), _Timecounter_Microtime(),
+ *  _Timecounter_Getbinuptime(), _Timecounter_Getnanouptime(),
+ *  _Timecounter_Getmicrouptime(), _Timecounter_Getbintime(),
+ *  _Timecounter_Getnanotime(), _Timecounter_Getmicrotime(),
+ *  _Timecounter_Getboottime(), _Timecounter_Getboottimebin(), and
+ *  _Timecounter_Install().
+ */
+
 /*-
  * ----------------------------------------------------------------------------
  * "THE BEER-WARE LICENSE" (Revision 42):
diff --git a/cpukit/score/src/libatomic.c b/cpukit/score/src/libatomic.c
index 9151ecc906..13113db583 100644
--- a/cpukit/score/src/libatomic.c
+++ b/cpukit/score/src/libatomic.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreAtomic
+ *
+ * @brief This source file contains the implementation of
+ *   _Libatomic_Protect_start() and _Libatomic_Protect_end().
+ */
+
 /*
  * Copyright (c) 2016 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/log2table.c b/cpukit/score/src/log2table.c
index 58353678be..0a4e37ad79 100644
--- a/cpukit/score/src/log2table.c
+++ b/cpukit/score/src/log2table.c
@@ -1,9 +1,10 @@
-/*
+/**
  * @file
  *
- * @brief Priority Bit Map Implementation
- *
  * @ingroup RTEMSScorePriorityBitmap
+ *
+ * @brief This source file contains the definition of
+ *   ::_Bitfield_Leading_zeros.
  */
 
 /*
diff --git a/cpukit/score/src/memoryallocate.c b/cpukit/score/src/memoryallocate.c
index dc87fda96f..e2aed7aa1d 100644
--- a/cpukit/score/src/memoryallocate.c
+++ b/cpukit/score/src/memoryallocate.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreMemory
+ *
+ * @brief This source file contains the implementation of
+ *   _Memory_Allocate().
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/score/src/memorydirtyfreeareas.c b/cpukit/score/src/memorydirtyfreeareas.c
index d77d21e913..fc6c2630bf 100644
--- a/cpukit/score/src/memorydirtyfreeareas.c
+++ b/cpukit/score/src/memorydirtyfreeareas.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreMemory
+ *
+ * @brief This source file contains the implementation of
+ *   _Memory_Dirty_free_areas().
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/score/src/memoryfill.c b/cpukit/score/src/memoryfill.c
index 1899c6903b..617bf6911e 100644
--- a/cpukit/score/src/memoryfill.c
+++ b/cpukit/score/src/memoryfill.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreMemory
+ *
+ * @brief This source file contains the implementation of
+ *   _Memory_Fill().
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/score/src/memoryzerobeforeuse.c b/cpukit/score/src/memoryzerobeforeuse.c
index c9057cfc23..9143cd9c7d 100644
--- a/cpukit/score/src/memoryzerobeforeuse.c
+++ b/cpukit/score/src/memoryzerobeforeuse.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreMemory
+ *
+ * @brief This source file contains the definition of
+ *   ::_Memory_Zero_before_use.
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/score/src/memoryzerofreeareas.c b/cpukit/score/src/memoryzerofreeareas.c
index a8602d11b8..4ea0812426 100644
--- a/cpukit/score/src/memoryzerofreeareas.c
+++ b/cpukit/score/src/memoryzerofreeareas.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreMemory
+ *
+ * @brief This source file contains the implementation of
+ *   _Memory_Zero_free_areas().
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/score/src/mpci.c b/cpukit/score/src/mpci.c
index dff2338ed6..a18155351a 100644
--- a/cpukit/score/src/mpci.c
+++ b/cpukit/score/src/mpci.c
@@ -3,7 +3,18 @@
  *
  * @ingroup RTEMSScoreMPCI
  *
- * @brief Multiprocessing Communications Interface (MPCI) Handler
+ * @brief This source file contains the definition of
+ *   ::_System_state_Is_multiprocessing, ::_MPCI_Semaphore,
+ *   ::_MPCI_Remote_blocked_threads, ::_MPCI_table, ::_MPCI_Receive_server_tcb,
+ *   ::_MPCI_Packet_processors and the implementation of
+ *   _MPCI_Register_packet_processor(), _MPCI_Get_packet(),
+ *   _MPCI_Send_process_packet(), _MPCI_Send_request_packet(),
+ *   _MPCI_Send_response_packet(), _MPCI_Receive_packet(),
+ *   _MPCI_Process_response(), _MPCI_Receive_server(), _MPCI_Announce(),
+ *   _MPCI_Internal_packets_Send_process_packet(),
+ *   _MPCI_Internal_packets_Process_packet(),
+ *   _MPCI_Internal_packets_Get_packet(), and the MPCI Handler system
+ *   initialization.
  */
 
 /*
diff --git a/cpukit/score/src/mpcidefault.c b/cpukit/score/src/mpcidefault.c
index ea3e2eaf41..c30ed8d373 100644
--- a/cpukit/score/src/mpcidefault.c
+++ b/cpukit/score/src/mpcidefault.c
@@ -3,7 +3,10 @@
  *
  * @ingroup RTEMSScoreMPCI
  *
- * @brief Multiprocessing Communications Interface (MPCI) Default Configuration
+ * @brief This source file contains a definition of
+ *   ::_Objects_MP_Controls, ::_Thread_MP_Proxies, and
+ *   ::_MPCI_Receive_server_stack for an application configuration with only
+ *   the local MPCI node and no MP objects.
  */
 
 /*
diff --git a/cpukit/score/src/mutex.c b/cpukit/score/src/mutex.c
index 0499719ba6..88a390f323 100644
--- a/cpukit/score/src/mutex.c
+++ b/cpukit/score/src/mutex.c
@@ -1,3 +1,15 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScore
+ *
+ * @brief This source file contains the implementation of
+ *   _Mutex_Acquire(), _Mutex_Acquire_timed(), _Mutex_Acquire_timed_ticks(),
+ *   _Mutex_Try_acquire(), _Mutex_Release(), _Mutex_recursive_Acquire(),
+ *   _Mutex_recursive_Acquire_timed(), _Mutex_recursive_Try_acquire(), and
+ *   _Mutex_recursive_Release().
+ */
+
 /*
  * Copyright (c) 2015, 2016 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/objectactivecount.c b/cpukit/score/src/objectactivecount.c
index c658fc21e3..a723b692a5 100644
--- a/cpukit/score/src/objectactivecount.c
+++ b/cpukit/score/src/objectactivecount.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreObject
+ *
+ * @brief This source file contains the implementation of
+ *   _Objects_Active_count().
+ */
+
 /*
  * Copyright (c) 2012 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/objectallocate.c b/cpukit/score/src/objectallocate.c
index e7d587c25e..ba126d2533 100644
--- a/cpukit/score/src/objectallocate.c
+++ b/cpukit/score/src/objectallocate.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreObject
  *
- * @brief Allocate Object
+ * @brief This source file contains the implementation of
+ *   _Objects_Allocate().
  */
 
 /*
diff --git a/cpukit/score/src/objectallocatenone.c b/cpukit/score/src/objectallocatenone.c
index 5ac0991bc5..a1bead5f79 100644
--- a/cpukit/score/src/objectallocatenone.c
+++ b/cpukit/score/src/objectallocatenone.c
@@ -1,12 +1,15 @@
+/* SPDX-License-Identifier: BSD-2-Clause */
+
 /**
  * @file
  *
  * @ingroup RTEMSScoreObject
+ *
+ * @brief This source file contains the implementation of
+ *   _Objects_Allocate_none().
  */
 
 /*
- * SPDX-License-Identifier: BSD-2-Clause
- *
  * Copyright (C) 2019 embedded brains GmbH
  *
  * Redistribution and use in source and binary forms, with or without
diff --git a/cpukit/score/src/objectallocatestatic.c b/cpukit/score/src/objectallocatestatic.c
index 160c68b23c..0521c8191f 100644
--- a/cpukit/score/src/objectallocatestatic.c
+++ b/cpukit/score/src/objectallocatestatic.c
@@ -1,12 +1,15 @@
+/* SPDX-License-Identifier: BSD-2-Clause */
+
 /**
  * @file
  *
  * @ingroup RTEMSScoreObject
+ *
+ * @brief This source file contains the implementation of
+ *   _Objects_Allocate_static().
  */
 
 /*
- * SPDX-License-Identifier: BSD-2-Clause
- *
  * Copyright (C) 2019 embedded brains GmbH
  *
  * Redistribution and use in source and binary forms, with or without
diff --git a/cpukit/score/src/objectallocateunlimited.c b/cpukit/score/src/objectallocateunlimited.c
index b975fe5c3b..274a69640b 100644
--- a/cpukit/score/src/objectallocateunlimited.c
+++ b/cpukit/score/src/objectallocateunlimited.c
@@ -1,12 +1,15 @@
+/* SPDX-License-Identifier: BSD-2-Clause */
+
 /**
  * @file
  *
  * @ingroup RTEMSScoreObject
+ *
+ * @brief This source file contains the implementation of
+ *   _Objects_Allocate_unlimited().
  */
 
 /*
- * SPDX-License-Identifier: BSD-2-Clause
- *
  * Copyright (C) 2020 embedded brains GmbH
  *
  * Redistribution and use in source and binary forms, with or without
diff --git a/cpukit/score/src/objectapimaximumclass.c b/cpukit/score/src/objectapimaximumclass.c
index 0fb87ab772..7a52d787ef 100644
--- a/cpukit/score/src/objectapimaximumclass.c
+++ b/cpukit/score/src/objectapimaximumclass.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Object API Maximum Class
- *  @ingroup RTEMSScoreObject
+ * @ingroup RTEMSScoreObject
+ *
+ * @brief This source file contains the implementation of
+ *   _Objects_API_maximum_class().
  */
 
 /*
diff --git a/cpukit/score/src/objectclose.c b/cpukit/score/src/objectclose.c
index 4fd24198f4..60a1f3864f 100644
--- a/cpukit/score/src/objectclose.c
+++ b/cpukit/score/src/objectclose.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Close Object
- *  @ingroup RTEMSScoreObject
+ * @ingroup RTEMSScoreObject
+ *
+ * @brief This source file contains the implementation of
+ *   _Objects_Close().
  */
 
 /*
diff --git a/cpukit/score/src/objectextendinformation.c b/cpukit/score/src/objectextendinformation.c
index f4c96462bf..9796eb9e56 100644
--- a/cpukit/score/src/objectextendinformation.c
+++ b/cpukit/score/src/objectextendinformation.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreObject
  *
- * @brief Extend Set of Objects
+ * @brief This source file contains the implementation of
+ *   _Objects_Extend_information().
  */
 
 /*
diff --git a/cpukit/score/src/objectfree.c b/cpukit/score/src/objectfree.c
index 1f7aa37e3f..9b631e5b6d 100644
--- a/cpukit/score/src/objectfree.c
+++ b/cpukit/score/src/objectfree.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Free Object
- *  @ingroup RTEMSScoreObject
+ * @ingroup RTEMSScoreObject
+ *
+ * @brief This source file contains the implementation of
+ *   _Objects_Free_unlimited().
  */
 
 /*
diff --git a/cpukit/score/src/objectfreestatic.c b/cpukit/score/src/objectfreestatic.c
index 2a9411bb58..4bdc0e1071 100644
--- a/cpukit/score/src/objectfreestatic.c
+++ b/cpukit/score/src/objectfreestatic.c
@@ -1,12 +1,15 @@
+/* SPDX-License-Identifier: BSD-2-Clause */
+
 /**
  * @file
  *
  * @ingroup RTEMSScoreObject
+ *
+ * @brief This source file contains the implementation of
+ *   _Objects_Free_static().
  */
 
 /*
- * SPDX-License-Identifier: BSD-2-Clause
- *
  * Copyright (C) 2019 embedded brains GmbH
  *
  * Redistribution and use in source and binary forms, with or without
diff --git a/cpukit/score/src/objectgetinfo.c b/cpukit/score/src/objectgetinfo.c
index b0ca7e2766..07b401faf0 100644
--- a/cpukit/score/src/objectgetinfo.c
+++ b/cpukit/score/src/objectgetinfo.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Get Object Information
- *  @ingroup RTEMSScoreObject
+ * @ingroup RTEMSScoreObject
+ *
+ * @brief This source file contains the implementation of
+ *   _Objects_Get_information().
  */
 
 /*
diff --git a/cpukit/score/src/objectgetinfoid.c b/cpukit/score/src/objectgetinfoid.c
index 99243cc938..b127ef4e47 100644
--- a/cpukit/score/src/objectgetinfoid.c
+++ b/cpukit/score/src/objectgetinfoid.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Get Information of an Object from an ID
+ * @ingroup RTEMSScoreObject
  *
- * @ingroup RTEMSScore
+ * @brief This source file contains the implementation of
+ *   _Objects_Get_information_id().
  */
 
 /*
diff --git a/cpukit/score/src/objectgetlocal.c b/cpukit/score/src/objectgetlocal.c
index a09f3ebcaf..ac5155c819 100644
--- a/cpukit/score/src/objectgetlocal.c
+++ b/cpukit/score/src/objectgetlocal.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Object Get Local
- *  @ingroup RTEMSScoreObject
+ * @ingroup RTEMSScoreObject
+ *
+ * @brief This source file contains the implementation of
+ *   _Objects_Get().
  */
 
 /*
diff --git a/cpukit/score/src/objectgetnameasstring.c b/cpukit/score/src/objectgetnameasstring.c
index dc0ec9372d..bf6daeb213 100644
--- a/cpukit/score/src/objectgetnameasstring.c
+++ b/cpukit/score/src/objectgetnameasstring.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Extracts a Node from a Chain
+ * @ingroup RTEMSScoreObject
  *
- * @ingroup RTEMSScore
+ * @brief This source file contains the implementation of
+ *   _Objects_Name_to_string() and _Objects_Get_name_as_string().
  */
 
 /*
diff --git a/cpukit/score/src/objectgetnext.c b/cpukit/score/src/objectgetnext.c
index 841d5aa8e2..7141ca3620 100644
--- a/cpukit/score/src/objectgetnext.c
+++ b/cpukit/score/src/objectgetnext.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreObject
  *
- * @brief Get Pointer to Next Object that is Active
+ * @brief This source file contains the implementation of
+ *   _Objects_Get_next().
  */
 
 /*
diff --git a/cpukit/score/src/objectgetnoprotection.c b/cpukit/score/src/objectgetnoprotection.c
index f084d15382..e6e96bc020 100644
--- a/cpukit/score/src/objectgetnoprotection.c
+++ b/cpukit/score/src/objectgetnoprotection.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief  Get Object without Dispatching Protection
- *  @ingroup RTEMSScoreObject
+ * @ingroup RTEMSScoreObject
+ *
+ * @brief This source file contains the implementation of
+ *   _Objects_Get_no_protection().
  */
 
 /*
diff --git a/cpukit/score/src/objectidtoname.c b/cpukit/score/src/objectidtoname.c
index a689102c8c..a959636870 100644
--- a/cpukit/score/src/objectidtoname.c
+++ b/cpukit/score/src/objectidtoname.c
@@ -1,8 +1,10 @@
-/*
- *  @file
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreObject
  *
- *  @brief Object id to name
- *  @ingroup RTEMSScore
+ * @brief This source file contains the implementation of
+ *   _Objects_Id_to_name().
  */
 
 /*
diff --git a/cpukit/score/src/objectinitializeinformation.c b/cpukit/score/src/objectinitializeinformation.c
index b2cb85322f..d9e200bfde 100644
--- a/cpukit/score/src/objectinitializeinformation.c
+++ b/cpukit/score/src/objectinitializeinformation.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreObject
  *
- * @brief Initialize Object Information
+ * @brief This source file contains the implementation of
+ *   _Objects_Initialize_information().
  */
 
 /*
diff --git a/cpukit/score/src/objectmp.c b/cpukit/score/src/objectmp.c
index 612fdacca0..b44ef65e94 100644
--- a/cpukit/score/src/objectmp.c
+++ b/cpukit/score/src/objectmp.c
@@ -1,8 +1,17 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Objects MP Support
- *  @ingroup RTEMSScoreObjectMP
+ * @ingroup RTEMSScoreObjectMP
+ *
+ * @brief This source file contains the definition of
+ *   ::_Objects_Local_node, ::_Objects_Maximum_nodes,
+ *   ::_Objects_MP_Maximum_global_objects and the implementation of
+ *   _Objects_MP_Handler_early_initialization(),
+ *   _Objects_MP_Handler_initialization(), _Objects_MP_Open(),
+ *   _Objects_MP_Allocate_and_open(), _Objects_MP_Close(),
+ *   _Objects_MP_Global_name_search(), _Objects_MP_Is_remote(),
+ *   _Objects_MP_Allocate_global_object(), and
+ *   _Objects_MP_Free_global_object().
  */
 
 /*
diff --git a/cpukit/score/src/objectnamespaceremove.c b/cpukit/score/src/objectnamespaceremove.c
index 27f48f2460..4cbf34eac0 100644
--- a/cpukit/score/src/objectnamespaceremove.c
+++ b/cpukit/score/src/objectnamespaceremove.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Removes Object from Namespace
+ * @ingroup RTEMSScoreObject
  *
- * @ingroup RTEMSScore
+ * @brief This source file contains the implementation of
+ *   _Objects_Namespace_remove_string().
  */
 
 /*
diff --git a/cpukit/score/src/objectnametoid.c b/cpukit/score/src/objectnametoid.c
index ba73bdbad6..da5cbabbc4 100644
--- a/cpukit/score/src/objectnametoid.c
+++ b/cpukit/score/src/objectnametoid.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Object Name To Id
- *  @ingroup RTEMSScore
+ * @ingroup RTEMSScoreObject
+ *
+ * @brief This source file contains the implementation of
+ *   _Objects_Name_to_id_u32().
  */
 
 /*
diff --git a/cpukit/score/src/objectnametoidstring.c b/cpukit/score/src/objectnametoidstring.c
index 38054bface..d08652f88a 100644
--- a/cpukit/score/src/objectnametoidstring.c
+++ b/cpukit/score/src/objectnametoidstring.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreObject
  *
- * @brief Object ID to Name
+ * @brief This source file contains the implementation of
+ *   _Objects_Get_by_name().
  */
 
 /*
diff --git a/cpukit/score/src/objectsetname.c b/cpukit/score/src/objectsetname.c
index 0808ab87af..85b49ff13f 100644
--- a/cpukit/score/src/objectsetname.c
+++ b/cpukit/score/src/objectsetname.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreObject
  *
- * @brief Set Objects Name
+ * @brief This source file contains the implementation of
+ *   _Objects_Set_name().
  */
 
 /*
diff --git a/cpukit/score/src/objectshrinkinformation.c b/cpukit/score/src/objectshrinkinformation.c
index 73f91617b5..9c4a71bac6 100644
--- a/cpukit/score/src/objectshrinkinformation.c
+++ b/cpukit/score/src/objectshrinkinformation.c
@@ -1,7 +1,10 @@
 /**
  * @file
  *
- * @brief Shrink an Object Class Information Record
+ * @ingroup RTEMSScoreObject
+ *
+ * @brief This source file contains the implementation of
+ *   _Objects_Free_objects_block() and _Objects_Shrink_information().
  */
 
 /*
diff --git a/cpukit/score/src/once.c b/cpukit/score/src/once.c
index 2b2cc0e89b..cf576e90ef 100644
--- a/cpukit/score/src/once.c
+++ b/cpukit/score/src/once.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreOnce
+ *
+ * @brief This source file contains the implementation of
+ *   _Once(), _Once_Lock(), and _Once_Unlock().
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/score/src/opt_compat.h b/cpukit/score/src/opt_compat.h
index e69de29bb2..b450491bb7 100644
--- a/cpukit/score/src/opt_compat.h
+++ b/cpukit/score/src/opt_compat.h
@@ -0,0 +1,7 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreTimecounter
+ *
+ * @brief This header file is provided for FreeBSD compatibility.
+ */
diff --git a/cpukit/score/src/opt_ffclock.h b/cpukit/score/src/opt_ffclock.h
index e69de29bb2..b450491bb7 100644
--- a/cpukit/score/src/opt_ffclock.h
+++ b/cpukit/score/src/opt_ffclock.h
@@ -0,0 +1,7 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreTimecounter
+ *
+ * @brief This header file is provided for FreeBSD compatibility.
+ */
diff --git a/cpukit/score/src/opt_ntp.h b/cpukit/score/src/opt_ntp.h
index e69de29bb2..b450491bb7 100644
--- a/cpukit/score/src/opt_ntp.h
+++ b/cpukit/score/src/opt_ntp.h
@@ -0,0 +1,7 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreTimecounter
+ *
+ * @brief This header file is provided for FreeBSD compatibility.
+ */
diff --git a/cpukit/score/src/percpu.c b/cpukit/score/src/percpu.c
index 6aebfc2637..e254f306eb 100644
--- a/cpukit/score/src/percpu.c
+++ b/cpukit/score/src/percpu.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup PerCPU
+ * @ingroup RTEMSScorePerCPU
  *
- * @brief Allocate and Initialize Per CPU Structures
+ * @brief This source file contains a definition of ::_Per_CPU_Information and
+ *   the implementation of _Per_CPU_State_change().
  */
 
 /*
diff --git a/cpukit/score/src/percpuasm.c b/cpukit/score/src/percpuasm.c
index 816e502226..9b0ce86c26 100644
--- a/cpukit/score/src/percpuasm.c
+++ b/cpukit/score/src/percpuasm.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScorePerCPU
+ *
+ * @brief This source file contains the static assertions for defines used in
+ *   assembler files.
+ */
+
 /*
  * Copyright (c) 2012, 2016 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/percpustatewait.c b/cpukit/score/src/percpustatewait.c
index 0c2e0a580c..9d9f590df5 100644
--- a/cpukit/score/src/percpustatewait.c
+++ b/cpukit/score/src/percpustatewait.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScorePerCPU
+ *
+ * @brief This source file contains the implementation of
+ *   _Per_CPU_State_wait_for_non_initial_state().
+ */
+
 /*
  * Copyright (c) 2014 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/pheapallocate.c b/cpukit/score/src/pheapallocate.c
index 7edbbf9e06..8bf357869c 100644
--- a/cpukit/score/src/pheapallocate.c
+++ b/cpukit/score/src/pheapallocate.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreProtHeap
  *
- * @brief Protected Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Protected_heap_Allocate_aligned_with_boundary().
  */
 
 /*
diff --git a/cpukit/score/src/pheapextend.c b/cpukit/score/src/pheapextend.c
index 26c94ba625..c7aa11ed3c 100644
--- a/cpukit/score/src/pheapextend.c
+++ b/cpukit/score/src/pheapextend.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreProtHeap
  *
- * @brief Protected Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Protected_heap_Extend().
  */
 
 /*
diff --git a/cpukit/score/src/pheapfree.c b/cpukit/score/src/pheapfree.c
index 73a51cd7e7..0e4b2b4687 100644
--- a/cpukit/score/src/pheapfree.c
+++ b/cpukit/score/src/pheapfree.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreProtHeap
  *
- * @brief Protected Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Protected_heap_Free().
  */
 
 /*
diff --git a/cpukit/score/src/pheapgetblocksize.c b/cpukit/score/src/pheapgetblocksize.c
index fc503e6b8d..4ad5e275a6 100644
--- a/cpukit/score/src/pheapgetblocksize.c
+++ b/cpukit/score/src/pheapgetblocksize.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreProtHeap
  *
- * @brief Protected Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Protected_heap_Get_block_size().
  */
 
 /*
diff --git a/cpukit/score/src/pheapgetfreeinfo.c b/cpukit/score/src/pheapgetfreeinfo.c
index 38e3103c0c..6874db8151 100644
--- a/cpukit/score/src/pheapgetfreeinfo.c
+++ b/cpukit/score/src/pheapgetfreeinfo.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreProtHeap
  *
- * @brief Protected Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Protected_heap_Get_free_information().
  */
 
 /*
diff --git a/cpukit/score/src/pheapgetinfo.c b/cpukit/score/src/pheapgetinfo.c
index 7dabb77018..407169d54d 100644
--- a/cpukit/score/src/pheapgetinfo.c
+++ b/cpukit/score/src/pheapgetinfo.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreProtHeap
  *
- * @brief Protected Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Protected_heap_Get_information().
  */
 
 /*
diff --git a/cpukit/score/src/pheapgetsize.c b/cpukit/score/src/pheapgetsize.c
index d8af9f38b7..42f84ae4a6 100644
--- a/cpukit/score/src/pheapgetsize.c
+++ b/cpukit/score/src/pheapgetsize.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreProtHeap
  *
- * @brief Protected Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Protected_heap_Get_size().
  */
 
 /*
diff --git a/cpukit/score/src/pheapiterate.c b/cpukit/score/src/pheapiterate.c
index 7a766745cf..d30723de21 100644
--- a/cpukit/score/src/pheapiterate.c
+++ b/cpukit/score/src/pheapiterate.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreProtHeap
  *
- * @brief _Heap_Iterate() implementation.
+ * @brief This source file contains the implementation of
+ *   _Protected_heap_Iterate().
  */
 
 /*
diff --git a/cpukit/score/src/pheapresizeblock.c b/cpukit/score/src/pheapresizeblock.c
index ad90e8ca81..ee1198d6a3 100644
--- a/cpukit/score/src/pheapresizeblock.c
+++ b/cpukit/score/src/pheapresizeblock.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreProtHeap
  *
- * @brief Protected Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Protected_heap_Resize_block().
  */
 
 /*
diff --git a/cpukit/score/src/pheapwalk.c b/cpukit/score/src/pheapwalk.c
index d4a5e0aca9..27ae2adb34 100644
--- a/cpukit/score/src/pheapwalk.c
+++ b/cpukit/score/src/pheapwalk.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreProtHeap
  *
- * @brief Protected Heap Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _Protected_heap_Walk().
  */
 
 /*
diff --git a/cpukit/score/src/processormaskcopy.c b/cpukit/score/src/processormaskcopy.c
index 1e1c5b6ca8..dc1dbeb3f7 100644
--- a/cpukit/score/src/processormaskcopy.c
+++ b/cpukit/score/src/processormaskcopy.c
@@ -1,9 +1,11 @@
 /**
  * @file
  *
- * @brief Processor Mask Implementation
- *
  * @ingroup RTEMSScoreProcessorMask
+ *
+ * @brief This source file contains the definition of
+ *   ::_Processor_mask_The_one_and_only and the implementation of
+ *   _Processor_mask_Copy().
  */
 
 /*
diff --git a/cpukit/score/src/profilingisrentryexit.c b/cpukit/score/src/profilingisrentryexit.c
index 4a0133b29a..2b846d9964 100644
--- a/cpukit/score/src/profilingisrentryexit.c
+++ b/cpukit/score/src/profilingisrentryexit.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreProfiling
+ *
+ * @brief This source file contains the implementation of
+ *   _Profiling_Outer_most_interrupt_entry_and_exit().
+ */
+
 /*
  * Copyright (c) 2014, 2016 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/profilingsmplock.c b/cpukit/score/src/profilingsmplock.c
index f84c63acde..d5bd482965 100644
--- a/cpukit/score/src/profilingsmplock.c
+++ b/cpukit/score/src/profilingsmplock.c
@@ -1,3 +1,14 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreSMPLock
+ *
+ * @brief This source file contains the implementation of
+ *   _SMP_lock_Stats_destroy(), _SMP_lock_Stats_register_or_max_section_time(),
+ *   _SMP_lock_Stats_iteration_start(), _SMP_lock_Stats_iteration_next(), and
+ *   _SMP_lock_Stats_iteration_stop().
+ */
+
 /*
  * Copyright (c) 2014, 2018 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/rbtreeextract.c b/cpukit/score/src/rbtreeextract.c
index 270e60d96a..0bed12ad80 100644
--- a/cpukit/score/src/rbtreeextract.c
+++ b/cpukit/score/src/rbtreeextract.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreRBTree
+ *
+ * @brief This source file contains the implementation of
+ *   _RBTree_Extract().
+ */
+
 /*
  *  Copyright (c) 2010 Gedare Bloom.
  *
diff --git a/cpukit/score/src/rbtreeinsert.c b/cpukit/score/src/rbtreeinsert.c
index d9532d63d6..324cf3ba06 100644
--- a/cpukit/score/src/rbtreeinsert.c
+++ b/cpukit/score/src/rbtreeinsert.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreRBTree
+ *
+ * @brief This source file contains the implementation of
+ *   _RBTree_Insert_color().
+ */
+
 /*
  *  Copyright (c) 2010-2012 Gedare Bloom.
  *
diff --git a/cpukit/score/src/rbtreeiterate.c b/cpukit/score/src/rbtreeiterate.c
index c4c8180af2..715a3d37cb 100644
--- a/cpukit/score/src/rbtreeiterate.c
+++ b/cpukit/score/src/rbtreeiterate.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreRBTree
  *
- * @brief _RBTree_Iterate() implementation.
+ * @brief This source file contains the implementation of
+ *   _RBTree_Iterate().
  */
 
 /*
diff --git a/cpukit/score/src/rbtreenext.c b/cpukit/score/src/rbtreenext.c
index d0720a29c6..32087955fe 100644
--- a/cpukit/score/src/rbtreenext.c
+++ b/cpukit/score/src/rbtreenext.c
@@ -3,7 +3,9 @@
  *
  * @ingroup RTEMSScoreRBTree
  *
- * @brief _RBTree_Next() and _RBTree_Next() implementation.
+ * @brief This source file contains the implementation of
+ *   _RBTree_Minimum(), _RBTree_Maximum(), _RBTree_Successor(), and
+ *   _RBTree_Predecessor().
  */
 
 /*
diff --git a/cpukit/score/src/rbtreepostorder.c b/cpukit/score/src/rbtreepostorder.c
index efe992b1fa..1f97ed457f 100644
--- a/cpukit/score/src/rbtreepostorder.c
+++ b/cpukit/score/src/rbtreepostorder.c
@@ -3,8 +3,8 @@
  *
  * @ingroup RTEMSScoreRBTree
  *
- * @brief _RBTree_Postorder_first() and _RBTree_Postorder_next()
- * implementation.
+ * @brief This source file contains the implementation of
+ *   _RBTree_Postorder_next() and _RBTree_Postorder_first().
  */
 
 /*
diff --git a/cpukit/score/src/rbtreereplace.c b/cpukit/score/src/rbtreereplace.c
index c8408667f9..641485f222 100644
--- a/cpukit/score/src/rbtreereplace.c
+++ b/cpukit/score/src/rbtreereplace.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreRBTree
  *
- * @brief _RBTree_Replace_node() implementation.
+ * @brief This source file contains the implementation of
+ *   _RBTree_Replace_node().
  */
 
 /*
diff --git a/cpukit/score/src/sched.c b/cpukit/score/src/sched.c
index 893e50bba3..63636ff9c1 100644
--- a/cpukit/score/src/sched.c
+++ b/cpukit/score/src/sched.c
@@ -1,3 +1,13 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreScheduler
+ *
+ * @brief This source file contains the implementation of
+ *   _Sched_Count(), _Sched_Index(), _Sched_Name_to_index(), and
+ *   _Sched_Processor_count().
+ */
+
 /*
  * Copyright (c) 2015 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/scheduler.c b/cpukit/score/src/scheduler.c
index 45c0496838..0b7a5a1a9f 100644
--- a/cpukit/score/src/scheduler.c
+++ b/cpukit/score/src/scheduler.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreScheduler
  *
- * @brief Scheduler Initialize
+ * @brief This source file contains the implementation of
+ *   _Scheduler_Handler_initialization().
  */
 
 /*
diff --git a/cpukit/score/src/schedulercbs.c b/cpukit/score/src/schedulercbs.c
index 12a7a76251..8e5bf86f27 100644
--- a/cpukit/score/src/schedulercbs.c
+++ b/cpukit/score/src/schedulercbs.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerCBS
  *
- * @brief CBS Scheduler Budget Handler
+ * @brief This source file contains the implementation of
+ *   _Scheduler_CBS_Budget_callout() and _Scheduler_CBS_Initialize().
  */
 
 /*
diff --git a/cpukit/score/src/schedulercbsattachthread.c b/cpukit/score/src/schedulercbsattachthread.c
index ec941a30b7..0cb59fa2e8 100644
--- a/cpukit/score/src/schedulercbsattachthread.c
+++ b/cpukit/score/src/schedulercbsattachthread.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Attach Scheduler CBS Thread
- *  @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerCBS
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_CBS_Attach_thread().
  */
 
 /*
diff --git a/cpukit/score/src/schedulercbscleanup.c b/cpukit/score/src/schedulercbscleanup.c
index 9ed9df4b21..aeedd02395 100644
--- a/cpukit/score/src/schedulercbscleanup.c
+++ b/cpukit/score/src/schedulercbscleanup.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Scheduler CBS Cleanup
- *  @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerCBS
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_CBS_Cleanup().
  */
 
 /*
diff --git a/cpukit/score/src/schedulercbscreateserver.c b/cpukit/score/src/schedulercbscreateserver.c
index 5ee83467e7..8e07954e2a 100644
--- a/cpukit/score/src/schedulercbscreateserver.c
+++ b/cpukit/score/src/schedulercbscreateserver.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Scheduler CBS Create Server
- *  @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerCBS
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_CBS_Create_server().
  */
 
 /*
diff --git a/cpukit/score/src/schedulercbsdestroyserver.c b/cpukit/score/src/schedulercbsdestroyserver.c
index 11baf8328d..d536e711d8 100644
--- a/cpukit/score/src/schedulercbsdestroyserver.c
+++ b/cpukit/score/src/schedulercbsdestroyserver.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Scheduler CBS Destroy Server
+ * @ingroup RTEMSScoreSchedulerCBS
  *
- * @ingroup RTEMSScoreScheduler
+ * @brief This source file contains the implementation of
+ *   _Scheduler_CBS_Destroy_server().
  */
 
 /*
diff --git a/cpukit/score/src/schedulercbsdetachthread.c b/cpukit/score/src/schedulercbsdetachthread.c
index 85dfc11be0..687b37804f 100644
--- a/cpukit/score/src/schedulercbsdetachthread.c
+++ b/cpukit/score/src/schedulercbsdetachthread.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Detach from the CBS Server
+ * @ingroup RTEMSScoreSchedulerCBS
  *
- * @ingroup RTEMSScoreScheduler
+ * @brief This source file contains the implementation of
+ *   _Scheduler_CBS_Detach_thread().
  */
 
 /*
diff --git a/cpukit/score/src/schedulercbsgetapprovedbudget.c b/cpukit/score/src/schedulercbsgetapprovedbudget.c
index 6924afaa35..0c53009ad4 100644
--- a/cpukit/score/src/schedulercbsgetapprovedbudget.c
+++ b/cpukit/score/src/schedulercbsgetapprovedbudget.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Scheduler CBS Get Approved Budget
- *  @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerCBS
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_CBS_Get_approved_budget().
  */
 
 /*
diff --git a/cpukit/score/src/schedulercbsgetexecutiontime.c b/cpukit/score/src/schedulercbsgetexecutiontime.c
index d9b58ff9aa..28709151c0 100644
--- a/cpukit/score/src/schedulercbsgetexecutiontime.c
+++ b/cpukit/score/src/schedulercbsgetexecutiontime.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Get Thread Execution Info
+ * @ingroup RTEMSScoreSchedulerCBS
  *
- * @ingroup RTEMSScoreScheduler
+ * @brief This source file contains the implementation of
+ *   _Scheduler_CBS_Get_execution_time().
  */
 
 /*
diff --git a/cpukit/score/src/schedulercbsgetparameters.c b/cpukit/score/src/schedulercbsgetparameters.c
index 65e4965176..48c68e7534 100644
--- a/cpukit/score/src/schedulercbsgetparameters.c
+++ b/cpukit/score/src/schedulercbsgetparameters.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerCBS
  *
- * @brief _Scheduler_CBS_Get_parameters
+ * @brief This source file contains the implementation of
+ *   _Scheduler_CBS_Get_parameters().
  */
 
 /*
diff --git a/cpukit/score/src/schedulercbsgetremainingbudget.c b/cpukit/score/src/schedulercbsgetremainingbudget.c
index ca2cd086db..5cb299d67e 100644
--- a/cpukit/score/src/schedulercbsgetremainingbudget.c
+++ b/cpukit/score/src/schedulercbsgetremainingbudget.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Scheduler CBS Get Remaining Budget
- *  @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerCBS
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_CBS_Get_remaining_budget().
  */
 
 /*
diff --git a/cpukit/score/src/schedulercbsgetserverid.c b/cpukit/score/src/schedulercbsgetserverid.c
index b9882c78b5..57e89f1adb 100644
--- a/cpukit/score/src/schedulercbsgetserverid.c
+++ b/cpukit/score/src/schedulercbsgetserverid.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Scheduler CBS Get Server id
- *  @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerCBS
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_CBS_Get_server_id().
  */
 
 /*
diff --git a/cpukit/score/src/schedulercbsnodeinit.c b/cpukit/score/src/schedulercbsnodeinit.c
index 4710def95a..387f5ffbd5 100644
--- a/cpukit/score/src/schedulercbsnodeinit.c
+++ b/cpukit/score/src/schedulercbsnodeinit.c
@@ -1,8 +1,10 @@
-/*
- *  @file
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreSchedulerCBS
  *
- *  @brief Scheduler CBS Allocate
- *  @ingroup RTEMSScoreScheduler
+ * @brief This source file contains the implementation of
+ *   _Scheduler_CBS_Node_initialize().
  */
 
 /*
diff --git a/cpukit/score/src/schedulercbsreleasejob.c b/cpukit/score/src/schedulercbsreleasejob.c
index 291d6ec1fc..376906b996 100644
--- a/cpukit/score/src/schedulercbsreleasejob.c
+++ b/cpukit/score/src/schedulercbsreleasejob.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Scheduler CBS Release Job
+ * @ingroup RTEMSScoreSchedulerCBS
  *
- * @ingroup RTEMSScoreScheduler
+ * @brief This source file contains the implementation of
+ *   _Scheduler_CBS_Release_job().
  */
 
 /*
diff --git a/cpukit/score/src/schedulercbssetparameters.c b/cpukit/score/src/schedulercbssetparameters.c
index 995c0f503a..00d24785a0 100644
--- a/cpukit/score/src/schedulercbssetparameters.c
+++ b/cpukit/score/src/schedulercbssetparameters.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Set Parameters for CBS Scheduling
+ * @ingroup RTEMSScoreSchedulerCBS
  *
- * @ingroup RTEMSScoreScheduler
+ * @brief This source file contains the implementation of
+ *   _Scheduler_CBS_Set_parameters().
  */
 
 /*
diff --git a/cpukit/score/src/schedulercbsunblock.c b/cpukit/score/src/schedulercbsunblock.c
index 90bec78f9e..700d7b1202 100644
--- a/cpukit/score/src/schedulercbsunblock.c
+++ b/cpukit/score/src/schedulercbsunblock.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Unblocks a Thread from the Queue
+ * @ingroup RTEMSScoreSchedulerCBS
  *
- * @ingroup RTEMSScoreScheduler
+ * @brief This source file contains the implementation of
+ *   _Scheduler_CBS_Unblock().
  */
 
 /*
diff --git a/cpukit/score/src/schedulerdefaultaskforhelp.c b/cpukit/score/src/schedulerdefaultaskforhelp.c
index bd172d3d06..17c222eafb 100644
--- a/cpukit/score/src/schedulerdefaultaskforhelp.c
+++ b/cpukit/score/src/schedulerdefaultaskforhelp.c
@@ -1,3 +1,14 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreScheduler
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_default_Ask_for_help(),
+ *   _Scheduler_default_Reconsider_help_request(), and
+ *   _Scheduler_default_Withdraw_node().
+ */
+
 /*
  * Copyright (c) 2014, 2016 embedded brains GmbH
  *
diff --git a/cpukit/score/src/schedulerdefaultmappriority.c b/cpukit/score/src/schedulerdefaultmappriority.c
index 87d13ff40f..290165d143 100644
--- a/cpukit/score/src/schedulerdefaultmappriority.c
+++ b/cpukit/score/src/schedulerdefaultmappriority.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreScheduler
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_default_Map_priority() and _Scheduler_default_Unmap_priority().
+ */
+
 /*
  * Copyright (c) 2016, 2017 embedded brains GmbH
  *
diff --git a/cpukit/score/src/schedulerdefaultnodedestroy.c b/cpukit/score/src/schedulerdefaultnodedestroy.c
index 35f5d62f0d..796896d854 100644
--- a/cpukit/score/src/schedulerdefaultnodedestroy.c
+++ b/cpukit/score/src/schedulerdefaultnodedestroy.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Scheduler Default Node Destruction Operation
- *
  * @ingroup RTEMSScoreScheduler
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_default_Node_destroy().
  */
 
 /*
diff --git a/cpukit/score/src/schedulerdefaultnodeinit.c b/cpukit/score/src/schedulerdefaultnodeinit.c
index f780003480..73fb73d6ac 100644
--- a/cpukit/score/src/schedulerdefaultnodeinit.c
+++ b/cpukit/score/src/schedulerdefaultnodeinit.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Scheduler Default Node Initialization Operation
- *
  * @ingroup RTEMSScoreScheduler
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_default_Node_initialize().
  */
 
 /*
diff --git a/cpukit/score/src/schedulerdefaultpinunpin.c b/cpukit/score/src/schedulerdefaultpinunpin.c
index 6465791631..4aa2169c8e 100644
--- a/cpukit/score/src/schedulerdefaultpinunpin.c
+++ b/cpukit/score/src/schedulerdefaultpinunpin.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreScheduler
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_default_Pin_or_unpin().
+ */
+
 /*
  * Copyright (c) 2018 embedded brains GmbH
  *
diff --git a/cpukit/score/src/schedulerdefaultreleasejob.c b/cpukit/score/src/schedulerdefaultreleasejob.c
index a1ab789ecc..f28733243a 100644
--- a/cpukit/score/src/schedulerdefaultreleasejob.c
+++ b/cpukit/score/src/schedulerdefaultreleasejob.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Default Scheduler Release Job Operation
- *
  * @ingroup RTEMSScoreScheduler
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_default_Release_job() and _Scheduler_default_Cancel_job().
  */
 
 /*
diff --git a/cpukit/score/src/schedulerdefaultschedule.c b/cpukit/score/src/schedulerdefaultschedule.c
index a60ef53806..80e8f88ef4 100644
--- a/cpukit/score/src/schedulerdefaultschedule.c
+++ b/cpukit/score/src/schedulerdefaultschedule.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreScheduler
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_default_Schedule().
+ */
+
 /*
  * Copyright (c) 2014 embedded brains GmbH
  *
diff --git a/cpukit/score/src/schedulerdefaultsetaffinity.c b/cpukit/score/src/schedulerdefaultsetaffinity.c
index ae3e6e613e..6399b1e352 100644
--- a/cpukit/score/src/schedulerdefaultsetaffinity.c
+++ b/cpukit/score/src/schedulerdefaultsetaffinity.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Scheduler Default Set Affinity Operation
- *
  * @ingroup RTEMSScoreScheduler
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_default_Set_affinity().
  */
 
 /*
diff --git a/cpukit/score/src/schedulerdefaultstartidle.c b/cpukit/score/src/schedulerdefaultstartidle.c
index 9789b6966a..b35bfccf83 100644
--- a/cpukit/score/src/schedulerdefaultstartidle.c
+++ b/cpukit/score/src/schedulerdefaultstartidle.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreScheduler
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_default_Start_idle().
+ */
+
 /*
  * Copyright (c) 2013-2014 embedded brains GmbH
  *
diff --git a/cpukit/score/src/schedulerdefaulttick.c b/cpukit/score/src/schedulerdefaulttick.c
index bf93598a7c..f4b6ba8578 100644
--- a/cpukit/score/src/schedulerdefaulttick.c
+++ b/cpukit/score/src/schedulerdefaulttick.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Default Scheduler At Tick Handler
- *
  * @ingroup RTEMSScoreScheduler
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_default_Tick().
  */
 
 /*
diff --git a/cpukit/score/src/scheduleredf.c b/cpukit/score/src/scheduleredf.c
index 3b0c62c0c3..beb37002ff 100644
--- a/cpukit/score/src/scheduleredf.c
+++ b/cpukit/score/src/scheduleredf.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerEDF
  *
- * @brief Scheduler EDF Initialize and Support
+ * @brief This source file contains the implementation of
+ *   _Scheduler_EDF_Initialize().
  */
 
 /*
diff --git a/cpukit/score/src/scheduleredfblock.c b/cpukit/score/src/scheduleredfblock.c
index b3b2fa4f0d..689dc21361 100644
--- a/cpukit/score/src/scheduleredfblock.c
+++ b/cpukit/score/src/scheduleredfblock.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Removes the Thread from Ready Queue
+ * @ingroup RTEMSScoreSchedulerEDF
  *
- * @ingroup RTEMSScoreScheduler
+ * @brief This source file contains the implementation of
+ *   _Scheduler_EDF_Block().
  */
 
 /*
diff --git a/cpukit/score/src/scheduleredfchangepriority.c b/cpukit/score/src/scheduleredfchangepriority.c
index 42d899b876..b6d7e334ee 100644
--- a/cpukit/score/src/scheduleredfchangepriority.c
+++ b/cpukit/score/src/scheduleredfchangepriority.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Scheduler EDF Extract
- *  @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerEDF
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_EDF_Update_priority().
  */
 
 /*
diff --git a/cpukit/score/src/scheduleredfnodeinit.c b/cpukit/score/src/scheduleredfnodeinit.c
index bb938cdcd1..82b68630aa 100644
--- a/cpukit/score/src/scheduleredfnodeinit.c
+++ b/cpukit/score/src/scheduleredfnodeinit.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Scheduler EDF Allocate
- *  @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerEDF
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_EDF_Node_initialize().
  */
 
 /*
diff --git a/cpukit/score/src/scheduleredfreleasejob.c b/cpukit/score/src/scheduleredfreleasejob.c
index 0e3e527109..443fdaeed5 100644
--- a/cpukit/score/src/scheduleredfreleasejob.c
+++ b/cpukit/score/src/scheduleredfreleasejob.c
@@ -1,9 +1,11 @@
 /**
  * @file
  *
- * @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerEDF
  *
- * @brief Scheduler EDF Release Job
+ * @brief This source file contains the implementation of
+ *   _Scheduler_EDF_Map_priority(), _Scheduler_EDF_Unmap_priority(),
+ *   _Scheduler_EDF_Release_job(), and _Scheduler_EDF_Cancel_job().
  */
 
 /*
diff --git a/cpukit/score/src/scheduleredfschedule.c b/cpukit/score/src/scheduleredfschedule.c
index 1f4823b971..126aed0150 100644
--- a/cpukit/score/src/scheduleredfschedule.c
+++ b/cpukit/score/src/scheduleredfschedule.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Scheduler EDF Allocate
- *  @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerEDF
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_EDF_Schedule().
  */
 
 /*
diff --git a/cpukit/score/src/scheduleredfsmp.c b/cpukit/score/src/scheduleredfsmp.c
index dc1fa20c86..985f06f4bf 100644
--- a/cpukit/score/src/scheduleredfsmp.c
+++ b/cpukit/score/src/scheduleredfsmp.c
@@ -1,9 +1,17 @@
 /**
  * @file
  *
- * @brief EDF SMP Scheduler Implementation
- *
  * @ingroup RTEMSScoreSchedulerSMPEDF
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_EDF_SMP_Add_processor(), _Scheduler_EDF_SMP_Ask_for_help(),
+ *   _Scheduler_EDF_SMP_Block(), _Scheduler_EDF_SMP_Initialize(),
+ *   _Scheduler_EDF_SMP_Node_initialize(), _Scheduler_EDF_SMP_Pin(),
+ *   _Scheduler_EDF_SMP_Reconsider_help_request(),
+ *   _Scheduler_EDF_SMP_Remove_processor(), _Scheduler_EDF_SMP_Set_affinity(),
+ *   _Scheduler_EDF_SMP_Start_idle(), _Scheduler_EDF_SMP_Unblock(),
+ *   _Scheduler_EDF_SMP_Unpin(), _Scheduler_EDF_SMP_Update_priority(),
+ *   _Scheduler_EDF_SMP_Withdraw_node(), and _Scheduler_EDF_SMP_Yield().
  */
 
 /*
diff --git a/cpukit/score/src/scheduleredfunblock.c b/cpukit/score/src/scheduleredfunblock.c
index a1c45af91c..49cf88bc8d 100644
--- a/cpukit/score/src/scheduleredfunblock.c
+++ b/cpukit/score/src/scheduleredfunblock.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerEDF
  *
- * @brief Scheduler EDF Unblock
+ * @brief This source file contains the implementation of
+ *   _Scheduler_EDF_Unblock().
  */
 
 /*
diff --git a/cpukit/score/src/scheduleredfyield.c b/cpukit/score/src/scheduleredfyield.c
index 8dc11fab8c..530a01e5a2 100644
--- a/cpukit/score/src/scheduleredfyield.c
+++ b/cpukit/score/src/scheduleredfyield.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Scheduler EDF Yield
+ * @ingroup RTEMSScoreSchedulerEDF
  *
- * @ingroup RTEMSScoreScheduler
+ * @brief This source file contains the implementation of
+ *   _Scheduler_EDF_Yield().
  */
 
 /*
diff --git a/cpukit/score/src/schedulergetaffinity.c b/cpukit/score/src/schedulergetaffinity.c
index d4666499c4..87be699f5b 100644
--- a/cpukit/score/src/schedulergetaffinity.c
+++ b/cpukit/score/src/schedulergetaffinity.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreScheduler
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_Get_affinity().
+ */
+
 /*
  * Copyright (c) 2014, 2017 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/schedulerpriority.c b/cpukit/score/src/schedulerpriority.c
index bf72d8057e..e151afd5d0 100644
--- a/cpukit/score/src/schedulerpriority.c
+++ b/cpukit/score/src/schedulerpriority.c
@@ -1,8 +1,11 @@
-/*
- *  @file
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreSchedulerPriority
  *
- *  @brief Initialize Scheduler Priority
- *  @ingroup RTEMSScoreScheduler
+ * @brief This source file contains the implementation of
+ *   _Scheduler_priority_Initialize() and
+ *   _Scheduler_priority_Node_initialize().
  */
 
 /*
diff --git a/cpukit/score/src/schedulerpriorityaffinitysmp.c b/cpukit/score/src/schedulerpriorityaffinitysmp.c
index 86ef7bf83e..2511b6bbed 100644
--- a/cpukit/score/src/schedulerpriorityaffinitysmp.c
+++ b/cpukit/score/src/schedulerpriorityaffinitysmp.c
@@ -1,9 +1,19 @@
 /**
  * @file
  *
- * @brief Deterministic Priority Affinity SMP Scheduler Implementation
- *
  * @ingroup RTEMSScoreSchedulerPriorityAffinitySMP
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_priority_affinity_SMP_Add_processor(),
+ *   _Scheduler_priority_affinity_SMP_Ask_for_help(),
+ *   _Scheduler_priority_affinity_SMP_Block(),
+ *   _Scheduler_priority_affinity_SMP_Node_initialize(),
+ *   _Scheduler_priority_affinity_SMP_Reconsider_help_request(),
+ *   _Scheduler_priority_affinity_SMP_Remove_processor(),
+ *   _Scheduler_priority_affinity_SMP_Set_affinity(),
+ *   _Scheduler_priority_affinity_SMP_Unblock(),
+ *   _Scheduler_priority_affinity_SMP_Update_priority(), and
+ *   _Scheduler_priority_affinity_SMP_Withdraw_node().
  */
 
 /*
diff --git a/cpukit/score/src/schedulerpriorityblock.c b/cpukit/score/src/schedulerpriorityblock.c
index ae44710ea6..86d464aab4 100644
--- a/cpukit/score/src/schedulerpriorityblock.c
+++ b/cpukit/score/src/schedulerpriorityblock.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerPriority
  *
- * @brief Scheduler Priority Block
+ * @brief This source file contains the implementation of
+ *   _Scheduler_priority_Block().
  */
 
 /*
diff --git a/cpukit/score/src/schedulerprioritychangepriority.c b/cpukit/score/src/schedulerprioritychangepriority.c
index 0ea1b67183..6390e0fb4f 100644
--- a/cpukit/score/src/schedulerprioritychangepriority.c
+++ b/cpukit/score/src/schedulerprioritychangepriority.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Removes Thread from Thread Queue
+ * @ingroup RTEMSScoreSchedulerPriority
  *
- * @ingroup RTEMSScoreScheduler
+ * @brief This source file contains the implementation of
+ *   _Scheduler_priority_Update_priority().
  */
 
 /*
diff --git a/cpukit/score/src/schedulerpriorityschedule.c b/cpukit/score/src/schedulerpriorityschedule.c
index 7861a5861e..cfb5916017 100644
--- a/cpukit/score/src/schedulerpriorityschedule.c
+++ b/cpukit/score/src/schedulerpriorityschedule.c
@@ -1,11 +1,12 @@
 /**
  * @file
  *
- * @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerPriority
  *
- * @brief Priority Scheduler Schedule Method
+ * @brief This source file contains the implementation of
+ *   _Scheduler_priority_Schedule().
  */
- 
+
 /*
  *  Copyright (C) 2010 Gedare Bloom.
  *  Copyright (C) 2011 On-Line Applications Research Corporation (OAR).
diff --git a/cpukit/score/src/schedulerprioritysmp.c b/cpukit/score/src/schedulerprioritysmp.c
index b1a84166fe..d6f8715e01 100644
--- a/cpukit/score/src/schedulerprioritysmp.c
+++ b/cpukit/score/src/schedulerprioritysmp.c
@@ -3,7 +3,17 @@
  *
  * @ingroup RTEMSScoreSchedulerPrioritySMP
  *
- * @brief Deterministic Priority SMP Scheduler Implementation
+ * @brief This source file contains the implementation of
+ *   _Scheduler_priority_SMP_Add_processor(),
+ *   _Scheduler_priority_SMP_Ask_for_help(), _Scheduler_priority_SMP_Block(),
+ *   _Scheduler_priority_SMP_Initialize(),
+ *   _Scheduler_priority_SMP_Node_initialize(),
+ *   _Scheduler_priority_SMP_Reconsider_help_request(),
+ *   _Scheduler_priority_SMP_Remove_processor(),
+ *   _Scheduler_priority_SMP_Unblock(),
+ *   _Scheduler_priority_SMP_Update_priority(),
+ *   _Scheduler_priority_SMP_Withdraw_node(), and
+ *   _Scheduler_priority_SMP_Yield().
  */
 
 /*
diff --git a/cpukit/score/src/schedulerpriorityunblock.c b/cpukit/score/src/schedulerpriorityunblock.c
index 89bf197ffc..c28852b133 100644
--- a/cpukit/score/src/schedulerpriorityunblock.c
+++ b/cpukit/score/src/schedulerpriorityunblock.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Scheduler Priority Unblock
- *  @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerPriority
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_priority_Unblock().
  */
 
 /*
diff --git a/cpukit/score/src/schedulerpriorityyield.c b/cpukit/score/src/schedulerpriorityyield.c
index cd4f3563c5..acf3d149a7 100644
--- a/cpukit/score/src/schedulerpriorityyield.c
+++ b/cpukit/score/src/schedulerpriorityyield.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Scheduler Priority Yield
- *  @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerPriority
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_priority_Yield().
  */
 
 /*
diff --git a/cpukit/score/src/schedulersetaffinity.c b/cpukit/score/src/schedulersetaffinity.c
index 37c3e57c79..8d16af3ed3 100644
--- a/cpukit/score/src/schedulersetaffinity.c
+++ b/cpukit/score/src/schedulersetaffinity.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreScheduler
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_Set_affinity().
+ */
+
 /*
  * Copyright (c) 2014, 2017 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/schedulersimple.c b/cpukit/score/src/schedulersimple.c
index 6fab5a140f..1c8bd9f165 100644
--- a/cpukit/score/src/schedulersimple.c
+++ b/cpukit/score/src/schedulersimple.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Scheduler Simple Functions
+ * @ingroup RTEMSScoreSchedulerSimple
  *
- * @ingroup RTEMSScoreScheduler
+ * @brief This source file contains the implementation of
+ *   _Scheduler_simple_Initialize().
  */
 
 /*
diff --git a/cpukit/score/src/schedulersimpleblock.c b/cpukit/score/src/schedulersimpleblock.c
index 1187a9d1e8..a08cd54f01 100644
--- a/cpukit/score/src/schedulersimpleblock.c
+++ b/cpukit/score/src/schedulersimpleblock.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Simple Scheduler Block a Thread
+ * @ingroup RTEMSScoreSchedulerSimple
  *
- * @ingroup RTEMSScoreScheduler
+ * @brief This source file contains the implementation of
+ *   _Scheduler_simple_Block().
  */
 
 /*
diff --git a/cpukit/score/src/schedulersimplechangepriority.c b/cpukit/score/src/schedulersimplechangepriority.c
index 448204274a..48c2473f82 100644
--- a/cpukit/score/src/schedulersimplechangepriority.c
+++ b/cpukit/score/src/schedulersimplechangepriority.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Removes a Thread from the Simple Queue
+ * @ingroup RTEMSScoreSchedulerSimple
  *
- * @ingroup RTEMSScoreScheduler
+ * @brief This source file contains the implementation of
+ *   _Scheduler_simple_Update_priority().
  */
 
 /*
diff --git a/cpukit/score/src/schedulersimpleschedule.c b/cpukit/score/src/schedulersimpleschedule.c
index a48475828c..0358cfd159 100644
--- a/cpukit/score/src/schedulersimpleschedule.c
+++ b/cpukit/score/src/schedulersimpleschedule.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerSimple
  *
- * @brief Simple Schedule Determine Heir
+ * @brief This source file contains the implementation of
+ *   _Scheduler_simple_Schedule().
  */
 
 /*
diff --git a/cpukit/score/src/schedulersimplesmp.c b/cpukit/score/src/schedulersimplesmp.c
index d818dcea80..bcb686bdd2 100644
--- a/cpukit/score/src/schedulersimplesmp.c
+++ b/cpukit/score/src/schedulersimplesmp.c
@@ -1,9 +1,17 @@
 /**
  * @file
  *
- * @brief Simple SMP Scheduler Implementation
- *
  * @ingroup RTEMSScoreSchedulerSMPSimple
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_simple_SMP_Add_processor(),
+ *   _Scheduler_simple_SMP_Ask_for_help(), _Scheduler_simple_SMP_Block(),
+ *   _Scheduler_simple_SMP_Initialize(),
+ *   _Scheduler_simple_SMP_Node_initialize(),
+ *   _Scheduler_simple_SMP_Reconsider_help_request(),
+ *   _Scheduler_simple_SMP_Remove_processor(), _Scheduler_simple_SMP_Unblock(),
+ *   _Scheduler_simple_SMP_Update_priority(),
+ *   _Scheduler_simple_SMP_Withdraw_node(), and _Scheduler_simple_SMP_Yield().
  */
 
 /*
diff --git a/cpukit/score/src/schedulersimpleunblock.c b/cpukit/score/src/schedulersimpleunblock.c
index 516b5f2675..cd4dded017 100644
--- a/cpukit/score/src/schedulersimpleunblock.c
+++ b/cpukit/score/src/schedulersimpleunblock.c
@@ -1,9 +1,10 @@
 /**
  * @file
- * 
- * @ingroup RTEMSScoreScheduler
  *
- * @brief Scheduler Simple Handler / Unblock
+ * @ingroup RTEMSScoreSchedulerSimple
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_simple_Unblock().
  */
 
 /*
diff --git a/cpukit/score/src/schedulersimpleyield.c b/cpukit/score/src/schedulersimpleyield.c
index db78660719..24f5dc59c1 100644
--- a/cpukit/score/src/schedulersimpleyield.c
+++ b/cpukit/score/src/schedulersimpleyield.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup RTEMSScoreScheduler
+ * @ingroup RTEMSScoreSchedulerSimple
  *
- * @brief Simple Schedule Yield CPU
+ * @brief This source file contains the implementation of
+ *   _Scheduler_simple_Yield().
  */
 
 /*
diff --git a/cpukit/score/src/schedulersmp.c b/cpukit/score/src/schedulersmp.c
index cb1ab6e0f1..cc566180b7 100644
--- a/cpukit/score/src/schedulersmp.c
+++ b/cpukit/score/src/schedulersmp.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreScheduler
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_Request_ask_for_help().
+ */
+
 /*
  * Copyright (c) 2014, 2017 embedded brains GmbH.
  *
diff --git a/cpukit/score/src/schedulersmpstartidle.c b/cpukit/score/src/schedulersmpstartidle.c
index e4e34ed3f8..0c7da3d7d2 100644
--- a/cpukit/score/src/schedulersmpstartidle.c
+++ b/cpukit/score/src/schedulersmpstartidle.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreScheduler
+ *
+ * @brief This source file contains the implementation of
+ *   _Scheduler_SMP_Start_idle().
+ */
+
 /*
  * Copyright (c) 2013, 2017 embedded brains GmbH.
  *
diff --git a/cpukit/score/src/schedulerstrongapa.c b/cpukit/score/src/schedulerstrongapa.c
index 924cd86412..dcfb55601a 100644
--- a/cpukit/score/src/schedulerstrongapa.c
+++ b/cpukit/score/src/schedulerstrongapa.c
@@ -3,7 +3,15 @@
  *
  * @ingroup RTEMSScoreSchedulerStrongAPA
  *
- * @brief Strong APA Scheduler Implementation
+ * @brief This source file contains the implementation of
+ *   _Scheduler_strong_APA_Add_processor(),
+ *   _Scheduler_strong_APA_Ask_for_help(), _Scheduler_strong_APA_Block(),
+ *   _Scheduler_strong_APA_Initialize(),
+ *   _Scheduler_strong_APA_Node_initialize(),
+ *   _Scheduler_strong_APA_Reconsider_help_request(),
+ *   _Scheduler_strong_APA_Remove_processor(), _Scheduler_strong_APA_Unblock(),
+ *   _Scheduler_strong_APA_Update_priority(),
+ *   _Scheduler_strong_APA_Withdraw_node(), and _Scheduler_strong_APA_Yield().
  */
 
 /*
diff --git a/cpukit/score/src/semaphore.c b/cpukit/score/src/semaphore.c
index e133d6082d..db3c3a91eb 100644
--- a/cpukit/score/src/semaphore.c
+++ b/cpukit/score/src/semaphore.c
@@ -1,3 +1,13 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScore
+ *
+ * @brief This source file contains the implementation of
+ *   _Semaphore_Wait(), _Semaphore_Wait_timed_ticks(), _Semaphore_Try_wait(),
+ *   _Semaphore_Post(), and _Semaphore_Post_binary().
+ */
+
 /*
  * Copyright (c) 2015, 2017 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/smp.c b/cpukit/score/src/smp.c
index 0aab731dc8..2a3405c6ef 100644
--- a/cpukit/score/src/smp.c
+++ b/cpukit/score/src/smp.c
@@ -1,8 +1,15 @@
 /**
- *  @file
+ * @file
  *
- *  @brief SMP Support
- *  @ingroup RTEMSScore
+ * @ingroup RTEMSScoreSMP
+ *
+ * @brief This source file contains the definition of ::_SMP_Online_processors
+ *   and ::_SMP_Processor_maximum and the implementation of
+ *   _SMP_Handler_initialize(), _SMP_Request_shutdown(),
+ *   _SMP_Request_start_multitasking(), _SMP_Send_message(),
+ *   _SMP_Send_message_broadcast(), _SMP_Send_message_multicast(),
+ *   _SMP_Should_start_processor(), and
+ *   _SMP_Start_multitasking_on_secondary_processor().
  */
 
 /*
diff --git a/cpukit/score/src/smpbarrierwait.c b/cpukit/score/src/smpbarrierwait.c
index 152338af00..c67d13af6f 100644
--- a/cpukit/score/src/smpbarrierwait.c
+++ b/cpukit/score/src/smpbarrierwait.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreSMPBarrier
+ *
+ * @brief This source file contains the implementation of
+ *   _SMP_barrier_Wait().
+ */
+
 /*
  * Copyright (c) 2013-2014 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/smplock.c b/cpukit/score/src/smplock.c
index 3523098677..b2d08cd6a1 100644
--- a/cpukit/score/src/smplock.c
+++ b/cpukit/score/src/smplock.c
@@ -1,3 +1,14 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreSMPLock
+ *
+ * @brief This source file contains the implementation of
+ *   _SMP_lock_Initialize(), _SMP_lock_Destroy(), _SMP_lock_Acquire(),
+ *   _SMP_lock_Release(), _SMP_lock_ISR_disable_and_acquire(),
+ *   _SMP_lock_Release_and_ISR_enable(), and _SMP_lock_Is_owner().
+ */
+
 /*
  * Copyright (c) 2015, 2016 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/smpmulticastaction.c b/cpukit/score/src/smpmulticastaction.c
index facc77af41..55c495a2cf 100644
--- a/cpukit/score/src/smpmulticastaction.c
+++ b/cpukit/score/src/smpmulticastaction.c
@@ -1,6 +1,17 @@
-/*
- * SPDX-License-Identifier: BSD-2-Clause
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @ingroup RTEMSScorePerCPU
+ * @ingroup RTEMSScoreSMP
  *
+ * @brief This source file contains the implementation of _Per_CPU_Add_job(),
+ *   _Per_CPU_Perform_jobs(), _Per_CPU_Wait_for_job(), _SMP_Broadcast_action(),
+ *   _SMP_Multicast_action(), _SMP_Othercast_action(), and _SMP_Synchronize().
+ */
+
+/*
  * Copyright (C) 2019 embedded brains GmbH
  *
  * Redistribution and use in source and binary forms, with or without
diff --git a/cpukit/score/src/smpunicastaction.c b/cpukit/score/src/smpunicastaction.c
index 1b170cabd2..bc481eb4a4 100644
--- a/cpukit/score/src/smpunicastaction.c
+++ b/cpukit/score/src/smpunicastaction.c
@@ -1,6 +1,15 @@
-/*
- * SPDX-License-Identifier: BSD-2-Clause
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreSMP
  *
+ * @brief This source file contains the implementation of
+ *   _SMP_Unicast_action().
+ */
+
+/*
  * Copyright (C) 2019 embedded brains GmbH
  *
  * Redistribution and use in source and binary forms, with or without
diff --git a/cpukit/score/src/stackallocator.c b/cpukit/score/src/stackallocator.c
index 6fd8bf9489..920aee86c1 100644
--- a/cpukit/score/src/stackallocator.c
+++ b/cpukit/score/src/stackallocator.c
@@ -1,6 +1,16 @@
-/*
- * SPDX-License-Identifier: BSD-2-Clause
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreStack
  *
+ * @brief This source file contains a definition of
+ *   ::_Stack_Allocator_avoids_workspace and ::_Stack_Allocator_allocate which
+ *   allocates the thread stacks from the RTEMS Workspace.
+ */
+
+/*
  * Copyright (C) 2019 embedded brains GmbH
  *
  * Redistribution and use in source and binary forms, with or without
diff --git a/cpukit/score/src/stackallocatorfree.c b/cpukit/score/src/stackallocatorfree.c
index efb63d7cca..f32912ea9c 100644
--- a/cpukit/score/src/stackallocatorfree.c
+++ b/cpukit/score/src/stackallocatorfree.c
@@ -1,6 +1,15 @@
-/*
- * SPDX-License-Identifier: BSD-2-Clause
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreStack
  *
+ * @brief This source file contains a definition of ::_Stack_Allocator_free
+ *   which frees the thread stacks to the RTEMS Workspace.
+ */
+
+/*
  * Copyright (C) 2019 embedded brains GmbH
  *
  * Redistribution and use in source and binary forms, with or without
diff --git a/cpukit/score/src/stackallocatorfreenothing.c b/cpukit/score/src/stackallocatorfreenothing.c
index b469f650b6..e341814b0c 100644
--- a/cpukit/score/src/stackallocatorfreenothing.c
+++ b/cpukit/score/src/stackallocatorfreenothing.c
@@ -5,7 +5,8 @@
  *
  * @ingroup RTEMSScoreStack
  *
- * @brief _Stack_Free_nothing() Implementation
+ * @brief This source file contains the implementation of
+ *   _Stack_Free_nothing().
  */
 
 /*
diff --git a/cpukit/score/src/stackallocatorinit.c b/cpukit/score/src/stackallocatorinit.c
index 31e239bd46..a57a253301 100644
--- a/cpukit/score/src/stackallocatorinit.c
+++ b/cpukit/score/src/stackallocatorinit.c
@@ -5,7 +5,8 @@
  *
  * @ingroup RTEMSScoreStack
  *
- * @brief Stack Allocator Initialization
+ * @brief This source file contains the implementation of
+ *   _Stack_Allocator_do_initialize().
  */
 
 /*
diff --git a/cpukit/score/src/thread.c b/cpukit/score/src/thread.c
index 3dde437e72..d66ec80d69 100644
--- a/cpukit/score/src/thread.c
+++ b/cpukit/score/src/thread.c
@@ -1,8 +1,11 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Initialize Thread Handler
- *  @ingroup RTEMSScoreThread
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains static assertions related to the Thread
+ *   Handler and the implementation of _Thread_Initialize_information() and
+ *   _Thread_Handler_initialization().
  */
 
 /*
diff --git a/cpukit/score/src/threadallocateunlimited.c b/cpukit/score/src/threadallocateunlimited.c
index 6f2dec7388..6bd3b3ec7a 100644
--- a/cpukit/score/src/threadallocateunlimited.c
+++ b/cpukit/score/src/threadallocateunlimited.c
@@ -1,12 +1,15 @@
+/* SPDX-License-Identifier: BSD-2-Clause */
+
 /**
  * @file
  *
  * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Extend_information().
  */
 
 /*
- * SPDX-License-Identifier: BSD-2-Clause
- *
  * Copyright (C) 2019, 2020 embedded brains GmbH
  *
  * Redistribution and use in source and binary forms, with or without
diff --git a/cpukit/score/src/threadchangepriority.c b/cpukit/score/src/threadchangepriority.c
index 458eae810a..13e9147916 100644
--- a/cpukit/score/src/threadchangepriority.c
+++ b/cpukit/score/src/threadchangepriority.c
@@ -1,9 +1,13 @@
 /**
  * @file
  *
- * @brief Changes the Priority of a Thread
- *
  * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Priority_add(), _Thread_Priority_and_sticky_update(),
+ *   _Thread_Priority_changed(), _Thread_Priority_perform_actions(),
+ *   _Thread_Priority_remove(), _Thread_Priority_replace(), and
+ *   _Thread_Priority_update().
  */
 
 /*
diff --git a/cpukit/score/src/threadclearstate.c b/cpukit/score/src/threadclearstate.c
index 3af759e310..0ee9c4b184 100644
--- a/cpukit/score/src/threadclearstate.c
+++ b/cpukit/score/src/threadclearstate.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Clear Thread state
- *  @ingroup RTEMSScoreThread
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Clear_state_locked() and _Thread_Clear_state().
  */
 
 /*
diff --git a/cpukit/score/src/threadcreateidle.c b/cpukit/score/src/threadcreateidle.c
index 1e18ad07cc..50114b84de 100644
--- a/cpukit/score/src/threadcreateidle.c
+++ b/cpukit/score/src/threadcreateidle.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Create Idle Thread
- *  @ingroup RTEMSScoreThread
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Create_idle().
  */
 
 /*
diff --git a/cpukit/score/src/threaddispatch.c b/cpukit/score/src/threaddispatch.c
index c57ddb01ae..c4dadc0ff1 100644
--- a/cpukit/score/src/threaddispatch.c
+++ b/cpukit/score/src/threaddispatch.c
@@ -1,9 +1,12 @@
 /**
  * @file
- * 
+ *
  * @ingroup RTEMSScoreThread
  *
- * @brief Dispatch Thread
+ * @brief This source file contains the definition of ::_Thread_Allocated_fp
+ *   and ::_User_extensions_Switches_list and the implementation of
+ *   _Thread_Dispatch(), _Thread_Dispatch_direct(), _Thread_Dispatch_enable(),
+ *   and _Thread_Do_dispatch().
  */
 
 /*
diff --git a/cpukit/score/src/threadentryadaptoridle.c b/cpukit/score/src/threadentryadaptoridle.c
index c3034a6c8d..270953df4e 100644
--- a/cpukit/score/src/threadentryadaptoridle.c
+++ b/cpukit/score/src/threadentryadaptoridle.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Entry_adaptor_idle().
+ */
+
 /*
  * Copyright (c) 2015 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/threadentryadaptornumeric.c b/cpukit/score/src/threadentryadaptornumeric.c
index 78cf700e2b..a1a2ad2206 100644
--- a/cpukit/score/src/threadentryadaptornumeric.c
+++ b/cpukit/score/src/threadentryadaptornumeric.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Entry_adaptor_numeric().
+ */
+
 /*
  * Copyright (c) 2015 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/threadentryadaptorpointer.c b/cpukit/score/src/threadentryadaptorpointer.c
index 4ba6227230..d5a3111912 100644
--- a/cpukit/score/src/threadentryadaptorpointer.c
+++ b/cpukit/score/src/threadentryadaptorpointer.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Entry_adaptor_pointer().
+ */
+
 /*
  * Copyright (c) 2015 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/threadget.c b/cpukit/score/src/threadget.c
index 1333253289..d596cd5ac4 100644
--- a/cpukit/score/src/threadget.c
+++ b/cpukit/score/src/threadget.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Maps Thread IDs to TCB Pointer
- *
  * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Get().
  */
 
 /*
diff --git a/cpukit/score/src/threadgetcputimeused.c b/cpukit/score/src/threadgetcputimeused.c
index b89050af96..7406da0bf3 100644
--- a/cpukit/score/src/threadgetcputimeused.c
+++ b/cpukit/score/src/threadgetcputimeused.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Get_CPU_time_used().
+ */
+
 /*
  * Copyright (c) 2016 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/threadhandler.c b/cpukit/score/src/threadhandler.c
index 6742b0b391..5ad927f391 100644
--- a/cpukit/score/src/threadhandler.c
+++ b/cpukit/score/src/threadhandler.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Thread Handler
- *  @ingroup RTEMSScoreThread
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the definition of
+ *   ::_Thread_Global_constructor and the implementation of _Thread_Handler().
  */
 
 /*
diff --git a/cpukit/score/src/threadidledefault.c b/cpukit/score/src/threadidledefault.c
index 88dbbb5331..2386c0317d 100644
--- a/cpukit/score/src/threadidledefault.c
+++ b/cpukit/score/src/threadidledefault.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the default definition of
+ *   ::_Thread_Idle_body.
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/score/src/threadinitialize.c b/cpukit/score/src/threadinitialize.c
index 4c6d849111..05c30c3d43 100644
--- a/cpukit/score/src/threadinitialize.c
+++ b/cpukit/score/src/threadinitialize.c
@@ -1,10 +1,12 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Initialize Thread
+ * @ingroup RTEMSScoreThread
  *
- *  @ingroup RTEMSScoreThread
+ * @brief This source file contains the implementation of
+ *   _Thread_Initialize().
  */
+
 /*
  *  COPYRIGHT (c) 1989-2014.
  *  On-Line Applications Research Corporation (OAR).
diff --git a/cpukit/score/src/threaditerate.c b/cpukit/score/src/threaditerate.c
index 455aa1b91a..5e4ceff83e 100644
--- a/cpukit/score/src/threaditerate.c
+++ b/cpukit/score/src/threaditerate.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Iterate().
+ */
+
 /*
  * Copyright (c) 2016 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/threadloadenv.c b/cpukit/score/src/threadloadenv.c
index 9b0808cbf8..fec2a616d8 100644
--- a/cpukit/score/src/threadloadenv.c
+++ b/cpukit/score/src/threadloadenv.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Initializes Enviroment for A Thread
- *
  * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Load_environment().
  */
 
 /*
diff --git a/cpukit/score/src/threadmp.c b/cpukit/score/src/threadmp.c
index d03800abd2..fd595251bc 100644
--- a/cpukit/score/src/threadmp.c
+++ b/cpukit/score/src/threadmp.c
@@ -1,8 +1,11 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Distributed MP Support
- *  @ingroup RTEMSScoreThreadMP
+ * @ingroup RTEMSScoreThreadMP
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_MP_Handler_initialization(), _Thread_MP_Allocate_proxy(),
+ *   _Thread_MP_Find_proxy(), _Thread_MP_Free_proxy().
  */
 
 /*
diff --git a/cpukit/score/src/threadname.c b/cpukit/score/src/threadname.c
index 95abc7d209..6e41911186 100644
--- a/cpukit/score/src/threadname.c
+++ b/cpukit/score/src/threadname.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Set_name() and _Thread_Get_name().
+ */
+
 /*
  * Copyright (c) 2017 embedded brains GmbH.
  *
diff --git a/cpukit/score/src/threadq.c b/cpukit/score/src/threadq.c
index ffce17a857..55d8760f7c 100644
--- a/cpukit/score/src/threadq.c
+++ b/cpukit/score/src/threadq.c
@@ -1,8 +1,15 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Thread Queue Initialize
- *  @ingroup RTEMSScoreThreadQ
+ * @ingroup RTEMSScoreThreadQueue
+ *
+ * @brief This source file contains static assertions related to the Thread
+ *   Queue Handler, the definition of ::_Thread_queue_Object_name, and the
+ *   implementation of _Thread_queue_Acquire(),
+ *   _Thread_queue_Do_acquire_critical(), _Thread_queue_Initialize(),
+ *   _Thread_queue_MP_callout_do_nothing(), _Thread_queue_Object_initialize(),
+ *   _Thread_queue_Queue_get_name_and_id(), _Thread_queue_Release(), and
+ *   _Thread_queue_Release_critical().
  */
 
 /*
diff --git a/cpukit/score/src/threadqenqueue.c b/cpukit/score/src/threadqenqueue.c
index f0a28457a1..ba31b13dd1 100644
--- a/cpukit/score/src/threadqenqueue.c
+++ b/cpukit/score/src/threadqenqueue.c
@@ -1,9 +1,16 @@
 /**
  * @file
  *
- * @ingroup RTEMSScoreThreadQ
+ * @ingroup RTEMSScoreThreadQueue
  *
- * @brief Thread Queue Operations
+ * @brief This source file contains the implementation of
+ *   _Thread_queue_Deadlock_fatal(), _Thread_queue_Deadlock_status(),
+ *   _Thread_queue_Do_dequeue(), _Thread_queue_Enqueue(),
+ *   _Thread_queue_Enqueue_do_nothing_extra(), _Thread_queue_Enqueue_sticky(),
+ *   _Thread_queue_Extract(), _Thread_queue_Extract_critical(),
+ *   _Thread_queue_Extract_locked(), _Thread_queue_Path_acquire_critical(),
+ *   _Thread_queue_Path_release_critical(), _Thread_queue_Surrender(),
+ *   _Thread_queue_Surrender_sticky(), and _Thread_queue_Unblock_critical().
  */
 
 /*
diff --git a/cpukit/score/src/threadqextractwithproxy.c b/cpukit/score/src/threadqextractwithproxy.c
index d9b6f58c78..1370aecb86 100644
--- a/cpukit/score/src/threadqextractwithproxy.c
+++ b/cpukit/score/src/threadqextractwithproxy.c
@@ -1,13 +1,10 @@
 /**
- *  @brief _Thread_queue_Extract_with_proxy
+ * @file
  *
- *  This routine extracts the_thread from the_thread_queue
- *  and ensures that if there is a proxy for this task on
- *  another node, it is also dealt with. A proxy is a data
- *  data that is on the thread queue on the remote node and
- *  acts as a proxy for the local thread. If the local thread
- *  was waiting on a remote operation, then the remote side
- *  of the operation must be cleaned up.
+ * @ingroup RTEMSScoreThreadQueue
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_queue_Extract_with_proxy().
  */
 
 /*
diff --git a/cpukit/score/src/threadqfirst.c b/cpukit/score/src/threadqfirst.c
index 4c3939ff7a..9908523298 100644
--- a/cpukit/score/src/threadqfirst.c
+++ b/cpukit/score/src/threadqfirst.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Thread Queue First
- *  @ingroup RTEMSScoreThreadQ
+ * @ingroup RTEMSScoreThreadQueue
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_queue_First().
  */
 
 /*
diff --git a/cpukit/score/src/threadqflush.c b/cpukit/score/src/threadqflush.c
index 5666aaf22c..357e3d696e 100644
--- a/cpukit/score/src/threadqflush.c
+++ b/cpukit/score/src/threadqflush.c
@@ -1,9 +1,13 @@
 /**
  * @file
  *
- * @ingroup RTEMSScoreThreadQ
+ * @ingroup RTEMSScoreThreadQueue
  *
- * @brief Thread Queue Flush
+ * @brief This source file contains the implementation of
+ *   _Thread_queue_Flush_default_filter(),
+ *   _Thread_queue_Flush_status_object_was_deleted(),
+ *   _Thread_queue_Flush_status_unavailable(), and
+ *   _Thread_queue_Flush_critical().
  */
 
 /*
diff --git a/cpukit/score/src/threadqops.c b/cpukit/score/src/threadqops.c
index 9894c3628b..9cf63d41f6 100644
--- a/cpukit/score/src/threadqops.c
+++ b/cpukit/score/src/threadqops.c
@@ -1,3 +1,14 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreThreadQueue
+ *
+ * @brief This source file contains the definition of
+ *   ::_Thread_queue_Operations_default, ::_Thread_queue_Operations_FIFO,
+ *   ::_Thread_queue_Operations_priority, and
+ *   ::_Thread_queue_Operations_priority_inherit.
+ */
+
 /*
  * Copyright (c) 2015, 2016 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/threadqtimeout.c b/cpukit/score/src/threadqtimeout.c
index 3a08342740..ec8f67c93b 100644
--- a/cpukit/score/src/threadqtimeout.c
+++ b/cpukit/score/src/threadqtimeout.c
@@ -1,3 +1,14 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreThreadQueue
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_queue_Add_timeout_ticks(), _Thread_queue_Add_timeout_timespec(),
+ *   _Thread_queue_Add_timeout_monotonic_timespec(), and
+ *   _Thread_queue_Add_timeout_realtime_timespec().
+ */
+
 /*
  * Copyright (c) 2016, 2017 embedded brains GmbH
  *
diff --git a/cpukit/score/src/threadrestart.c b/cpukit/score/src/threadrestart.c
index 3350bfe464..b4204f7fbb 100644
--- a/cpukit/score/src/threadrestart.c
+++ b/cpukit/score/src/threadrestart.c
@@ -3,7 +3,10 @@
  *
  * @ingroup RTEMSScoreThread
  *
- * @brief Restart Thread 
+ * @brief This source file contains the implementation of _Thread_Cancel(),
+ *   _Thread_Change_life(), _Thread_Close(), _Thread_Exit(), _Thread_Join(),
+ *   _Thread_Kill_zombies(), _Thread_Restart_other(), _Thread_Restart_self(),
+ *   and _Thread_Set_life_protection().
  */
 
 /*
diff --git a/cpukit/score/src/threadscheduler.c b/cpukit/score/src/threadscheduler.c
index bacb4e746d..19459e8dec 100644
--- a/cpukit/score/src/threadscheduler.c
+++ b/cpukit/score/src/threadscheduler.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Scheduler_process_requests().
+ */
+
 /*
  * Copyright (c) 2016 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/threadsetstate.c b/cpukit/score/src/threadsetstate.c
index d07ae05fdd..ecfab2fdd6 100644
--- a/cpukit/score/src/threadsetstate.c
+++ b/cpukit/score/src/threadsetstate.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Sets States for a Thread
- *
  * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Set_state_locked() and _Thread_Set_state.
  */
 
 /*
diff --git a/cpukit/score/src/threadstackallocate.c b/cpukit/score/src/threadstackallocate.c
index 2ca7ec2bff..55f4370fd2 100644
--- a/cpukit/score/src/threadstackallocate.c
+++ b/cpukit/score/src/threadstackallocate.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreStack
  *
- * @brief Stack Allocate Helper
+ * @brief This source file contains the implementation of
+ *   _Stack_Allocate().
  */
 
 /*
diff --git a/cpukit/score/src/threadstackfree.c b/cpukit/score/src/threadstackfree.c
index 3e70f8b3e4..ffe13dc9ce 100644
--- a/cpukit/score/src/threadstackfree.c
+++ b/cpukit/score/src/threadstackfree.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreStack
  *
- * @brief Deallocate Thread Stack
+ * @brief This source file contains the implementation of
+ *   _Stack_Free().
  */
 
 /*
diff --git a/cpukit/score/src/threadstart.c b/cpukit/score/src/threadstart.c
index 5d49e9ea5a..e75c536a2c 100644
--- a/cpukit/score/src/threadstart.c
+++ b/cpukit/score/src/threadstart.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Initializes Thread and Executes it
- *
  * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Start().
  */
 
 /*
diff --git a/cpukit/score/src/threadstartmultitasking.c b/cpukit/score/src/threadstartmultitasking.c
index 5b2b99310a..a0b465a226 100644
--- a/cpukit/score/src/threadstartmultitasking.c
+++ b/cpukit/score/src/threadstartmultitasking.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Start Thread Multitasking
- *  @ingroup RTEMSScoreThread
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Start_multitasking().
  */
 
 /*
diff --git a/cpukit/score/src/threadtimeout.c b/cpukit/score/src/threadtimeout.c
index 6d14001d27..2f2017bebe 100644
--- a/cpukit/score/src/threadtimeout.c
+++ b/cpukit/score/src/threadtimeout.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Thread Wait Timeout
- *
  * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Continue() and _Thread_Timeout().
  */
 
 /*
diff --git a/cpukit/score/src/threadunpin.c b/cpukit/score/src/threadunpin.c
index f3ed0cf07e..eacc40f984 100644
--- a/cpukit/score/src/threadunpin.c
+++ b/cpukit/score/src/threadunpin.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Do_unpin().
+ */
+
 /*
  * Copyright (c) 2018 embedded brains GmbH
  *
diff --git a/cpukit/score/src/threadwaitgetid.c b/cpukit/score/src/threadwaitgetid.c
index 62982417f8..b5d652870b 100644
--- a/cpukit/score/src/threadwaitgetid.c
+++ b/cpukit/score/src/threadwaitgetid.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Wait_get_id().
+ */
+
 /*
  * Copyright (c) 2016, 2017 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/threadyield.c b/cpukit/score/src/threadyield.c
index 8585e2ca43..e69b689ee7 100644
--- a/cpukit/score/src/threadyield.c
+++ b/cpukit/score/src/threadyield.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Thread Yield
- *
  * @ingroup RTEMSScoreThread
+ *
+ * @brief This source file contains the implementation of
+ *   _Thread_Yield().
  */
 
 /*
diff --git a/cpukit/score/src/timespecaddto.c b/cpukit/score/src/timespecaddto.c
index cd2dca8db7..363fac19eb 100644
--- a/cpukit/score/src/timespecaddto.c
+++ b/cpukit/score/src/timespecaddto.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Add to a Timespec
- *  @ingroup Timespec
+ * @ingroup RTEMSScoreTimespec
+ *
+ * @brief This source file contains the implementation of
+ *   _Timespec_Add_to().
  */
 
 /*
diff --git a/cpukit/score/src/timespecdivide.c b/cpukit/score/src/timespecdivide.c
index 3c075fa75f..6934f649b1 100644
--- a/cpukit/score/src/timespecdivide.c
+++ b/cpukit/score/src/timespecdivide.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup Timespec
+ * @ingroup RTEMSScoreTimespec
  *
- * @brief Divide Timespec By Integer
+ * @brief This source file contains the implementation of
+ *   _Timespec_Divide().
  */
 
 /*
diff --git a/cpukit/score/src/timespecdividebyinteger.c b/cpukit/score/src/timespecdividebyinteger.c
index 5534196ece..8cf227ec31 100644
--- a/cpukit/score/src/timespecdividebyinteger.c
+++ b/cpukit/score/src/timespecdividebyinteger.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Divide Timespec By Integer
+ * @ingroup RTEMSScoreTimespec
  *
- * @ingroup Timespec
+ * @brief This source file contains the implementation of
+ *   _Timespec_Divide_by_integer().
  */
 
 /*
diff --git a/cpukit/score/src/timespecfromticks.c b/cpukit/score/src/timespecfromticks.c
index 2d3207a899..497762326f 100644
--- a/cpukit/score/src/timespecfromticks.c
+++ b/cpukit/score/src/timespecfromticks.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Convert Ticks to Timespec
- *  @ingroup Timespec
+ * @ingroup RTEMSScoreTimespec
+ *
+ * @brief This source file contains the implementation of
+ *   _Timespec_From_ticks().
  */
 
 /*
diff --git a/cpukit/score/src/timespecgetasnanoseconds.c b/cpukit/score/src/timespecgetasnanoseconds.c
index 7435464986..96b4f64467 100644
--- a/cpukit/score/src/timespecgetasnanoseconds.c
+++ b/cpukit/score/src/timespecgetasnanoseconds.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Get As Nanoseconds
- *  @ingroup Timespec
+ * @ingroup RTEMSScoreTimespec
+ *
+ * @brief This source file contains the implementation of
+ *   _Timespec_Get_as_nanoseconds().
  */
 
 /*
diff --git a/cpukit/score/src/timespecisvalid.c b/cpukit/score/src/timespecisvalid.c
index 88743f67ce..69d6be2448 100644
--- a/cpukit/score/src/timespecisvalid.c
+++ b/cpukit/score/src/timespecisvalid.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Is Timespec Valid
- *  @ingroup Timespec
+ * @ingroup RTEMSScoreTimespec
+ *
+ * @brief This source file contains the implementation of
+ *   _Timespec_Is_valid().
  */
 
 /*
diff --git a/cpukit/score/src/timespeclessthan.c b/cpukit/score/src/timespeclessthan.c
index 13a57cefe9..9239cd20a1 100644
--- a/cpukit/score/src/timespeclessthan.c
+++ b/cpukit/score/src/timespeclessthan.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Timespec Less Than Operator
- *  @ingroup Timespec
+ * @ingroup RTEMSScoreTimespec
+ *
+ * @brief This source file contains the implementation of
+ *   _Timespec_Less_than().
  */
 
 /*
diff --git a/cpukit/score/src/timespecsubtract.c b/cpukit/score/src/timespecsubtract.c
index cd07d8677f..8e444b97bc 100644
--- a/cpukit/score/src/timespecsubtract.c
+++ b/cpukit/score/src/timespecsubtract.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Subtract Two Timespec
- *  @ingroup Timespec
+ * @ingroup RTEMSScoreTimespec
+ *
+ * @brief This source file contains the implementation of
+ *   _Timespec_Subtract().
  */
 
 /*
diff --git a/cpukit/score/src/timespectoticks.c b/cpukit/score/src/timespectoticks.c
index f37504c058..d099bf25f5 100644
--- a/cpukit/score/src/timespectoticks.c
+++ b/cpukit/score/src/timespectoticks.c
@@ -1,5 +1,10 @@
 /**
- *  @file
+ * @file
+ *
+ * @ingroup RTEMSScoreTimespec
+ *
+ * @brief This source file contains the implementation of
+ *   _Timespec_To_ticks().
  */
 
 /*
diff --git a/cpukit/score/src/tlsallocsize.c b/cpukit/score/src/tlsallocsize.c
index a9f0c0cd23..e7854c677a 100644
--- a/cpukit/score/src/tlsallocsize.c
+++ b/cpukit/score/src/tlsallocsize.c
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreTLS
+ *
+ * @brief This source file contains the implementation of
+ *   _TLS_Get_allocation_size().
+ */
+
 /*
  * Copyright (C) 2014, 2020 embedded brains GmbH (http://www.embedded-brains.de)
  *
diff --git a/cpukit/score/src/userext.c b/cpukit/score/src/userext.c
index 6106cd8217..0c3ac4f67d 100644
--- a/cpukit/score/src/userext.c
+++ b/cpukit/score/src/userext.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreUserExt
  *
- * @brief User Extension Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _User_extensions_Handler_initialization().
  */
 
 /*
diff --git a/cpukit/score/src/userextaddset.c b/cpukit/score/src/userextaddset.c
index f4f709b4b5..aa21e08b85 100644
--- a/cpukit/score/src/userextaddset.c
+++ b/cpukit/score/src/userextaddset.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreUserExt
  *
- * @brief User Extension Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _User_extensions_Add_set().
  */
 
 /*
diff --git a/cpukit/score/src/userextiterate.c b/cpukit/score/src/userextiterate.c
index 06665a2d7a..a25a4ad768 100644
--- a/cpukit/score/src/userextiterate.c
+++ b/cpukit/score/src/userextiterate.c
@@ -1,9 +1,17 @@
 /**
  * @file
  *
- * @brief User Extension Iteration Helpers
- *
  * @ingroup RTEMSScoreUserExt
+ *
+ * @brief This source file contains the definition of ::_User_extensions_List
+ *   and the implementation of _User_extensions_Fatal_visitor(),
+ *   _User_extensions_Iterate(), _User_extensions_Thread_begin_visitor(),
+ *   _User_extensions_Thread_create_visitor(),
+ *   _User_extensions_Thread_delete_visitor(),
+ *   _User_extensions_Thread_exitted_visitor(),
+ *   _User_extensions_Thread_restart_visitor(),
+ *   _User_extensions_Thread_start_visitor(), and
+ *   _User_extensions_Thread_terminate_visitor().
  */
 
 /*
diff --git a/cpukit/score/src/userextremoveset.c b/cpukit/score/src/userextremoveset.c
index aeb54a3f8f..d0efae6a2e 100644
--- a/cpukit/score/src/userextremoveset.c
+++ b/cpukit/score/src/userextremoveset.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreUserExt
  *
- * @brief User Extension Handler implementation.
+ * @brief This source file contains the implementation of
+ *   _User_extensions_Remove_set().
  */
 
 /*
diff --git a/cpukit/score/src/watchdoginsert.c b/cpukit/score/src/watchdoginsert.c
index 766b828368..7e74325f0e 100644
--- a/cpukit/score/src/watchdoginsert.c
+++ b/cpukit/score/src/watchdoginsert.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreWatchdog
  *
- * @brief Watchdog Insert
+ * @brief This source file contains the implementation of
+ *   _Watchdog_Insert().
  */
 
 /*
diff --git a/cpukit/score/src/watchdogremove.c b/cpukit/score/src/watchdogremove.c
index 44a5ea26f3..1af5eccd34 100644
--- a/cpukit/score/src/watchdogremove.c
+++ b/cpukit/score/src/watchdogremove.c
@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSScoreWatchdog
  *
- * @brief Remove Watchdog
+ * @brief This source file contains the implementation of
+ *   _Watchdog_Remove().
  */
 
 /*
diff --git a/cpukit/score/src/watchdogtick.c b/cpukit/score/src/watchdogtick.c
index 791f9e0573..e77ca4e1e1 100644
--- a/cpukit/score/src/watchdogtick.c
+++ b/cpukit/score/src/watchdogtick.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreWatchdog
+ *
+ * @brief This source file contains the implementation of
+ *   _Watchdog_Do_tickle() and _Watchdog_Tick().
+ */
+
 /*
  * Copyright (c) 2015, 2016 embedded brains GmbH.  All rights reserved.
  *
diff --git a/cpukit/score/src/watchdogtickssinceboot.c b/cpukit/score/src/watchdogtickssinceboot.c
index c522608169..b746f087f4 100644
--- a/cpukit/score/src/watchdogtickssinceboot.c
+++ b/cpukit/score/src/watchdogtickssinceboot.c
@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Watchdog Ticks Since Boot
- *  @ingroup RTEMSScoreWatchdog
+ * @ingroup RTEMSScoreWatchdog
+ *
+ * @brief This source file contains the definition of
+ *   ::_Watchdog_Ticks_since_boot.
  */
 
 /*
diff --git a/cpukit/score/src/watchdogtimeslicedefault.c b/cpukit/score/src/watchdogtimeslicedefault.c
index 1e6ab5a91c..56f6bdb5d5 100644
--- a/cpukit/score/src/watchdogtimeslicedefault.c
+++ b/cpukit/score/src/watchdogtimeslicedefault.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreWatchdog
+ *
+ * @brief This source file contains the default definition of
+ *   ::_Watchdog_Ticks_per_timeslice.
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/score/src/wkspace.c b/cpukit/score/src/wkspace.c
index fdc046313e..3ca3c8387e 100644
--- a/cpukit/score/src/wkspace.c
+++ b/cpukit/score/src/wkspace.c
@@ -1,8 +1,12 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Workspace Handler Support
- *  @ingroup RTEMSScoreWorkspace
+ * @ingroup RTEMSScoreWorkspace
+ *
+ * @brief This source file contains the definition of ::_Workspace_Area, the
+ *   implementation of _Workspace_Handler_initialization(),
+ *   _Workspace_Allocate(), and _Workspace_Free(), and the Workspace Handler
+ *   system initialization.
  */
 
 /*
diff --git a/cpukit/score/src/wkspaceisunifieddefault.c b/cpukit/score/src/wkspaceisunifieddefault.c
index 3c357505b4..db38c968b7 100644
--- a/cpukit/score/src/wkspaceisunifieddefault.c
+++ b/cpukit/score/src/wkspaceisunifieddefault.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreWorkspace
+ *
+ * @brief This source file contains the default definition of
+ *   ::_Workspace_Is_unified.
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/score/src/wkspacemallocinitdefault.c b/cpukit/score/src/wkspacemallocinitdefault.c
index 586c3eef7c..6ee951cff1 100644
--- a/cpukit/score/src/wkspacemallocinitdefault.c
+++ b/cpukit/score/src/wkspacemallocinitdefault.c
@@ -5,8 +5,8 @@
  *
  * @ingroup RTEMSScoreWorkspace
  *
- * @brief This source file provides the default definition of
- * _Workspace_Malloc_initializer.
+ * @brief This source file contains the default definition of
+ *   ::_Workspace_Malloc_initializer.
  */
 
 /*
diff --git a/cpukit/score/src/wkspacemallocinitunified.c b/cpukit/score/src/wkspacemallocinitunified.c
index 6aba1ff0a5..d21ef22d19 100644
--- a/cpukit/score/src/wkspacemallocinitunified.c
+++ b/cpukit/score/src/wkspacemallocinitunified.c
@@ -5,7 +5,7 @@
  *
  * @ingroup RTEMSScoreWorkspace
  *
- * @brief This source file provides the implementation of
+ * @brief This source file contains the implementation of
  *   _Workspace_Malloc_initialize_unified().
  */
 
diff --git a/cpukit/score/src/wkstringduplicate.c b/cpukit/score/src/wkstringduplicate.c
index 5c0b0877f1..180369f1a8 100644
--- a/cpukit/score/src/wkstringduplicate.c
+++ b/cpukit/score/src/wkstringduplicate.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Duplicates String with Memory from the Workspace
- *
  * @ingroup RTEMSScoreWorkspace
+ *
+ * @brief This source file contains the implementation of
+ *   _Workspace_String_duplicate().
  */
 
 /*
author	Sebastian Huber <sebastian.huber@embedded-brains.de>	2020-11-27 17:21:23 +0100
committer	Sebastian Huber <sebastian.huber@embedded-brains.de>	2020-12-02 07:45:53 +0100
commit	9278f3d04f1e26071cb98a5e2940177abc40b6d8 (patch)
tree	9f5d198e4af5ad22b96012a17ce0a23769acf01f /cpukit/score/src
parent	rtems: Canonicalize Doxygen @file comments (diff)
download	rtems-9278f3d04f1e26071cb98a5e2940177abc40b6d8.tar.bz2