Doxygen: Adding Doxygen groups to files

53 files changed, 494 insertions, 0 deletions

diff --git a/bsps/shared/rtems-version.c b/bsps/shared/rtems-version.c
index b12504a1c9..258f420dec 100644
--- a/bsps/shared/rtems-version.c
+++ b/bsps/shared/rtems-version.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSAPIClassicVersion
+ *
+ * @brief This header file provides interfaces of the
+ *   RTEMS versions.
+ */
+
 /*
  *  COPYRIGHT (c) 2003, Ralf Corsepius, Ulm, Germany.
  *  COPYRIGHT (c) 2003, On-Line Applications Research Corporation (OAR).
diff --git a/bsps/sparc/include/bsp/gnatcommon.h b/bsps/sparc/include/bsp/gnatcommon.h
index 1a04449293..40e8829bb9 100644
--- a/bsps/sparc/include/bsp/gnatcommon.h
+++ b/bsps/sparc/include/bsp/gnatcommon.h
@@ -1,3 +1,18 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplGnat
+ *
+ * @brief This header file provides interfaces of the
+ *   gnat/rtems interrupts and exception handling.
+ */
+
+/**
+ * @defgroup RTEMSImplGnat GNAT/RTEMS interrupts and exception handling
+ *
+ * @ingroup RTEMSImpl
+ */
+
 #ifndef __GNATCOMMON_H
 #define __GNATCOMMON_H
 
diff --git a/bsps/sparc/include/bsp/gr_leon4_n2x.h b/bsps/sparc/include/bsp/gr_leon4_n2x.h
index 79ea53f953..2ac5dc8373 100644
--- a/bsps/sparc/include/bsp/gr_leon4_n2x.h
+++ b/bsps/sparc/include/bsp/gr_leon4_n2x.h
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This header file provides interfaces of the
+ *   GR-CPCI-LEON4-N2X (NGFP) PCI Peripheral driver
+ */
+
 /*  GR-CPCI-LEON4-N2X (NGFP) PCI Peripheral driver
  *
  *  COPYRIGHT (c) 2013.
diff --git a/bsps/sparc/include/drvmgr/leon2_amba_bus.h b/bsps/sparc/include/drvmgr/leon2_amba_bus.h
index 93e05442af..8f4b7dbbec 100644
--- a/bsps/sparc/include/drvmgr/leon2_amba_bus.h
+++ b/bsps/sparc/include/drvmgr/leon2_amba_bus.h
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON2
+ *
+ * @brief This header file provides interfaces of the
+ *   LEON2 Hardcoded bus driver interface.
+ */
+
 /*  LEON2 Hardcoded bus driver interface.
  *
  *  COPYRIGHT (c) 2008.
diff --git a/bsps/sparc/leon3/clock/ckinit.c b/bsps/sparc/leon3/clock/ckinit.c
index 60ef5d3ab6..1835e4963e 100644
--- a/bsps/sparc/leon3/clock/ckinit.c
+++ b/bsps/sparc/leon3/clock/ckinit.c
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains a definition of
+ *   the Clock Tick Device Driver.
+ */
+
 /*
  *  Clock Tick Device Driver
  *
diff --git a/bsps/sparc/leon3/console/printk_support.c b/bsps/sparc/leon3/console/printk_support.c
index 9e260d2eac..f221110fbf 100644
--- a/bsps/sparc/leon3/console/printk_support.c
+++ b/bsps/sparc/leon3/console/printk_support.c
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains a definition of
+ *   the TTY driver for the serial ports on the LEON.
+ */
+
 /*
  *  This file contains the TTY driver for the serial ports on the LEON.
  *
diff --git a/bsps/sparc/leon3/start/bspstart.c b/bsps/sparc/leon3/start/bspstart.c
index dec92320e1..fd5a698694 100644
--- a/bsps/sparc/leon3/start/bspstart.c
+++ b/bsps/sparc/leon3/start/bspstart.c
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains a definition of
+ *   a set of routines which start the application.
+ */
+
 /*
  *  This set of routines starts the application.  It includes application,
  *  board, and monitor specific initialization and configuration.
diff --git a/bsps/sparc/leon3/start/cache.c b/bsps/sparc/leon3/start/cache.c
index 5049b7f81c..d605679d33 100644
--- a/bsps/sparc/leon3/start/cache.c
+++ b/bsps/sparc/leon3/start/cache.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains a definition of
+ *   LEON3 CPU cache support.
+ */
+
 /*
  * Copyright (c) 2014 embedded brains GmbH & Co. KG
  *
diff --git a/bsps/sparc/leon3/start/cpucounter.c b/bsps/sparc/leon3/start/cpucounter.c
index 6af91f75e5..3931edeacf 100644
--- a/bsps/sparc/leon3/start/cpucounter.c
+++ b/bsps/sparc/leon3/start/cpucounter.c
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains a definition of
+ *   LEON3 CPU counter support.
+ */
+
 /*
  * Copyright (C) 2014, 2018 embedded brains GmbH & Co. KG
  *
diff --git a/bsps/sparc/leon3/start/eirq.c b/bsps/sparc/leon3/start/eirq.c
index 05e6789f69..fa2ae39a44 100644
--- a/bsps/sparc/leon3/start/eirq.c
+++ b/bsps/sparc/leon3/start/eirq.c
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains a definition of
+ *   the GRLIB/LEON3 extended interrupt controller.
+ */
+
 /*
  *  GRLIB/LEON3 extended interrupt controller
  *
diff --git a/bsps/sparc/shared/irq/bsp_isr_handler.c b/bsps/sparc/shared/irq/bsp_isr_handler.c
index 54e82b15a4..8e27e17bd8 100644
--- a/bsps/sparc/shared/irq/bsp_isr_handler.c
+++ b/bsps/sparc/shared/irq/bsp_isr_handler.c
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This source file contains a definition of
+ *   ::_SPARC_Interrupt_dispatch.
+ */
+
 /*
  *  COPYRIGHT (c) 2015
  *  Cobham Gaisler
diff --git a/cpukit/include/machine/_timecounter.h b/cpukit/include/machine/_timecounter.h
index 127e5f6fd3..e20e051f84 100644
--- a/cpukit/include/machine/_timecounter.h
+++ b/cpukit/include/machine/_timecounter.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSScoreTimecounter
+ *
  * @brief This header file provides timecounter definitions for the kernel space
  *   (_KERNEL is defined before including <sys/time.h>) and RTEMS.
  */
diff --git a/cpukit/include/rtems/linkersets.h b/cpukit/include/rtems/linkersets.h
index ef1b0d38d4..36398d0804 100644
--- a/cpukit/include/rtems/linkersets.h
+++ b/cpukit/include/rtems/linkersets.h
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplLinker
+ *
+ * @brief This header file provides interfaces of the
+ *   linker set support.
+ */
+
 /*
  * Copyright (C) 2015, 2020 embedded brains GmbH & Co. KG
  *
@@ -25,6 +34,12 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/**
+ * @defgroup RTEMSImplLinker RTEMS linker control
+ *
+ * @ingroup RTEMSImpl
+ */
+
 #ifndef _RTEMS_LINKERSET_H
 #define _RTEMS_LINKERSET_H
 
diff --git a/cpukit/include/rtems/posix/posixapi.h b/cpukit/include/rtems/posix/posixapi.h
index 24c1dc51e0..bb966920dc 100644
--- a/cpukit/include/rtems/posix/posixapi.h
+++ b/cpukit/include/rtems/posix/posixapi.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup POSIXAPI
+ *
  * @brief POSIX API Implementation
  *
  * This include file defines the top level interface to the POSIX API
diff --git a/cpukit/include/rtems/posix/spinlockimpl.h b/cpukit/include/rtems/posix/spinlockimpl.h
index 855e57cc14..670c15a4c7 100644
--- a/cpukit/include/rtems/posix/spinlockimpl.h
+++ b/cpukit/include/rtems/posix/spinlockimpl.h
@@ -2,6 +2,8 @@
 
 /**
  * @file
+ *
+ * @ingroup RTEMSPOSIXAPISpinlock
  * 
  * @brief Inlined Routines from the POSIX Spinlock Manager
  *
@@ -37,6 +39,12 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/**
+ * @defgroup RTEMSPOSIXAPISpinlock POSIX Spinlock Manager
+ *
+ * @ingroup POSIXAPI
+ */
+
 #ifndef _RTEMS_POSIX_SPINLOCKIMPL_H
 #define _RTEMS_POSIX_SPINLOCKIMPL_H
 
diff --git a/cpukit/include/rtems/rtems/mainpage.h b/cpukit/include/rtems/rtems/mainpage.h
index d284429d20..02ee514b40 100644
--- a/cpukit/include/rtems/rtems/mainpage.h
+++ b/cpukit/include/rtems/rtems/mainpage.h
@@ -9,6 +9,12 @@
  *   Doxygen.
  */
 
+/**
+ * @defgroup RTEMSImplDoxygen Doxygen document generator support
+ *
+ * @ingroup RTEMSImpl
+ */
+
 /*
  * Copyright (C) 2021 embedded brains GmbH & Co. KG
  *
diff --git a/cpukit/include/rtems/sysinit.h b/cpukit/include/rtems/sysinit.h
index b973ecfc91..1099f3c972 100644
--- a/cpukit/include/rtems/sysinit.h
+++ b/cpukit/include/rtems/sysinit.h
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSAPIClassicInit
+ *
+ * @brief This header file provides interfaces of the
+ *   system initialization handler.
+ */
+
 /*
  * Copyright (C) 2015, 2020 embedded brains GmbH & Co. KG
  *
diff --git a/cpukit/include/rtems/test-info.h b/cpukit/include/rtems/test-info.h
index 055ed4f25b..c1b41ccc6e 100644
--- a/cpukit/include/rtems/test-info.h
+++ b/cpukit/include/rtems/test-info.h
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSTestFramework
+ *
+ * @brief This header file provides interfaces of the
+ *   RTEMS Test Framework.
+ */
+
 /*
  * Copyright (C) 2014, 2018 embedded brains GmbH & Co. KG
  *
diff --git a/cpukit/include/rtems/test.h b/cpukit/include/rtems/test.h
index 79313343a0..85cf7f49f1 100644
--- a/cpukit/include/rtems/test.h
+++ b/cpukit/include/rtems/test.h
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSTestFramework
+ *
+ * @brief This header file provides interfaces of the
+ *   RTEMS Test Framework.
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/include/rtems/thread.h b/cpukit/include/rtems/thread.h
index 739744b4e0..6d0445a6f8 100644
--- a/cpukit/include/rtems/thread.h
+++ b/cpukit/include/rtems/thread.h
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplThread
+ *
+ * @brief This header file provides interfaces of the
+ *   Thread Handler.
+ */
+
 /*
  * Copyright (c) 2017 embedded brains GmbH & Co. KG
  *
@@ -25,6 +34,12 @@
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
+/**
+ * @defgroup RTEMSImplThread Thread Handler
+ *
+ * @ingroup RTEMSImpl
+ */
+
 #ifndef _RTEMS_THREAD_H
 #define _RTEMS_THREAD_H
 
diff --git a/cpukit/include/sys/_ffcounter.h b/cpukit/include/sys/_ffcounter.h
index d83c48cd44..c9cb9f6cda 100644
--- a/cpukit/include/sys/_ffcounter.h
+++ b/cpukit/include/sys/_ffcounter.h
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplSysTimer
+ *
+ * @brief This header file provides interfaces of the
+ *   feed-forward clock counter.
+ */
+
 /*-
  * Copyright (c) 2011 The University of Melbourne
  * All rights reserved.
diff --git a/cpukit/include/sys/endian.h b/cpukit/include/sys/endian.h
index 0849a6a90b..d0037f2984 100644
--- a/cpukit/include/sys/endian.h
+++ b/cpukit/include/sys/endian.h
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplSysEndian
+ *
+ * @brief This header file provides interfaces of the
+ *   system endianness.
+ */
+
 /*-
  * Copyright (c) 2002 Thomas Moestl <tmm@FreeBSD.org>
  * All rights reserved.
@@ -26,6 +35,12 @@
  * $FreeBSD: head/sys/sys/endian.h 208331 2010-05-20 06:16:13Z phk $
  */
 
+/**
+ * @defgroup RTEMSImplSysEndian System Endianness Support
+ *
+ * @ingroup RTEMSImpl
+ */
+
 #ifndef _SYS_ENDIAN_H_
 #define _SYS_ENDIAN_H_
 
diff --git a/cpukit/include/sys/priority.h b/cpukit/include/sys/priority.h
index 855edb63c2..f7c930eb6b 100644
--- a/cpukit/include/sys/priority.h
+++ b/cpukit/include/sys/priority.h
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup libcsupport
+ *
+ * @brief This header file provides interfaces of the
+ *   Process priority specifications.
+ */
+
 /*-
  * SPDX-License-Identifier: BSD-4-Clause
  *
diff --git a/cpukit/include/sys/statvfs.h b/cpukit/include/sys/statvfs.h
index 52d8e9d3fa..062d66ce02 100644
--- a/cpukit/include/sys/statvfs.h
+++ b/cpukit/include/sys/statvfs.h
@@ -3,6 +3,8 @@
 /**
  * @file
  *
+ * @ingroup RTEMSAPIStatvfs
+ *
  * @brief Interface to the statvfs() Set of API Methods
  *
  * This include file defines the interface to the statvfs() set of
@@ -39,6 +41,12 @@
 /*
  */
 
+/**
+ * @defgroup RTEMSAPIStatvfs statvfs API Methods
+ *
+ * @ingroup RTEMSAPI
+ */
+
 #ifndef _SYS_STATVFS_H_
 #define _SYS_STATVFS_H_
 
diff --git a/cpukit/include/sys/timeffc.h b/cpukit/include/sys/timeffc.h
index c04de97f1d..ac66791012 100644
--- a/cpukit/include/sys/timeffc.h
+++ b/cpukit/include/sys/timeffc.h
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplSysTimer
+ *
+ * @brief This header file provides interfaces of the
+ *   feed-forward clock counter.
+ */
+
 /*-
  * Copyright (c) 2011 The University of Melbourne
  * All rights reserved.
diff --git a/cpukit/include/sys/timepps.h b/cpukit/include/sys/timepps.h
index 030c734477..96b695d907 100644
--- a/cpukit/include/sys/timepps.h
+++ b/cpukit/include/sys/timepps.h
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplSysTimer
+ *
+ * @brief This header file provides interfaces of the
+ *   Pulse Per Second timing.
+ */
+
 /*-
  * ----------------------------------------------------------------------------
  * "THE BEER-WARE LICENSE" (Revision 42):
diff --git a/cpukit/include/sys/timetc.h b/cpukit/include/sys/timetc.h
index 1ef58b378d..551fc998e5 100644
--- a/cpukit/include/sys/timetc.h
+++ b/cpukit/include/sys/timetc.h
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplSysTimer
+ *
+ * @brief This header file provides interfaces of the
+ *   binary timecounter.
+ */
+
 /*-
  * ----------------------------------------------------------------------------
  * "THE BEER-WARE LICENSE" (Revision 42):
diff --git a/cpukit/include/sys/timex.h b/cpukit/include/sys/timex.h
index 8e763bb30f..049b29c998 100644
--- a/cpukit/include/sys/timex.h
+++ b/cpukit/include/sys/timex.h
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplSysTimer
+ *
+ * @brief This header file provides interfaces of the
+ *   Network Time Protocol (NTP)
+ */
+
 /*-
  ***********************************************************************
  *								       *
@@ -32,6 +41,12 @@
  *
  */
 
+/**
+ * @defgroup RTEMSImplSysTimer System Timer Support
+ *
+ * @ingroup RTEMSImpl
+ */
+
 #ifndef _SYS_TIMEX_H_
 #define _SYS_TIMEX_H_ 1
 
diff --git a/cpukit/libc/search/qsort.c b/cpukit/libc/search/qsort.c
index b53400aa8e..6d93f6fb38 100644
--- a/cpukit/libc/search/qsort.c
+++ b/cpukit/libc/search/qsort.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup libcsupport
+ *
+ * @brief This source file contains a definition of
+ *   C lib functions.
+ */
+
 /*
 FUNCTION
 <<qsort>>---sort an array
diff --git a/cpukit/libc/string/explicit_bzero.c b/cpukit/libc/string/explicit_bzero.c
index 5124df23ca..88e4137838 100644
--- a/cpukit/libc/string/explicit_bzero.c
+++ b/cpukit/libc/string/explicit_bzero.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup libcsupport
+ *
+ * @brief This source file contains a definition of
+ *   C lib functions.
+ */
+
 /*	$OpenBSD: explicit_bzero.c,v 1.2 2014/06/10 04:17:37 deraadt Exp $ */
 /*
  * Public domain.
diff --git a/cpukit/libc/string/flsl.c b/cpukit/libc/string/flsl.c
index af6277d1a4..c4080daf94 100644
--- a/cpukit/libc/string/flsl.c
+++ b/cpukit/libc/string/flsl.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup libcsupport
+ *
+ * @brief This source file contains a definition of
+ *   C lib functions.
+ */
+
 /*-
  * Copyright (c) 2017 embedded brains GmbH
  * All rights reserved.
diff --git a/cpukit/libc/string/local.h b/cpukit/libc/string/local.h
index ef7ba3918f..d160c8018b 100644
--- a/cpukit/libc/string/local.h
+++ b/cpukit/libc/string/local.h
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup libcsupport
+ *
+ * @brief This header file provides interfaces of the
+ *   C lib.
+ */
+
 #include <_ansi.h>
 #ifndef __rtems__
 #include <../ctype/local.h>
diff --git a/cpukit/libc/string/memcmp.c b/cpukit/libc/string/memcmp.c
index 342fb9fbc8..4169d0fbf1 100644
--- a/cpukit/libc/string/memcmp.c
+++ b/cpukit/libc/string/memcmp.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup libcsupport
+ *
+ * @brief This source file contains a definition of
+ *   C lib functions.
+ */
+
 /*
 FUNCTION
 	<<memcmp>>---compare two memory areas
diff --git a/cpukit/libc/string/memcpy.c b/cpukit/libc/string/memcpy.c
index 52f716b927..8efb4ba14b 100644
--- a/cpukit/libc/string/memcpy.c
+++ b/cpukit/libc/string/memcpy.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup libcsupport
+ *
+ * @brief This source file contains a definition of
+ *   C lib functions.
+ */
+
 /*
 FUNCTION
         <<memcpy>>---copy memory regions
diff --git a/cpukit/libc/string/memset.c b/cpukit/libc/string/memset.c
index a5ea43ea86..f75c527f65 100644
--- a/cpukit/libc/string/memset.c
+++ b/cpukit/libc/string/memset.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup libcsupport
+ *
+ * @brief This source file contains a definition of
+ *   C lib functions.
+ */
+
 /*
 FUNCTION
 	<<memset>>---set an area of memory
diff --git a/cpukit/libc/string/strchr.c b/cpukit/libc/string/strchr.c
index 96f30be044..1ad6787055 100644
--- a/cpukit/libc/string/strchr.c
+++ b/cpukit/libc/string/strchr.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup libcsupport
+ *
+ * @brief This source file contains a definition of
+ *   C lib functions.
+ */
+
 /*
 FUNCTION
 	<<strchr>>---search for character in string
diff --git a/cpukit/libc/string/strcmp.c b/cpukit/libc/string/strcmp.c
index 894424a690..07930bdd88 100644
--- a/cpukit/libc/string/strcmp.c
+++ b/cpukit/libc/string/strcmp.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup libcsupport
+ *
+ * @brief This source file contains a definition of
+ *   C lib functions.
+ */
+
 /*
 FUNCTION
 	<<strcmp>>---character string compare
diff --git a/cpukit/libc/string/strlen.c b/cpukit/libc/string/strlen.c
index acffa49e14..2b50b8e113 100644
--- a/cpukit/libc/string/strlen.c
+++ b/cpukit/libc/string/strlen.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup libcsupport
+ *
+ * @brief This source file contains a definition of
+ *   C lib functions.
+ */
+
 /*
 FUNCTION
 	<<strlen>>---character string length
diff --git a/cpukit/libc/string/strrchr.c b/cpukit/libc/string/strrchr.c
index 04897e162a..69f7ade6c2 100644
--- a/cpukit/libc/string/strrchr.c
+++ b/cpukit/libc/string/strrchr.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup libcsupport
+ *
+ * @brief This source file contains a definition of
+ *   C lib functions.
+ */
+
 /*
 FUNCTION
 	<<strrchr>>---reverse search for character in string
diff --git a/cpukit/libcsupport/src/malloc_p.h b/cpukit/libcsupport/src/malloc_p.h
index 054afd99b2..00be02ce08 100644
--- a/cpukit/libcsupport/src/malloc_p.h
+++ b/cpukit/libcsupport/src/malloc_p.h
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup libcsupport
+ *
+ * @brief This header file provides interfaces of the
+ *   C lib.
+ */
+
 /*
  *  RTEMS Malloc Family Internal Header
  *
diff --git a/cpukit/libtest/t-test-checks.c b/cpukit/libtest/t-test-checks.c
index 40479a8277..e9c3d2cfb5 100644
--- a/cpukit/libtest/t-test-checks.c
+++ b/cpukit/libtest/t-test-checks.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSTestFramework
+ *
+ * @brief This source file contains a definition of
+ *   RTEMS Test Framework.
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/libtest/t-test-hash-sha256.c b/cpukit/libtest/t-test-hash-sha256.c
index a9aa4df023..93b13d68f4 100644
--- a/cpukit/libtest/t-test-hash-sha256.c
+++ b/cpukit/libtest/t-test-hash-sha256.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSTestFramework
+ *
+ * @brief This source file contains a definition of
+ *   RTEMS Test Framework.
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/libtest/t-test-rtems-context.c b/cpukit/libtest/t-test-rtems-context.c
index 351a29a1ca..6373f32f96 100644
--- a/cpukit/libtest/t-test-rtems-context.c
+++ b/cpukit/libtest/t-test-rtems-context.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSTestFramework
+ *
+ * @brief This source file contains a definition of
+ *   RTEMS Test Framework.
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/libtest/t-test-rtems-measure.c b/cpukit/libtest/t-test-rtems-measure.c
index c165fc8f2a..09eb833fa6 100644
--- a/cpukit/libtest/t-test-rtems-measure.c
+++ b/cpukit/libtest/t-test-rtems-measure.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSTestFramework
+ *
+ * @brief This source file contains a definition of
+ *   RTEMS Test Framework.
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/libtest/t-test-rtems-memory.c b/cpukit/libtest/t-test-rtems-memory.c
index 1d41192f56..3a8f8ccdab 100644
--- a/cpukit/libtest/t-test-rtems-memory.c
+++ b/cpukit/libtest/t-test-rtems-memory.c
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSTestFramework
+ *
+ * @brief This source file contains a definition of
+ *   RTEMS Test Framework.
+ */
+
 /*
  * Copyright (C) 2020 embedded brains GmbH & Co. KG
  *
diff --git a/cpukit/libtest/t-test-rtems.c b/cpukit/libtest/t-test-rtems.c
index 97864c1c76..a8d8ce1060 100644
--- a/cpukit/libtest/t-test-rtems.c
+++ b/cpukit/libtest/t-test-rtems.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSTestFramework
+ *
+ * @brief This source file contains a definition of
+ *   RTEMS Test Framework.
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/libtest/t-test-time.c b/cpukit/libtest/t-test-time.c
index 3f953626a5..8d513c5b44 100644
--- a/cpukit/libtest/t-test-time.c
+++ b/cpukit/libtest/t-test-time.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSTestFramework
+ *
+ * @brief This source file contains a definition of
+ *   RTEMS Test Framework.
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/libtest/t-test.c b/cpukit/libtest/t-test.c
index 4f3bf56142..dd61377b6a 100644
--- a/cpukit/libtest/t-test.c
+++ b/cpukit/libtest/t-test.c
@@ -1,3 +1,12 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSTestFramework
+ *
+ * @brief This source file contains a definition of
+ *   RTEMS Test Framework.
+ */
+
 /*
  * SPDX-License-Identifier: BSD-2-Clause
  *
diff --git a/cpukit/libtest/testbeginend.c b/cpukit/libtest/testbeginend.c
index 91ad6a376b..b69a3da121 100644
--- a/cpukit/libtest/testbeginend.c
+++ b/cpukit/libtest/testbeginend.c
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSTestFramework
+ *
+ * @brief This source file contains a definition of
+ *   RTEMS Test Framework.
+ */
+
 /*
  * Copyright (C) 2014, 2018 embedded brains GmbH & Co. KG
  *
diff --git a/cpukit/sapi/src/cpucounterconverter.c b/cpukit/sapi/src/cpucounterconverter.c
index 4cabdc5e4a..4be591a119 100644
--- a/cpukit/sapi/src/cpucounterconverter.c
+++ b/cpukit/sapi/src/cpucounterconverter.c
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSAPICounter
+ *
+ * @brief This source file contains a definition of
+ *   the Free-Running Counter and Busy Wait Delay API.
+ */
+
 /*
  * Copyright (C) 2014, 2018 embedded brains GmbH & Co. KG
  *
diff --git a/cpukit/score/cpu/no_cpu/cpuidle.c b/cpukit/score/cpu/no_cpu/cpuidle.c
index a6001e73b0..94f52ecb30 100644
--- a/cpukit/score/cpu/no_cpu/cpuidle.c
+++ b/cpukit/score/cpu/no_cpu/cpuidle.c
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreCPU
+ *
+ * @brief This source file contains a definition of
+ *   the ::_CPU_Thread_Idle_body.
+ */
+
 /*
  * Copyright (C) 2013, 2014 embedded brains GmbH & Co. KG
  *
diff --git a/cpukit/score/cpu/sparc/include/libcpu/grlib-tn-0018.h b/cpukit/score/cpu/sparc/include/libcpu/grlib-tn-0018.h
index bb43234128..c0b2e5f888 100644
--- a/cpukit/score/cpu/sparc/include/libcpu/grlib-tn-0018.h
+++ b/cpukit/score/cpu/sparc/include/libcpu/grlib-tn-0018.h
@@ -1,5 +1,14 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSBSPsSPARCLEON3
+ *
+ * @brief This header file provides interfaces of the
+ *   LEON3 TN0018 fix.
+ */
+
 /*
  * Copyright (C) 2020 Cobham Gaisler AB
  *
diff --git a/cpukit/score/cpu/sparc/syscall.h b/cpukit/score/cpu/sparc/syscall.h
index 2f20886840..e7bc95efe3 100644
--- a/cpukit/score/cpu/sparc/syscall.h
+++ b/cpukit/score/cpu/sparc/syscall.h
@@ -1 +1,16 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplSysCall
+ *
+ * @brief This header file provides interfaces of the
+ *   SYS_exit SysCall.
+ */
+
+/**
+ * @defgroup RTEMSImplSysCall SysCall Definition for Assembler Interface
+ *
+ * @ingroup RTEMSImpl
+ */
+
 #define SYS_exit        1