rtems: Canonicalize Doxygen @file comments

Use common phrases for the file brief descriptions.

Update #3706.

cpukit/include/rtems/rtems/asrimpl.h

@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSImplClassicASR
  *
- * @brief Classic ASR Implementation
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicASR support.
  */
 
 /* COPYRIGHT (c) 1989-2008.

cpukit/include/rtems/rtems/attrimpl.h

@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSImplClassicAttr
  *
- * @brief Classic Attributes Implementation
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicAttr support.
  */
 
 /*

cpukit/include/rtems/rtems/barrierimpl.h

@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSImplClassicBarrier
  *
- * @brief Classic Barrier Manager Implementation
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicBarrier.
  */
 
 /*

cpukit/include/rtems/rtems/clockimpl.h

@@ -3,8 +3,8 @@
  *
  * @ingroup RTEMSImplClassicClock
  *
- * @brief This header file provides interfaces used by the Clock Manager
+ * @brief This header file provides the implementation interfaces of
- *   implementation.
+ *   the @ref RTEMSImplClassicClock.
  */
 
 /* COPYRIGHT (c) 1989-2013.

cpukit/include/rtems/rtems/dpmemimpl.h

@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSImplClassicDPMem
  *
- * @brief Dual Ported Memory Manager Implementation
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicDPMem
  */
 
 /*  COPYRIGHT (c) 1989-2008.

cpukit/include/rtems/rtems/eventimpl.h

@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSImplClassicEvent
  *
- * @brief This header file provides interfaces used by the event implementation.
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicEvent.
  */
 
 /*  COPYRIGHT (c) 1989-2008.

cpukit/include/rtems/rtems/eventmp.h

@@ -3,8 +3,8 @@
  *
  * @ingroup RTEMSImplClassicEventMP
  *
- * This include file contains all the constants and structures associated
+ * @brief This header file provides the implementation interfaces of the
- * with the Multiprocessing Support in the Event Manager.
+ *   @ref RTEMSImplClassicEventMP.
  */
 
 /* COPYRIGHT (c) 1989-2013.

cpukit/include/rtems/rtems/messageimpl.h

@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSImplClassicMessage
  *
- * @brief Classic Message Queue Manager Implementation
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicMessage.
  */
 
 /*  COPYRIGHT (c) 1989-2008.

cpukit/include/rtems/rtems/modesimpl.h

@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSImplClassicModes
  *
- * @brief Classic Modes Implementation
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicModes support.
  */
 
 /*  COPYRIGHT (c) 1989-2008.

cpukit/include/rtems/rtems/mp.h

@@ -1,10 +1,9 @@
 /**
  * @file
  *
- * @ingroup ClassicMP
+ * @ingroup RTEMSImplClassic
  *
- * This include file contains all the constants and structures associated
+ * @brief This header file provides parts of the multiprocessing (MP) API.
- * with the Multiprocessing Manager.
  */
 
 /* COPYRIGHT (c) 1989-2013.
@@ -21,7 +20,7 @@
 #include <rtems/score/mppkt.h>
 
 /**
- *  @defgroup ClassicMP Multiprocessing
+ *  @defgroup RTEMSAPIClassicMP Multiprocessing
  *
  *  @ingroup RTEMSAPIClassic
  *

cpukit/include/rtems/rtems/msgmp.h

@@ -3,10 +3,8 @@
  *
  * @ingroup RTEMSImplClassicMessageMP
  *
- * @brief Message Manager MP Support
+ * @brief This header file provides the implementation interfaces of the
- *
+ *   @ref RTEMSImplClassicMessageMP.
- * This include file contains all the constants and structures associated
- * with the Multiprocessing Support in the Message Manager.
  */
 
 /* COPYRIGHT (c) 1989-2013.

cpukit/include/rtems/rtems/objectimpl.h

@@ -5,7 +5,8 @@
  *
  * @ingroup RTEMSImplClassicObject
  *
- * @brief Implementation Interfaces for Classic Objects
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicObject.
  */
 
 /*

cpukit/include/rtems/rtems/optionsimpl.h

@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSImplClassicOptions
  *
- * @brief Classic Options Implementation
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicOptions support.
  */
 
 /*  COPYRIGHT (c) 1989-2008.

cpukit/include/rtems/rtems/partimpl.h

@@ -3,8 +3,8 @@
  *
  * @ingroup RTEMSImplClassicPartition
  *
- * @brief This header file provides interfaces used by the Partition Manager
+ * @brief This header file provides the implementation interfaces of
- *   implementation.
+ *   the @ref RTEMSImplClassicPartition.
  */
 
 /*  COPYRIGHT (c) 1989-2008.

cpukit/include/rtems/rtems/partmp.h

@@ -3,10 +3,8 @@
  *
  * @ingroup RTEMSImplClassicPartitionMP
  *
- * @brief MP Support in Partition Manager
+ * @brief This header file provides the implementation interfaces of the
- *
+ *   @ref RTEMSImplClassicPartitionMP.
- * This include file contains all the constants and structures associated
- * with the Multiprocessing Support in the Partition Manager.
  */
 
 /* COPYRIGHT (c) 1989-2013.

cpukit/include/rtems/rtems/ratemonimpl.h

@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSImplClassicRateMonotonic
  *
- * @brief Classic Rate Monotonic Scheduler Implementation
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicRateMonotonic.
  */
 
 /*  COPYRIGHT (c) 1989-2008.

cpukit/include/rtems/rtems/regionimpl.h

@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSImplClassicRegion
  *
- * @brief Classic Region Manager Implementation
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicRegion.
  */
 
 /* COPYRIGHT (c) 1989-2008.

cpukit/include/rtems/rtems/semimpl.h

@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSImplClassicSemaphore
  *
- * @brief Classic Semaphore Manager Implementation
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicSemaphore.
  */
 
 /*  COPYRIGHT (c) 1989-2008.

cpukit/include/rtems/rtems/semmp.h

@@ -3,8 +3,8 @@
  *
  * @ingroup RTEMSImplClassicSemaphoreMP
  *
- * This include file contains all the constants and structures associated
+ * @brief This header file provides the implementation interfaces of the
- * with the Multiprocessing Support in the Semaphore Manager.
+ *   @ref RTEMSImplClassicSemaphoreMP.
  */
 
 /* COPYRIGHT (c) 1989-2013.

cpukit/include/rtems/rtems/signalimpl.h

@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSImplClassicSignal
  *
- * @brief Signals Implementation
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicSignal.
  */
 
 /* COPYRIGHT (c) 1989-2008.

cpukit/include/rtems/rtems/signalmp.h

@@ -3,8 +3,8 @@
  *
  * @ingroup RTEMSImplClassicSignalMP
  *
- * This include file contains all the constants and structures associated
+ * @brief This header file provides the implementation interfaces of the
- * with the Multiprocessing Support in the Signal Manager.
+ *   @ref RTEMSImplClassicSignalMP.
  */
 
 /* COPYRIGHT (c) 1989-2013.

cpukit/include/rtems/rtems/statusimpl.h

@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSImplClassicStatus
  *
- * @brief Classic Status Implementation
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicStatus support.
  */
 
 /*  COPYRIGHT (c) 1989-2008.

cpukit/include/rtems/rtems/taskmp.h

@@ -3,8 +3,8 @@
  *
  * @ingroup RTEMSImplClassicTaskMP
  *
- * This include file contains all the constants and structures associated
+ * @brief This header file provides the implementation interfaces of the
- * with the multiprocessing support in the task manager.
+ *   @ref RTEMSImplClassicTaskMP.
  */
 
 /* COPYRIGHT (c) 1989-2013.

cpukit/include/rtems/rtems/tasksimpl.h

@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSImplClassicTask
  *
- * @brief Classic Tasks Manager Implementation
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicTask.
  */
 
 /*  COPYRIGHT (c) 1989-2014.

cpukit/include/rtems/rtems/timerimpl.h

@@ -3,7 +3,8 @@
  *
  * @ingroup RTEMSImplClassicTimer
  *
- * @brief Classic Timer Implementation
+ * @brief This header file provides the implementation interfaces of
+ *   the @ref RTEMSImplClassicTimer.
  */
 
 /*

cpukit/rtems/src/barrier.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicBarrier
+ * @ingroup RTEMSImplClassicBarrier
  *
- * @brief Classic Barrier Information with Zero Objects
+ * @brief This source file contains a definition of the ::_Barrier_Information
+ *   with zero objects.
  */
 
 /*

cpukit/rtems/src/barriercreate.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicBarrier Barriers
+ * @ingroup RTEMSImplClassicBarrier
  *
- * @brief RTEMS Create Barrier
+ * @brief This source file contains the implementation of
+ *   rtems_barrier_create() and the Barrier Manager system initialization.
  */
 
 /*

cpukit/rtems/src/barrierdelete.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Delete Barrier
+ * @ingroup RTEMSImplClassicBarrier
- *  @ingroup ClassicBarrier
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_barrier_delete().
  */
 
 /*

cpukit/rtems/src/barrierident.c

@@ -5,7 +5,8 @@
  *
  * @ingroup RTEMSImplClassicBarrier
  *
- * @brief rtems_barrier_ident() Implementation
+ * @brief This source file contains the implementation of
+ *   rtems_barrier_ident().
  */
 
 /*

cpukit/rtems/src/barrierrelease.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicBarrier Barriers
+ * @ingroup RTEMSImplClassicBarrier
  *
- * @brief RTEMS Barrier Release
+ * @brief This source file contains the implementation of
+ *   rtems_barrier_release().
  */
 
 /*

cpukit/rtems/src/barrierwait.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Barrier Wait
+ * @ingroup RTEMSImplClassicBarrier
- *  @ingroup ClassicBarrier
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_barrier_wait().
  */
 
 /*

cpukit/rtems/src/clockgetsecondssinceepoch.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Obtain Seconds Since Epoch
+ * @ingroup RTEMSImplClassicClock
- *  @ingroup ClassicClock
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_clock_get_seconds_since_epoch().
  */
 
 /*

cpukit/rtems/src/clockgettickspersecond.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Obtain Ticks Per Seconds
+ * @ingroup RTEMSImplClassicClock
- *  @ingroup ClassicClock
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_clock_get_ticks_per_second().
  */
 
 /*

cpukit/rtems/src/clockgettod.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicClock Clocks
+ * @ingroup RTEMSImplClassicClock
  *
- * @brief Obtain Current Time of Day (Classic TOD)
+ * @brief This source file contains the implementation of
+ *   rtems_clock_get_tod().
  */
 
 /*

cpukit/rtems/src/clockgettodtimeval.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Obtain TOD in struct timeval Format
+ * @ingroup RTEMSImplClassicClock
- *  @ingroup ClassicClock
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_clock_get_tod_timeval().
  */
 
 /*

cpukit/rtems/src/clockgetuptime.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicClock Clocks
+ * @ingroup RTEMSImplClassicClock
  *
- * @brief Obtain the System Uptime
+ * @brief This source file contains the implementation of
+ *   rtems_clock_get_uptime().
  */
 
 /*

cpukit/rtems/src/clockgetuptimenanoseconds.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicClock Clocks
+ * @ingroup RTEMSImplClassicClock
  *
- * @brief Returns the system uptime in seconds.
+ * @brief This source file contains the implementation of
+ *   rtems_clock_get_uptime_nanoseconds().
  */
 
 /*

cpukit/rtems/src/clockgetuptimeseconds.c

@@ -1,7 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicClock
+ * @ingroup RTEMSImplClassicClock
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_clock_get_uptime_seconds().
  */
 
 /*

cpukit/rtems/src/clockgetuptimetimeval.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Gets the System Uptime in the Struct Timeval Format
+ * @ingroup RTEMSImplClassicClock
- *  @ingroup ClassicClock
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_clock_get_uptime_timeval().
  */
 
 /*

cpukit/rtems/src/clockset.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Set the Current TOD
+ * @ingroup RTEMSImplClassicClock
- *  @ingroup ClassicClock
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_clock_set().
  */
 
 /*

cpukit/rtems/src/clocktick.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Announce a Clock Tick
+ * @ingroup RTEMSImplClassicClock
- *  @ingroup ClassicClock
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_clock_tick().
  */
 
 /*

cpukit/rtems/src/clocktodtoseconds.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief TOD to Seconds
+ * @ingroup RTEMSImplClassicClock
- *  @ingroup ClassicClock
+ *
+ * @brief This source file contains the implementation of
+ *   _TOD_To_seconds().
  */
 
 /*

cpukit/rtems/src/clocktodvalidate.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief TOD Validate
+ * @ingroup RTEMSImplClassicClock
- *  @ingroup ClassicClock
+ *
+ * @brief This source file contains the implementation of
+ *   _TOD_Validate().
  */
 
 /*

cpukit/rtems/src/dpmem.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicDPMEM
+ * @ingroup RTEMSImplClassicDPMem
  *
- * @brief Classic Dual Ported Memory Information with Zero Objects
+ * @brief This source file contains a definition of
+ *   ::_Dual_ported_memory_Information with zero objects.
  */
 
 /*

cpukit/rtems/src/dpmemcreate.c

@@ -1,8 +1,11 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Create Port
+ * @ingroup RTEMSImplClassicDPMem
- *  @ingroup ClassicDPMEM
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_port_create() and the Dual-Ported Memory Manager system
+ *   initialization.
  */
 
 /*

cpukit/rtems/src/dpmemdelete.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Delete Port
+ * @ingroup RTEMSImplClassicDPMem
- *  @ingroup ClassicDPMEM
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_port_delete().
  */
 
 /*

cpukit/rtems/src/dpmemexternal2internal.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Port External to Internal
+ * @ingroup RTEMSImplClassicDPMem
- *  @ingroup ClassicDPMEM
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_port_external_to_internal().
  */
 
 /*

cpukit/rtems/src/dpmemident.c

@@ -5,7 +5,8 @@
  *
  * @ingroup RTEMSImplClassicDPMem
  *
- * @brief rtems_port_ident() Implementation
+ * @brief This source file contains the implementation of
+ *   rtems_port_ident().
  */
 
 /*

cpukit/rtems/src/dpmeminternal2external.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Port Internal to External
+ * @ingroup RTEMSImplClassicDPMem
- *  @ingroup ClassicDPMEM
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_port_internal_to_external().
  */
 
 /*

cpukit/rtems/src/eventmp.c

@@ -3,8 +3,8 @@
  *
  * @ingroup RTEMSImplClassicEventMP
  *
- * @brief This source file contains the implementation of the task event MPCI
+ * @brief This source file contains the implementation to support the Event
- *   support.
+ *   Manager in multiprocessing (MP) configurations.
  */
 
 /*

cpukit/rtems/src/eventseize.c

@@ -4,7 +4,8 @@
  * @ingroup RTEMSImplClassicEvent
  *
  * @brief This source file contains the implementation of
- *   _Event_Seize() and the task event MPCI support system initialization.
+ *   _Event_Seize() and the Event Manager multiprocessing (MP) support system
+ *   initialization.
  */
 
 /*

cpukit/rtems/src/getapiconfig.c

@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplClassic
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_api_configuration_table().
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *

cpukit/rtems/src/intrbody.c

@@ -1,8 +1,11 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Interrupt Support
+ * @ingroup RTEMSImplClassic
- *  @ingroup ClassicINTR
+ *
+ * @brief This source file contains the implementation of
+ *   directive bindings of the Interrupt Manager for languages other than
+ *   C/C++.
  */
 
 /*

cpukit/rtems/src/intrcatch.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Interrupt Catch
+ * @ingroup RTEMSImplClassic
- *  @ingroup ClassicINTR
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_interrupt_catch().
  */
 
 /*

cpukit/rtems/src/modes.c

@@ -1,11 +1,13 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Body for RTEMS_INTERRUPT_LEVEL Macro
+ * @ingroup RTEMSImplClassic
- *  @ingroup ClassicModes
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_interrupt_level_body() and the definition of ::rtems_interrupt_mask
+ *   to support languages other than C/C++.
  */
 
-
 /*
  *  COPYRIGHT (c) 1989-2012.
  *  On-Line Applications Research Corporation (OAR).

cpukit/rtems/src/mp.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief MP Support
+ * @ingroup RTEMSImplClassic
- *  @ingroup ClassicMP
+ *
+ * @brief This source file contains the implementation to support the Classic
+ *   API in multiprocessing (MP) configurations.
  */
 
 /*

cpukit/rtems/src/msg.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicMessageQueue
+ * @ingroup RTEMSImplClassicMessage
  *
- * @brief Classic Message Queue Information with Zero Objects
+ * @brief This source file contains a definition of the
+ *   ::_Message_queue_Information with zero objects.
  */
 
 /*

cpukit/rtems/src/msgmp.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicMsgMP Message Queue MP Support
+ * @ingroup RTEMSImplClassicMessageMP
  *
- * @brief Multiprocessing Support for the Message Queue Manager
+ * @brief This source file contains the implementation to support the Message
+ *   Manager in multiprocessing (MP) configurations.
  */
 
 /*

cpukit/rtems/src/msgqbroadcast.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Broadcast Message Queue
+ * @ingroup RTEMSImplClassicMessage
- *  @ingroup ClassicMessageQueue
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_message_queue_broadcast().
  */
 
 /*

cpukit/rtems/src/msgqconstruct.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Create Message Queue
+ * @ingroup RTEMSImplClassicMessage
- *  @ingroup ClassicMessageQueue
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_message_queue_construct().
  */
 
 /*

cpukit/rtems/src/msgqdelete.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Delete Message Queue
+ * @ingroup RTEMSImplClassicMessage
- *  @ingroup ClassicMessageQueue
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_message_queue_delete().
  */
 
 /*

cpukit/rtems/src/msgqflush.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicMessageQueue Message Queues
+ * @ingroup RTEMSImplClassicMessage
  *
- * @brief rtems_message_queue_flush
+ * @brief This source file contains the implementation of
+ *   rtems_message_queue_flush().
  */
 
 /*

cpukit/rtems/src/msgqgetnumberpending.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicMessageQueue Message Queues
+ * @ingroup RTEMSImplClassicMessage
  *
- * @brief RTEMS Message Queue Get Number Pending
+ * @brief This source file contains the implementation of
+ *   rtems_message_queue_get_number_pending().
  */
 
 /*

cpukit/rtems/src/msgqident.c

@@ -5,7 +5,8 @@
  *
  * @ingroup RTEMSImplClassicMessage
  *
- * @brief rtems_message_queue_ident() Implementation
+ * @brief This source file contains the implementation of
+ *   rtems_message_queue_ident().
  */
 
 /*

cpukit/rtems/src/msgqreceive.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Message Queue Receive
+ * @ingroup RTEMSImplClassicMessage
- *  @ingroup ClassicMessageQueue
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_message_queue_receive().
  */
 
 /*

cpukit/rtems/src/msgqsend.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicMessageQueue Message Queues
+ * @ingroup RTEMSImplClassicMessage
  *
- * @brief rtems_message_queue_send
+ * @brief This source file contains the implementation of
+ *   rtems_message_queue_send().
  */
 
 /*

cpukit/rtems/src/msgqurgent.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Urgent Message Queue
+ * @ingroup RTEMSImplClassicMessage
- *  @ingroup ClassicMessageQueue
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_message_queue_urgent().
  */
 
 /*

cpukit/rtems/src/part.c

@@ -3,8 +3,8 @@
  *
  * @ingroup RTEMSImplClassicPartition
  *
- * @brief This source file contains a definition of ::_Partition_Information
+ * @brief This source file contains a definition of the
- *   with zero objects.
+ *   ::_Partition_Information with zero objects.
  */
 
 /*

cpukit/rtems/src/partcreate.c

@@ -4,7 +4,7 @@
  * @ingroup RTEMSImplClassicPartition
  *
  * @brief This source file contains the implementation of
- *   rtems_partition_create().
+ *   rtems_partition_create() and the Partition Manager system initialization.
  */
 
 /*

cpukit/rtems/src/partmp.c

@@ -1,10 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicPartMP
+ * @ingroup RTEMSImplClassicPartitionMP
  *
- * @brief This source file contains the implementation of the Partition Manager
+ * @brief This source file contains the implementation to support the Partition
- *   MPCI support.
+ *   Manager in multiprocessing (MP) configurations.
  */
 
 /*

cpukit/rtems/src/ratemon.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicRateMon
+ * @ingroup RTEMSImplClassicRateMonotonic
  *
- * @brief Classic Rate Monotonic Information with Zero Objects
+ * @brief This source file contains a definition of the
+ *   ::_Rate_monotonic_Information with zero objects.
  */
 
 /*

cpukit/rtems/src/ratemoncancel.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Rate Monotonic Cancel
+ * @ingroup RTEMSImplClassicRateMonotonic
- *  @ingroup ClassicRateMon
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_rate_monotonic_cancel().
  */
 
 /*

cpukit/rtems/src/ratemoncreate.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicRateMon Rate Monotonic Scheduler
+ * @ingroup RTEMSImplClassicRateMonotonic
  *
- * @brief Create a Period
+ * @brief This source file contains the implementation of
+ *   rtems_rate_monotonic_create().
  */
 
 /*

cpukit/rtems/src/ratemondelete.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Delete Rate Monotonic
+ * @ingroup RTEMSImplClassicRateMonotonic
- *  @ingroup ClassicRateMon
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_rate_monotonic_delete().
  */
 
 /*

cpukit/rtems/src/ratemongetstatistics.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Rate Monotonic Get Statistics
+ * @ingroup RTEMSImplClassicRateMonotonic
- *  @ingroup ClassicRateMon
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_rate_monotonic_get_statistics().
  */
 
 /*

cpukit/rtems/src/ratemongetstatus.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Rate Monotonic Get Status
+ * @ingroup RTEMSImplClassicRateMonotonic
- *  @ingroup ClassicRateMon
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_rate_monotonic_get_status().
  */
 
 /*

cpukit/rtems/src/ratemonident.c

@@ -5,7 +5,8 @@
  *
  * @ingroup RTEMSImplClassicRateMonotonic
  *
- * @brief rtems_rate_monotonic_ident() Implementation
+ * @brief This source file contains the implementation of
+ *   rtems_rate_monotonic_ident().
  */
 
 /*

cpukit/rtems/src/ratemonperiod.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Rate Monotonic Support
+ * @ingroup RTEMSImplClassicRateMonotonic
- *  @ingroup ClassicRateMon
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_rate_monotonic_period_states().
  */
 
 /*

cpukit/rtems/src/ratemonreportstatistics.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Report Rate Monotonic Statistics
+ * @ingroup RTEMSImplClassicRateMonotonic
- *  @ingroup ClassicRateMon
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_rate_monotonic_report_statistics_with_plugin().
  */
 
 /*

cpukit/rtems/src/ratemonresetall.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicRateMon Rate Monotonic Scheduler
+ * @ingroup RTEMSImplClassicRateMonotonic
  *
- * @brief rtems_rate_monotonic_reset_all_statistics
+ * @brief This source file contains the implementation of
+ *   rtems_rate_monotonic_reset_all_statistics().
  */
 
 /*

cpukit/rtems/src/ratemonresetstatistics.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicRateMon Rate Monotonic Scheduler
+ * @ingroup RTEMSImplClassicRateMonotonic
  *
- * @brief RTEMS Rate Monotonic Reset Statistics
+ * @brief This source file contains the implementation of
+ *   rtems_rate_monotonic_reset_statistics().
  */
 
 /*

cpukit/rtems/src/ratemontimeout.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Rate Monotonic Timeout
+ * @ingroup RTEMSImplClassicRateMonotonic
- *  @ingroup ClassicRateMon
+ *
+ * @brief This source file contains the implementation of
+ *   _Rate_monotonic_Timeout().
  */
 
 /*

cpukit/rtems/src/region.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicRegion
+ * @ingroup RTEMSImplClassicRegion
  *
- * @brief Classic Region Information with Zero Objects
+ * @brief This source file contains a definition of the ::_Region_Information
+ *   with zero objects.
  */
 
 /*

cpukit/rtems/src/regioncreate.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicRegion Regions
+ * @ingroup RTEMSImplClassicRegion
  *
- * @brief rtems_region_create
+ * @brief This source file contains the implementation of
+ *   rtems_region_create() and the Region Manager system initialization.
  */
 
 /*

cpukit/rtems/src/regiondelete.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Delete Region
+ * @ingroup RTEMSImplClassicRegion
- *  @ingroup ClassicRegion
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_region_delete().
  */
 
 /*

cpukit/rtems/src/regionextend.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Extend Region
+ * @ingroup RTEMSImplClassicRegion
- *  @ingroup ClassicRegion
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_region_extend().
  */
 
 /*

cpukit/rtems/src/regiongetfreeinfo.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Get Region Free Information
+ * @ingroup RTEMSImplClassicRegion
- *  @ingroup ClassicRegion
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_region_get_free_information().
  */
 
 /*

cpukit/rtems/src/regiongetinfo.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Get Region Information
+ * @ingroup RTEMSImplClassicRegion
- *  @ingroup ClassicRegion
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_region_get_information().
  */
 
 /*

cpukit/rtems/src/regiongetsegment.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Get Region Segment
+ * @ingroup RTEMSImplClassicRegion
- *  @ingroup ClassicRegion
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_region_get_segment().
  */
 
 /*

cpukit/rtems/src/regiongetsegmentsize.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Get Region Segment Size
+ * @ingroup RTEMSImplClassicRegion
- *  @ingroup ClassicRegion
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_region_get_segment_size().
  */
 
 /*

cpukit/rtems/src/regionident.c

@@ -5,7 +5,8 @@
  *
  * @ingroup RTEMSImplClassicRegion
  *
- * @brief rtems_region_ident() Implementation
+ * @brief This source file contains the implementation of
+ *   rtems_region_ident().
  */
 
 /*

cpukit/rtems/src/regionprocessqueue.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Process Region Queue
+ * @ingroup RTEMSImplClassicRegion
- *  @ingroup ClassicRegion
+ *
+ * @brief This source file contains the implementation of
+ *   _Region_Process_queue().
  */
 
 /*

cpukit/rtems/src/regionresizesegment.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Resize RTEMS Region Segment
+ * @ingroup RTEMSImplClassicRegion
- *  @ingroup ClassicRegion
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_region_resize_segment().
  */
 
 /*

cpukit/rtems/src/regionreturnsegment.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief RTEMS Return Region Segment
+ * @ingroup RTEMSImplClassicRegion
- *  @ingroup ClassicRegion
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_region_return_segment().
  */
 
 /*

cpukit/rtems/src/rtemsbuildid.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicClassInfo Object Class Information
+ * @ingroup RTEMSImplClassicObject
  *
- * @brief Build Object Id
+ * @brief This source file contains the implementation of
+ *   rtems_build_id() as a binding for languages other than C/C++.
  */
 
 /*

cpukit/rtems/src/rtemsbuildname.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Build Thirty-Two Bit Object Name
+ * @ingroup RTEMSImplClassicObject
- *  @ingroup ClassicClassInfo
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_build_name() as a binding for languages other than C/C++.
  */
 
 /*

cpukit/rtems/src/rtemsmaxprio.c

@@ -2,6 +2,9 @@
  * @file
  *
  * @ingroup RTEMSImplClassicTask
+ *
+ * @brief This source file contains the implementation of
+ *   _RTEMS_Maximum_priority().
  */
 
 /*

cpukit/rtems/src/rtemsnametoid.c

@@ -5,7 +5,8 @@
  *
  * @ingroup RTEMSImplClassicObject
  *
- * @brief _RTEMS_Name_to_id() Implementation
+ * @brief This source file contains the implementation of
+ *   _RTEMS_Name_to_id().
  */
 
 /*

cpukit/rtems/src/rtemsobjectapimaximumclass.c

@@ -1,8 +1,10 @@
 /**
- *  @file
+ * @file
  *
- *  @brief Get Highest Valid Class Value
+ * @ingroup RTEMSImplClassicObject
- *  @ingroup ClassicClassInfo
+ *
+ * @brief This source file contains the implementation of
+ *   rtems_object_api_maximum_class().
  */
 
 /*

cpukit/rtems/src/rtemsobjectapiminimumclass.c

@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @ingroup ClassicClassInfo Object Class Information
+ * @ingroup RTEMSImplClassicObject
  *
- * @brief Get Lowest Valid Class Value
+ * @brief This source file contains the implementation of
+ *   rtems_object_api_minimum_class().
  */
 
 /*