doxygen: Add Doxygen files to a group

Update #3707.

bsps/arm/altera-cyclone-v/contrib/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines BSP-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsARMCycVContrib Contributed Code
  *

bsps/arm/atsam/contrib/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines BSP-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsARMAtsamContrib Contributed Code
  *

bsps/arm/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines BSP-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsARM ARM
  *

bsps/bfin/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines bfin-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsBfin Blackfin
  *

bsps/i386/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines i386-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsI386 i386
  *

bsps/lm32/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines lm32-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsLM32 LatticeMicro32 (lm32)
  *

bsps/m68k/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines m68k-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsM68k Motorola 68000 and NXP ColdFire (m68k)
  *

bsps/mips/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines mips-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsMIPS MIPS
  *

bsps/moxie/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines moxie-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsMoxie Moxie
  *

bsps/nios2/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines nios2-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsNios2 Nios II (nios2)
  *

bsps/no_cpu/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines no_cpu-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsNoCPU Example
  *

bsps/or1k/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines or1k-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsOR1K OpenRISC 1000 (or1k)
  *

bsps/powerpc/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines powerpc-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsPowerPC PowerPC
  *

bsps/powerpc/shared/vme/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines VME-specific groups.
+ */
+
 /**
  *  @defgroup shared_vmeuniverse VME Universe Modules
  *

bsps/riscv/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines riscv-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsRISCV RISC-V
  *

bsps/sh/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines sh-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsSH SuperH (sh)
  *

bsps/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines BSP-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPs Board Support Packages
  *

bsps/sparc/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines sparc-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsSPARC SPARC
  *

bsps/sparc64/include/arch/mm/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines sparc64-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsSPARC64mm MM
  * 

bsps/sparc64/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines sparc64-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsSPARC64 SPARC64
  *

bsps/v850/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines v850-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsV850 V850
  *

bsps/x86_64/shared/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines x86_64-specific groups.
+ */
+
 /**
  * @defgroup RTEMSBSPsX8664 x86-64
  *

cpukit/doxygen.h

@@ -1,3 +1,11 @@
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines some Doxygen groups.
+ */
+
 /**
  * @defgroup RTEMSAPIIO IO
  *

cpukit/doxygen/appl-config.h

@@ -1,5 +1,13 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file documents the application configuration options.
+ */
+
 /*
  * Copyright (C) 2019, 2023 embedded brains GmbH (http://www.embedded-brains.de)
  * Copyright (C) 2010 Gedare Bloom

cpukit/doxygen/top-level-groups.h

@@ -1,7 +1,15 @@
 /* SPDX-License-Identifier: BSD-2-Clause */
 
+/**
+ * @file
+ *
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This header file defines high level Doxygen groups.
+ */
+
 /*
- * Copyright (C) 2019, 2020 embedded brains GmbH (http://www.embedded-brains.de)
+ * Copyright (C) 2019, 2023 embedded brains GmbH (http://www.embedded-brains.de)
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -44,6 +52,12 @@
  * @brief This group contains the RTEMS implementation components.
  */
 
+/**
+ * @defgroup RTEMSImplDoxygen Doxygen Support
+ *
+ * @ingroup RTEMSImpl
+ */
+
 /**
  * @defgroup RTEMSTestSuites Test Suites
  *

cpukit/include/rtems/rtems/mainpage.h

@@ -3,7 +3,10 @@
 /**
  * @file
  *
- * This file exists to provide a top level description of RTEMS for Doxygen.
+ * @ingroup RTEMSImplDoxygen
+ *
+ * @brief This file exists to provide a top level description of RTEMS for
+ *   Doxygen.
  */
 
 /*