bsps: Adjust shared Doxygen groups

Update #3706.

bsps/powerpc/include/bsp/linker-symbols.h

@@ -30,9 +30,9 @@ extern "C" {
 #endif /* __cplusplus */
 
 /**
- * @defgroup powerpc_linker Linker Support
+ * @defgroup RTEMSBSPsPowerPCSharedLinker Linker Support
  *
- * @ingroup powerpc_shared
+ * @ingroup RTEMSBSPsPowerPCShared
  *
  * @brief Linker support.
  *

bsps/powerpc/include/bsp/start.h

@@ -30,9 +30,9 @@ extern "C" {
 #endif /* __cplusplus */
 
 /**
- * @defgroup powerpc_start PowerPC System Start
+ * @defgroup RTEMSBSPsPowerPCSharedStart PowerPC System Start
  *
- * @ingroup powerpc_shared
+ * @ingroup RTEMSBSPsPowerPCShared
  *
  * @brief PowerPC low level start.
  *

bsps/powerpc/include/bsp/tictac.h

@@ -1,7 +1,7 @@
 /**
  * @file
  *
- * @ingroup powerpc_shared
+ * @ingroup RTEMSBSPsPowerPCShared
  *
  * @brief Header file for tic-tac code.
  */

bsps/powerpc/include/bsp/vectors.h

@@ -46,7 +46,7 @@ extern "C" {
 /**
  * @defgroup ppc_exc PowerPC Exceptions
  *
- * @brief XXX
+ * @ingroup RTEMSBSPsPowerPCShared
  *
  * @{
  */
@@ -146,7 +146,7 @@ extern "C" {
 /**
  * @defgroup ppc_exc_frame PowerPC Exception Frame
  *
- * @brief XXX
+ * @ingroup ppc_exc
  *
  * @{
  */
@@ -188,7 +188,7 @@ extern "C" {
 #ifndef ASM
 
 /**
- * @ingroup ppc_exc_frame
+ * @addtogroup ppc_exc_frame
  *
  * @{
  */
@@ -198,7 +198,7 @@ typedef CPU_Exception_frame BSP_Exception_frame;
 /** @} */
 
 /**
- * @ingroup ppc_exc
+ * @addtogroup ppc_exc
  *
  * @{
  */

bsps/powerpc/include/bsp/vmeUniverse.h

@@ -55,7 +55,9 @@
  */
 
 /**
- *  @defgroup shared_vmeuniverse Register definitions
+ *  @defgroup shared_vmeuniverse_reg Register definitions
+ *
+ *  @ingroup shared_vmeuniverse
  *
  *  @brief all registers contents in PCI space are LITTLE ENDIAN
  */

bsps/powerpc/include/libcpu/powerpc-utility.h

@@ -1,7 +1,7 @@
 /**
  * @file
  *
- * @ingroup powerpc_shared
+ * @ingroup RTEMSBSPsPowerPCShared
  *
  * @brief General purpose assembler macros, linker command file support and
  * some inline functions for direct register access.
@@ -25,7 +25,13 @@
  */
 
 /**
- * @defgroup powerpc_shared Shared PowerPC Code
+ * @defgroup RTEMSBSPsPowerPCSharedUtility PowerPC Utility Module
+ *
+ * @ingroup RTEMSBSPsPowerPCShared
+ *
+ * @brief PowerPC Utility Module.
+ *
+ * @{
  */
 
 #ifndef __LIBCPU_POWERPC_UTILITY_H
@@ -1006,4 +1012,6 @@ void ShowBATS(void);
 }
 #endif
 
+/** @} */
+
 #endif /* __LIBCPU_POWERPC_UTILITY_H */

bsps/powerpc/shared/cache/cache.c

@@ -1,7 +1,7 @@
 /**
  * @file
  *
- * #ingroup powerpc_shared
+ * #ingroup RTEMSBSPsPowerPCShared
  *
  * @brief Header file for the Cache Manager PowerPC support.
  */

bsps/powerpc/shared/clock/clock.c

@@ -1,7 +1,7 @@
 /**
  * @file
  *
- * @ingroup powerpc_shared
+ * @ingroup RTEMSBSPsPowerPCShared
  *
  * @brief Source file for a clock driver.
  */

bsps/powerpc/shared/doxygen.h

@@ -6,10 +6,10 @@
  * @brief PowerPC Board Support Packages.
  */
 
- /**
-  *  @defgroup powerpc_shared PowerPC Shared Modules
-  *
-  *  @ingroup bsp_powerpc
-  *
-  *  @brief PowerPc Shared Modules
-  */
+/**
+ * @defgroup RTEMSBSPsPowerPCShared Shared
+ *
+ * @ingroup RTEMSBSPsPowerPC
+ *
+ * @brief Shared Support for PowerPC Board Support Packages.
+ */

bsps/powerpc/shared/exceptions/ppc-code-copy.c

@@ -1,7 +1,7 @@
 /**
  * @file
  *
- * @ingroup powerpc_shared
+ * @ingroup RTEMSBSPsPowerPCShared
  *
  * @brief Code copy implementation.
  */

bsps/powerpc/shared/start/tictac.c

@@ -1,7 +1,7 @@
 /**
  * @file
  *
- * @ingroup powerpc_shared
+ * @ingroup RTEMSBSPsPowerPCShared
  *
  * @brief Source file for tic-tac code.
  */

bsps/powerpc/shared/vme/doxygen.h

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