bsps: Adjust bsp.h Doxygen groups

Update #3706.

6 files changed, 101 insertions, 18 deletions

diff --git a/bsps/mips/csb350/include/bsp.h b/bsps/mips/csb350/include/bsp.h
index ed503a1faa..df39b02150 100644
--- a/bsps/mips/csb350/include/bsp.h
+++ b/bsps/mips/csb350/include/bsp.h
@@ -1,8 +1,9 @@
 /**
- *  @file
- *  
- *  This include file contains some definitions specific to the
- *  Cogent CSB350 Board.
+ * @file
+ *
+ * @ingroup RTEMSBSPsMIPSCSB350
+ *
+ * @brief Global BSP definitions.
  */
 
 /*
@@ -17,6 +18,16 @@
 #ifndef LIBBSP_MIPS_CSB350_BSP_H
 #define LIBBSP_MIPS_CSB350_BSP_H
 
+/**
+ * @defgroup RTEMSBSPsMIPSCSB350 CSB350
+ *
+ * @ingroup RTEMSBSPsMIPS
+ *
+ * @brief CSB350 Board Support Package.
+ *
+ * @{
+ */
+
 #include <bspopts.h>
 #include <bsp/default-initial-extension.h>
 
@@ -44,4 +55,6 @@ int rtems_au1x00_emac_attach(struct rtems_bsdnet_ifconfig *config,
 }
 #endif
 
+/** @} */
+
 #endif
diff --git a/bsps/mips/hurricane/include/bsp.h b/bsps/mips/hurricane/include/bsp.h
index 1c9dc652f0..02fd04d8de 100644
--- a/bsps/mips/hurricane/include/bsp.h
+++ b/bsps/mips/hurricane/include/bsp.h
@@ -1,5 +1,9 @@
 /**
- *  @file
+ * @file
+ *
+ * @ingroup RTEMSBSPsMIPSHurricane
+ *
+ * @brief Global BSP definitions.
  */
 
 /*
@@ -14,6 +18,16 @@
 #ifndef LIBBSP_MIPS_HURRICANE_BSP_H
 #define LIBBSP_MIPS_HURRICANE_BSP_H
 
+/**
+ * @defgroup RTEMSBSPsMIPSHurricane Hurricane
+ *
+ * @ingroup RTEMSBSPsMIPS
+ *
+ * @brief Hurricane Board Support Package.
+ *
+ * @{
+ */
+
 #ifndef ASM
 
 #include <bspopts.h>
@@ -76,4 +90,6 @@ void resettlb(int i);
 
 #endif /* !ASM */
 
+/** @} */
+
 #endif	/* __HURRICANE_BSP_h */
diff --git a/bsps/mips/jmr3904/include/bsp.h b/bsps/mips/jmr3904/include/bsp.h
index 52696b3987..99ca25582a 100644
--- a/bsps/mips/jmr3904/include/bsp.h
+++ b/bsps/mips/jmr3904/include/bsp.h
@@ -1,8 +1,9 @@
 /**
- *  @file
- *  
- *  This include file contains some definitions specific to the
- *  JMR3904 simulator in gdb.
+ * @file
+ *
+ * @ingroup RTEMSBSPsMIPSJMR3904
+ *
+ * @brief Global BSP definitions.
  */
 
 /*
@@ -17,6 +18,16 @@
 #ifndef LIBBSP_MIPS_JMR3904_BSP_H
 #define LIBBSP_MIPS_JMR3904_BSP_H
 
+/**
+ * @defgroup RTEMSBSPsMIPSJMR3904 JMR3904
+ *
+ * @ingroup RTEMSBSPsMIPS
+ *
+ * @brief JMR3904 Board Support Package.
+ *
+ * @{
+ */
+
 #include <bspopts.h>
 #include <bsp/default-initial-extension.h>
 
@@ -34,4 +45,6 @@ extern "C" {
 }
 #endif
 
+/** @} */
+
 #endif
diff --git a/bsps/mips/malta/include/bsp.h b/bsps/mips/malta/include/bsp.h
index c1169cd0a4..ae0e2fddc4 100644
--- a/bsps/mips/malta/include/bsp.h
+++ b/bsps/mips/malta/include/bsp.h
@@ -1,8 +1,9 @@
 /**
- *  @file
+ * @file
  *
- *  This include file contains some definitions specific to the
- *  MIPS Malta Board.
+ * @ingroup RTEMSBSPsMIPSMalta
+ *
+ * @brief Global BSP definitions.
  */
 
 /*
@@ -17,6 +18,16 @@
 #ifndef LIBBSP_MIPS_MALTA_BSP_H
 #define LIBBSP_MIPS_MALTA_BSP_H
 
+/**
+ * @defgroup RTEMSBSPsMIPSMalta Malta
+ *
+ * @ingroup RTEMSBSPsMIPS
+ *
+ * @brief Malta Board Support Package.
+ *
+ * @{
+ */
+
 #ifndef ASM
 
 #include <bspopts.h>
@@ -110,4 +121,6 @@ void resettlb(int i);
 
 #endif /* !ASM */
 
+/** @} */
+
 #endif
diff --git a/bsps/mips/rbtx4925/include/bsp.h b/bsps/mips/rbtx4925/include/bsp.h
index ef5d6ef07f..b758f48c90 100644
--- a/bsps/mips/rbtx4925/include/bsp.h
+++ b/bsps/mips/rbtx4925/include/bsp.h
@@ -1,7 +1,9 @@
 /**
- *  @file
- *  
- *  This include file contains some definitions specific to the RBTX4925.
+ * @file
+ *
+ * @ingroup RTEMSBSPsMIPSRBTX4925
+ *
+ * @brief Global BSP definitions.
  */
 
 /*
@@ -16,6 +18,16 @@
 #ifndef LIBBSP_MIPS_RBTX4925_BSP_H
 #define LIBBSP_MIPS_RBTX4925_BSP_H
 
+/**
+ * @defgroup RTEMSBSPsMIPSRBTX4925 RBTX4925
+ *
+ * @ingroup RTEMSBSPsMIPS
+ *
+ * @brief RBTX4925 Board Support Package.
+ *
+ * @{
+ */
+
 #ifndef ASM
 
 #include <bspopts.h>
@@ -43,4 +55,6 @@ void resettlb(int i);
 
 #endif /* !ASM */
 
+/** @} */
+
 #endif
diff --git a/bsps/mips/rbtx4938/include/bsp.h b/bsps/mips/rbtx4938/include/bsp.h
index b57a60f2df..d71e4d4913 100644
--- a/bsps/mips/rbtx4938/include/bsp.h
+++ b/bsps/mips/rbtx4938/include/bsp.h
@@ -1,7 +1,9 @@
 /**
- *  @file
- *  
- *  This include file contains some definitions specific to the RBTX4938.
+ * @file
+ *
+ * @ingroup RTEMSBSPsMIPSRBTX4938
+ *
+ * @brief Global BSP definitions.
  */
 
 /*
@@ -16,6 +18,16 @@
 #ifndef LIBBSP_MIPS_RBTX4938_BSP_H
 #define LIBBSP_MIPS_RBTX4938_BSP_H
 
+/**
+ * @defgroup RTEMSBSPsMIPSRBTX4938 RBTX4938
+ *
+ * @ingroup RTEMSBSPsMIPS
+ *
+ * @brief RBTX4938 Board Support Package.
+ *
+ * @{
+ */
+
 #ifndef ASM
 
 #include <bspopts.h>
@@ -43,4 +55,6 @@ void resettlb(int i);
 
 #endif /* !ASM */
 
+/** @} */
+
 #endif