bsps: Adjust architecture Doxygen groups

- Use CamelCase as it is not used in our C code.  Enables simple search and
   replace.

 - Prefix with "RTEMS" to aid deployment and integration.  It aids
   searching and sorting.

Update #3706.
This commit is contained in:
Sebastian Huber
2019-02-26 15:44:50 +01:00
parent a6e39d4a59
commit 212663bede
58 changed files with 175 additions and 157 deletions

View File

@@ -350,7 +350,7 @@ static inline void write_ttbr0(uint32_t bar)
/** /**
* @defgroup arm_beagle Beaglebone, Beagleboard Support * @defgroup arm_beagle Beaglebone, Beagleboard Support
* *
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* *
* @brief Beaglebones and beagleboards support package * @brief Beaglebones and beagleboards support package
* *

View File

@@ -32,7 +32,7 @@ extern "C" {
/** /**
* @defgroup arm_csb336 CSB336 Support * @defgroup arm_csb336 CSB336 Support
* *
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* *
* @brief CSB336 support package. * @brief CSB336 support package.
* *

View File

@@ -31,7 +31,7 @@ extern "C" {
/** /**
* @defgroup arm_csb337 CSB337 Support * @defgroup arm_csb337 CSB337 Support
* *
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* *
* @brief CSB337 support package. * @brief CSB337 support package.
* *

View File

@@ -1,7 +1,5 @@
/** /**
* @defgroup shared_umon SHARED UMON Modules * @defgroup shared_umon SHARED UMON Modules
* *
* @ingroup bsp_shared
*
* @brief SHARED UMON Modules * @brief SHARED UMON Modules
*/ */

View File

@@ -31,7 +31,7 @@ extern "C" {
/** /**
* @defgroup arm_edb7312 EDB7312 Support * @defgroup arm_edb7312 EDB7312 Support
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* @brief EDB7312 Support Package * @brief EDB7312 Support Package
* @{ * @{
*/ */

View File

@@ -32,7 +32,7 @@ extern "C" {
/** /**
* @defgroup arm_gdbarmsim GDBARMSIM Support * @defgroup arm_gdbarmsim GDBARMSIM Support
* *
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* *
* @brief GDBARMSIM support package. * @brief GDBARMSIM support package.
* *

View File

@@ -26,7 +26,7 @@ extern "C" {
/** /**
* @defgroup arm_gumstix Gumstix Support * @defgroup arm_gumstix Gumstix Support
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* @brief Gumstix support package * @brief Gumstix support package
* @{ * @{
*/ */

View File

@@ -46,7 +46,7 @@
/** /**
* @defgroup arm_lm3s69xx LM3S69XX Support * @defgroup arm_lm3s69xx LM3S69XX Support
* *
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* *
* @brief LM3S69XX Support Package * @brief LM3S69XX Support Package
*/ */

View File

@@ -47,7 +47,7 @@ struct rtems_bsdnet_ifconfig;
/** /**
* @defgroup lpc176x LPC176X Support * @defgroup lpc176x LPC176X Support
* *
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* *
* @brief LPC176X support package. * @brief LPC176X support package.
* *

View File

@@ -56,7 +56,7 @@ struct rtems_termios_device_context;
/** /**
* @defgroup lpc24xx LPC24XX Support * @defgroup lpc24xx LPC24XX Support
* *
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* *
* @brief LPC24XX support package. * @brief LPC24XX support package.
* *

View File

@@ -43,7 +43,7 @@ struct rtems_bsdnet_ifconfig;
/** /**
* @defgroup arm_lpc32xx LPC32XX Support * @defgroup arm_lpc32xx LPC32XX Support
* *
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* *
* @brief LPC32XX support package. * @brief LPC32XX support package.
* *

View File

@@ -62,7 +62,7 @@ void rpi_start_rtems_on_secondary_processor(void);
/** /**
* @defgroup arm_raspberrypi Raspberry Pi Support * @defgroup arm_raspberrypi Raspberry Pi Support
* *
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* *
* @brief Raspberry Pi support package * @brief Raspberry Pi support package
* *

View File

@@ -60,7 +60,7 @@ extern "C" {
/** /**
* @defgroup arm_realview-pbx-a9 Realview PBX-A9 * @defgroup arm_realview-pbx-a9 Realview PBX-A9
* *
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* *
* @brief Realview PBX-A9 support package * @brief Realview PBX-A9 support package
* *

View File

@@ -21,7 +21,7 @@
/** /**
* @defgroup arm_rtl22xx RTL22XX Support * @defgroup arm_rtl22xx RTL22XX Support
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* @brief RTL22XX Support Package * @brief RTL22XX Support Package
* @{ * @{
*/ */

View File

@@ -1,15 +1,15 @@
/** /**
* @defgroup bsp_arm ARM * @defgroup RTEMSBSPsARM ARM
* *
* @ingroup bsp_kit * @ingroup RTEMSBSPs
* *
* @brief ARM Board Support Packages * @brief ARM Board Support Packages.
*/ */
/** /**
* @defgroup arm_shared ARM Shared Modules * @defgroup arm_shared ARM Shared Modules
* *
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* *
* @brief ARM Shared Modules * @brief ARM Shared Modules
*/ */

View File

@@ -20,7 +20,7 @@
/** /**
* @defgroup arm_stm32f4 STM32F4 Support * @defgroup arm_stm32f4 STM32F4 Support
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* @brief STM32f4 Support Package * @brief STM32f4 Support Package
* @{ * @{
*/ */

View File

@@ -38,7 +38,7 @@ extern "C" {
/** /**
* @defgroup arm_zynq Xilinx-Zynq Support * @defgroup arm_zynq Xilinx-Zynq Support
* @ingroup bsp_arm * @ingroup RTEMSBSPsARM
* @brief Xilinz-Zynq Board Support Package * @brief Xilinz-Zynq Board Support Package
* @{ * @{
*/ */

View File

@@ -33,7 +33,7 @@ extern "C" {
/** /**
* @defgroup bfin_tll6527m TLL6527M Support * @defgroup bfin_tll6527m TLL6527M Support
* @ingroup bsp_bfin * @ingroup RTEMSBSPsBfin
* @brief TLL6527M Support Package * @brief TLL6527M Support Package
* @{ * @{
*/ */

View File

@@ -38,7 +38,7 @@ extern "C" {
/** /**
* @defgroup bfin_ezkit533 eZKit533 Support * @defgroup bfin_ezkit533 eZKit533 Support
* @ingroup bsp_bfin * @ingroup RTEMSBSPsBfin
* @brief eZKit533 Board Support Package * @brief eZKit533 Board Support Package
* @{ * @{
*/ */

View File

@@ -1,11 +1,7 @@
/** /**
* @defgroup bsp_bfin Blackfin * @defgroup RTEMSBSPsBfin Blackfin
* @ingroup bsp_kit *
* @brief Blackfin Board Support Packages * @ingroup RTEMSBSPs
*/ *
* @brief Blackfin Board Support Packages.
/**
* @defgroup bfin_shared Blackfin Shared Modules
* @ingroup bsp_bfin
* @brief Blackfin Shared Modules
*/ */

View File

@@ -0,0 +1,7 @@
/**
* @defgroup RTEMSBSPsEpiphany Epiphany
*
* @ingroup RTEMSBSPs
*
* @brief Epiphany Board Support Packages.
*/

View File

@@ -62,9 +62,9 @@ extern "C" {
#endif #endif
/** /**
* @degroup pc386_i386 PC386 Support * @degroup i386_pc386 PC386 Support
* *
* @ingroup bsp_i386 * @ingroup RTEMSBSPsI386
* *
* @brief PC386 support. * @brief PC386 support.
*/ */

View File

@@ -1,7 +1,9 @@
/** /**
* @defgroup bsp_i386 i386 * @defgroup RTEMSBSPsI386 i386
* @ingroup bsp_kit *
* @brief i386 Board Support Packages * @ingroup RTEMSBSPs
*
* @brief i386 Board Support Packages.
*/ */
/** /**

View File

@@ -1,9 +1,7 @@
/** /**
* @file * @file
* *
* @ingroup bsp_bootcard * @ingroup RTEMSBSPsSharedStartup
*
* @brief Standard system startup.
*/ */
/* /*
@@ -37,9 +35,9 @@ extern "C" {
#endif /* __cplusplus */ #endif /* __cplusplus */
/** /**
* @defgroup shared_bootcard Bootcard * @defgroup RTEMSBSPsSharedStartup Bootcard
* *
* @ingroup bsp_shared * @ingroup RTEMSBSPsShared
* *
* @brief Standard system startup. * @brief Standard system startup.
* *

View File

@@ -110,7 +110,7 @@ static inline rtems_vector_number bsp_interrupt_handler_index(
/** /**
* @defgroup bsp_interrupt BSP Interrupt Support * @defgroup bsp_interrupt BSP Interrupt Support
* *
* @ingroup bsp_shared * @ingroup RTEMSBSPsShared
* *
* @brief Generic BSP Interrupt Support * @brief Generic BSP Interrupt Support
* *

View File

@@ -33,7 +33,7 @@ extern "C" {
/** /**
* @defgroup bsp_stack Task Stack Allocator * @defgroup bsp_stack Task Stack Allocator
* *
* @ingroup bsp_shared * @ingroup RTEMSBSPsShared
* *
* @brief Task stack initialization, allocation and free functions. * @brief Task stack initialization, allocation and free functions.
* *

View File

@@ -30,7 +30,7 @@
/** /**
* @defgroup lm32_evr EVR Support * @defgroup lm32_evr EVR Support
* *
* @ingroup bsp_lm32 * @ingroup RTEMSBSPsLM32
* *
* @brief EVR support package. * @brief EVR support package.
*/ */

View File

@@ -29,7 +29,7 @@
/** /**
* @defgroup lm32_milkymist Milkymist Support * @defgroup lm32_milkymist Milkymist Support
* *
* @ingroup bsp_lm32 * @ingroup RTEMSBSPsLM32
* *
* @brief Milkymist support package. * @brief Milkymist support package.
*/ */

View File

@@ -1,15 +1,15 @@
/** /**
* @defgroup bsp_lm32 Lattice Mico32 * @defgroup RTEMSBSPsLM32 LatticeMicro32 (lm32)
* *
* @ingroup bsp_kit * @ingroup RTEMSBSPs
* *
* @brief Lattice Mico32 Board Support Packages * @brief LatticeMicro32 Board Support Packages.
*/ */
/** /**
* @defgroup lm32_shared Lattice Mico32 Shared Modules * @defgroup lm32_shared Lattice Mico32 Shared Modules
* *
* @ingroup bsp_lm32 * @ingroup RTEMSBSPsLM32
* *
* @brief Lattice Mico32 Shared Modules * @brief Lattice Mico32 Shared Modules
*/ */

View File

@@ -13,7 +13,7 @@
/** /**
* @defgroup m68k_av5282 AV5282 Support * @defgroup m68k_av5282 AV5282 Support
* *
* @ingroup bsp_m68k * @ingroup RTEMSBSPsM68k
* *
* @brief AV5282 support. * @brief AV5282 support.
*/ */

View File

@@ -31,7 +31,7 @@
/** /**
* @defgroup m68k_csb360 CSB360 Support * @defgroup m68k_csb360 CSB360 Support
* *
* @ingroup bsp_m68k * @ingroup RTEMSBSPsM68k
* *
* @brief CSB360 support. * @brief CSB360 support.
*/ */

View File

@@ -40,7 +40,7 @@ extern "C" {
/** /**
* @defgroup m68k_gen68340 Motorola MC68340 Support * @defgroup m68k_gen68340 Motorola MC68340 Support
* *
* @ingroup bsp_m68k * @ingroup RTEMSBSPsM68k
* *
* @brief Motorola MC68340 support. * @brief Motorola MC68340 support.
*/ */

View File

@@ -1,15 +0,0 @@
/**
* @defgroup bsp_m68k M68K
*
* @ingroup bsp_kit
*
* @brief M68K Board Support Packages
*/
/**
* @defgroup m68k_gen68360 M68K GEN68360 Modules
*
* @ingroup bsp_m68k
*
* @brief M68K GEN68360 Modules
*/

View File

@@ -60,7 +60,7 @@
/** /**
* @defgroup m68k_genmcf548x MCF548X Support * @defgroup m68k_genmcf548x MCF548X Support
* *
* @ingroup bsp_m68k * @ingroup RTEMSBSPsM68k
* *
* @brief MCT548X support. * @brief MCT548X support.
*/ */

View File

@@ -81,7 +81,7 @@ void Init52235(void);
/** /**
* @defgroup m68k_mcf52235 MCF52235 Support * @defgroup m68k_mcf52235 MCF52235 Support
* *
* @ingroup bsp_m68k * @ingroup RTEMSBSPsM68k
* *
* @brief MCF52235 Support Package * @brief MCF52235 Support Package
*/ */

View File

@@ -1,15 +1,15 @@
/** /**
* @defgroup bsp_m68k M68K * @defgroup RTEMSBSPsM68k Motorola 68000 and NXP ColdFire (m68k)
* *
* @ingroup bsp_kit * @ingroup RTEMSBSPs
* *
* @brief M68K Board Support Packages * @brief Motorola 68000 and NXP ColdFire Board Support Packagess.
*/ */
/** /**
* @defgroup m68k_shared M68K Shared Modules * @defgroup m68k_shared M68K Shared Modules
* *
* @ingroup bsp_m68k * @ingroup RTEMSBSPsM68k
* *
* @brief M68K Shared Modules * @brief M68K Shared Modules
*/ */

View File

@@ -1,11 +1,13 @@
/** /**
* @defgroup bsp_mips MIPS * @defgroup RTEMSBSPsMIPS MIPS
* @ingroup bsp_kit *
* @brief MIPS Board Support Packages * @ingroup RTEMSBSPs
*
* @brief MIPS Board Support Packages.
*/ */
/** /**
* @defgroup mips_shared MIPS Shared Modules * @defgroup mips_shared MIPS Shared Modules
* @ingroup bsp_mips * @ingroup RTEMSBSPsMIPS
* @brief mips Shared Modules * @brief mips Shared Modules
*/ */

View File

@@ -0,0 +1,7 @@
/**
* @defgroup RTEMSBSPsMoxie Moxie
*
* @ingroup RTEMSBSPs
*
* @brief Moxie Board Support Packages.
*/

View File

@@ -0,0 +1,7 @@
/**
* @defgroup RTEMSBSPsNios2 Nios II (nios2)
*
* @ingroup RTEMSBSPs
*
* @brief Nios II Board Support Packages.
*/

View File

@@ -0,0 +1,7 @@
/**
* @defgroup RTEMSBSPsNoCPU Example
*
* @ingroup RTEMSBSPs
*
* @brief Example Board Support Package.
*/

View File

@@ -0,0 +1,7 @@
/**
* @defgroup RTEMSBSPsOR1K OpenRISC 1000 (or1k)
*
* @ingroup RTEMSBSPs
*
* @brief OpenRISC 1000 Board Support Packages.
*/

View File

@@ -57,8 +57,6 @@
/** /**
* @defgroup shared_vmeuniverse Register definitions * @defgroup shared_vmeuniverse Register definitions
* *
* @ingroup bsp_shared
*
* @brief all registers contents in PCI space are LITTLE ENDIAN * @brief all registers contents in PCI space are LITTLE ENDIAN
*/ */

View File

@@ -1,15 +0,0 @@
/**
* @defgroup bsp_powerpc POWERPC
*
* @ingroup bsp_kit
*
* @brief POWERPC Board Support Packages
*/
/**
* @defgroup powerpc_mvme3100 POWERPC MVME3100 Modules
*
* @ingroup bsp_powerpc
*
* @brief POWERPC MVME3100 Modules
*/

View File

@@ -1,9 +1,9 @@
/** /**
* @defgroup bsp_powerpc PowerPC * @defgroup RTEMSBSPsPowerPc PowerPC
* *
* @ingroup bsp_kit * @ingroup RTEMSBSPs
* *
* @brief PowerPC Board Support Packages * @brief PowerPC Board Support Packages.
*/ */
/** /**

View File

@@ -1,7 +1,5 @@
/** /**
* @defgroup shared_vmeuniverse SHARED VMEUNIVERSE Modules * @defgroup shared_vmeuniverse SHARED VMEUNIVERSE Modules
* *
* @ingroup bsp_shared
*
* @brief SHARED VMEUNIVERSE Modules * @brief SHARED VMEUNIVERSE Modules
*/ */

View File

@@ -0,0 +1,7 @@
/**
* @defgroup RTEMSBSPsRISCV RISC-V
*
* @ingroup RTEMSBSPs
*
* @brief RISC-V Board Support Packages.
*/

7
bsps/sh/shared/doxygen.h Normal file
View File

@@ -0,0 +1,7 @@
/**
* @defgroup RTEMSBSPsSH SuperH (sh)
*
* @ingroup RTEMSBSPs
*
* @brief SuperH Board Support Packages.
*/

View File

@@ -32,7 +32,7 @@
/** /**
* @defgroup bsp_clock Clock Support * @defgroup bsp_clock Clock Support
* *
* @ingroup bsp_shared * @ingroup RTEMSBSPsShared
* *
* @brief Clock support * @brief Clock support
* *

View File

@@ -1,15 +1,14 @@
/** /**
* @defgroup bsp_shared SHARED * @defgroup RTEMSBSPs Board Support Packages
* *
* @ingroup bsp_kit * @brief Board Support Packages and Support Modules
* * (BSPs).
* @brief SHARED Board Support Packages
*/ */
/** /**
* @defgroup shared_tod SHARED TOD Modules * @defgroup RTEMSBSPsShared Shared
* *
* @ingroup bsp_shared * @ingroup RTEMSBSPs
* *
* @brief SHARED TOD Modules * @brief Shared Support for Board Support Packages
*/ */

View File

@@ -1,20 +1,7 @@
/** /**
* @file * @file
* *
* @ingroup bsp_bootcard * @ingroup RTEMSBSPsSharedStartup
*
* @brief Standard system startup.
*
* This is the C entry point for ALL RTEMS BSPs. It is invoked
* from the assembly language initialization file usually called
* start.S. It provides the framework for the BSP initialization
* sequence. For the basic flow of initialization see RTEMS C User's Guide,
* Initialization Manager.
*
* This style of initialization ensures that the C++ global
* constructors are executed after RTEMS is initialized.
* Thanks to Chris Johns <cjohns@plessey.com.au> for the idea
* to move C++ global constructors into the first task.
*/ */
/* /*

View File

@@ -1,7 +1,7 @@
/** /**
* @file * @file
* *
* @ingroup bsp_shared * @ingroup bsp_stack
* *
* @brief Stack initialization, allocation and free functions. * @brief Stack initialization, allocation and free functions.
*/ */

View File

@@ -39,7 +39,7 @@ extern "C" {
/** /**
* @defgroup sparc_erc32 ERC32 Support * @defgroup sparc_erc32 ERC32 Support
* *
* @ingroup bsp_sparc * @ingroup RTEMSBSPsSPARC
* *
* @brief ERC32 Support Package * @brief ERC32 Support Package
*/ */

View File

@@ -42,7 +42,7 @@ extern "C" {
/** /**
* @defgroup sparc_leon2 LEON2 Support * @defgroup sparc_leon2 LEON2 Support
* *
* @ingroup bsp_sparc * @ingroup RTEMSBSPsSPARC
* *
* @brief LEON2 Support Package * @brief LEON2 Support Package
* *

View File

@@ -42,7 +42,7 @@ extern "C" {
/** /**
* @defgroup sparc_leon3 LEON3 Support * @defgroup sparc_leon3 LEON3 Support
* *
* @ingroup bsp_sparc * @ingroup RTEMSBSPsSPARC
* *
* @brief LEON3 support package * @brief LEON3 support package
* *

View File

@@ -1,15 +1,15 @@
/** /**
* @defgroup bsp_sparc SPARC * @defgroup RTEMSBSPsSPARC SPARC
* *
* @ingroup bsp_kit * @ingroup RTEMSBSPs
* *
* @brief SPARC Board Support Packages * @brief SPARC Board Support Packages.
*/ */
/** /**
* @defgroup sparc_shared SPARC Shared Modules * @defgroup sparc_shared SPARC Shared Modules
* *
* @ingroup bsp_sparc * @ingroup RTEMSBSPsSPARC
* *
* @brief SPARC Shared Modules * @brief SPARC Shared Modules
*/ */

View File

@@ -0,0 +1,7 @@
/**
* @defgroup RTEMSBSPsSPARC64 SPARC64
*
* @ingroup RTEMSBSPs
*
* @brief SPARC64 Board Support Packages.
*/

View File

@@ -0,0 +1,7 @@
/**
* @defgroup RTEMSBSPsV850 V850
*
* @ingroup RTEMSBSPs
*
* @brief V850 Board Support Packages.
*/

View File

@@ -0,0 +1,7 @@
/**
* @defgroup RTEMSBSPsX8664 x86-64
*
* @ingroup RTEMSBSPs
*
* @brief x86-64 Board Support Packages.
*/