documentation: unified descriptive text for cpu

cpu/arm_common/include/arm_common.h

@@ -10,7 +10,8 @@
 #define __ARM_COMMON_H
 
 /**
- * @defgroup    arm_common      ARM CPU common
+ * @defgroup    arm_common ARM CPU common
+ * @brief       Common implementations and headers for ARM based micro-controllers
  * @ingroup     cpu
  * @{
  */

cpu/cc430/include/cc430-rtc.h

@@ -16,7 +16,6 @@ See the file LICENSE in the top level directory for more details.
 #include "time.h"
 
 /**
- * @defgroup    cc430_rtc   CC430 Real Time Clock
  * @ingroup     cc430
  */
 

cpu/cortexm_common/doc.txt

@@ -1,40 +1,40 @@
 /**
- * @defgroup    cortexm Cortex-M
+ * @defgroup    cpu_cortexm Cortex-M
  * @brief       ARM Cortex-M specific code
  * @ingroup     cpu
  */
 
 /**
  * @defgroup    CMSIS_Core_FunctionInterface
- * @ingroup     cortexm
+ * @ingroup     cpu_cortexm
  */
 
 /**
  * @defgroup    CMSIS_core_register
- * @ingroup     cortexm
+ * @ingroup     cpu_cortexm
  */
 
 /**
  * @defgroup    CMSIS_glob_defs
- * @ingroup     cortexm
+ * @ingroup     cpu_cortexm
  */
 
 /**
  * @defgroup    CMSIS_MISRA_Exceptions
- * @ingroup     cortexm
+ * @ingroup     cpu_cortexm
  */
 
 /**
  * @defgroup    CMSIS_core_definitions
- * @ingroup     cortexm
+ * @ingroup     cpu_cortexm
  */
 
 /**
  * @defgroup    CMSIS_SIMD_intrinsics
- * @ingroup     cortexm
+ * @ingroup     cpu_cortexm
  */
 
 /**
  * @defgroup    CMSIS_Core_InstructionInterface
- * @ingroup     cortexm
+ * @ingroup     cpu_cortexm
  */

cpu/cortexm_common/include/cpu.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    cpu_cortexm_common ARM Cortex-M common files
- * @ingroup     cpu
- * @brief       Common implementations and headers for Cortex-M family based micro-controllers
+ * @addtogroup  cpu_cortexm
  * @{
  *
  * @file        cpu.h

cpu/lpc1768/include/cmsis.h

@@ -6,6 +6,7 @@
 
 /**
  * @defgroup CMSIS
+ * @brief    Cortex Microcontroller Software Interface Standard
  * @ingroup cpu
  * @{
  *

cpu/lpc1768/include/cpu.h

@@ -3,6 +3,7 @@
 
 /**
  * @defgroup    lpc1768 NXP LPC1768
+ * @brief       NXP LPC1768 specific code
  * @ingroup		cpu
  * @{
  */

cpu/native/include/cpu.h

@@ -1,8 +1,4 @@
-/**
- * Native CPU interface
- *
- * The native CPU uses system calls to simulate hardware access.
- *
+/*
  * Copyright (C) 2013 Ludwig Ortmann <ludwig.ortmann@fu-berlin.de>
  *
  * This file is subject to the terms and conditions of the GNU Lesser General
@@ -12,7 +8,9 @@
 
 /**
  * @ingroup arch
- * @defgroup    native_cpu  Native CPU
+ * @defgroup    native_cpu  Native
+ * @brief       Native CPU specific code
+ * @details     The native CPU uses system calls to simulate hardware access.
  * @ingroup     cpu
  * @brief       CPU abstraction for the native port
  * @{

cpu/sam3x8e/doc.txt

@@ -1,7 +1,7 @@
 /**
  * @defgroup        cpu_sam3x8e Atmel SAM3X8E
  * @ingroup         cpu
- * @brief           Implementation of Atmel's SAM3X8E Cortex-M3 MCU
+ * @brief           Atmel SAM3X8E Cortex-M3 MCU specific code
  */
 
 /**