doxygen: Use common syntax for groups

bsps/shared/doxygen.h

@@ -1,8 +1,7 @@
 /**
  * @defgroup RTEMSBSPs Board Support Packages
  *
- * @brief Board Support Packages and Support Modules
- * (BSPs).
+ * @brief This group contains the Board Support Packages (BSPs).
  */
 
 /**
@@ -10,7 +9,8 @@
  *
  * @ingroup RTEMSBSPs
  *
- * @brief Shared Support for Board Support Packages
+ * @brief This group contains the architecture-independent support modules
+ *   shared across all BSPs.
  */
 
 /**
@@ -18,5 +18,5 @@
  *
  * @ingroup RTEMSBSPsShared
  *
- * @brief Console Driver Support for Board Support Packages.
+ * @brief This group contains the console driver support modules.
  */

cpukit/doxygen/top-level-groups.h

@@ -28,13 +28,14 @@
 /**
  * @defgroup RTEMSAPI API
  *
- * @brief API
+ * @brief This group contains the Application Programming Interfaces (APIs) of
+ *   RTEMS.
  */
 
 /**
  * @defgroup RTEMSDeviceDrivers Device Drivers
  *
- * @brief Device Drivers
+ * @brief This group contains the device drivers.
  */
 
 /**
@@ -46,5 +47,5 @@
 /**
  * @defgroup RTEMSTestSuites Test Suites
  *
- * @brief Collection of Test Suites
+ * @brief This group contains the test suites.
  */