boards: replace @brief with @name when necessary

boards/airfy-beacon/include/board.h

@@ -28,7 +28,7 @@
 #endif
 
 /**
- * @brief   Xtimer configuration
+ * @name    Xtimer configuration
  * @{
  */
 #define XTIMER_DEV                  (0)
@@ -38,7 +38,7 @@
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/airfy-beacon/include/periph_conf.h

@@ -43,7 +43,7 @@
 /** @} */
 
 /**
- * @name Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -57,9 +57,9 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name UART configuration
+ * @name    UART configuration
  *
- * The CPU only supports one UART device, so we keep it simple
+ *          The CPU only supports one UART device, so we keep it simple
  * @{
  */
 #define UART_NUMOF          (1U)
@@ -78,7 +78,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name SPI configuration
+ * @name    SPI configuration
  * @{
  */
 static const spi_conf_t spi_config[] = {
@@ -94,7 +94,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name   I2C (TWI) configuration
+ * @name    I2C (TWI) configuration
  * @{
  */
 static const i2c_conf_t i2c_config[] = {
@@ -116,7 +116,7 @@ static const i2c_conf_t i2c_config[] = {
 /** @} */
 
 /**
- * @name   ADC configuration
+ * @name    ADC configuration
  *
  * The configuration consists simply of a list of channels that should be used
  * @{
@@ -126,7 +126,7 @@ static const i2c_conf_t i2c_config[] = {
 /** @} */
 
 /**
- * @name Radio device configuration
+ * @name    Radio device configuration
  *
  * The radio is not guarded by a NUMOF define, as the radio is selected by its
  * own module in the build system.

boards/arduino-atmega-common/include/board.h

@@ -33,15 +33,17 @@ extern "C" {
 #endif
 
 /**
- * @brief As the CPU is too slow to handle 115200 baud, we set the default
+ * @name    STDIO configuration
- *        baudrate to 9600 for this board
+ *
+ * As the CPU is too slow to handle 115200 baud, we set the default
+ * baudrate to 9600 for this board
  * @{
  */
 #define UART_STDIO_BAUDRATE (9600U)
 /** @} */
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #ifdef CPU_ATMEGA328P
@@ -60,10 +62,11 @@ extern "C" {
 /** @} */
 
 /**
- ** Context swap defines
+ * @brief   Context swap defines
- ** Setup to use PC5 which is pin change interrupt 13 (PCINT13)
+ *
- ** This emulates a software triggered interrupt
+ * Setup to use PC5 which is pin change interrupt 13 (PCINT13)
- ***/
+ * This emulates a software triggered interrupt
+ */
 #ifdef CPU_ATMEGA328P
 #define AVR_CONTEXT_SWAP_INIT do { \
             DDRC |= (1 << PC5); \
@@ -85,7 +88,7 @@ extern "C" {
 #endif
 
 /**
- * @brief xtimer configuration values
+ * @name    xtimer configuration values
  * @{
  */
 #define XTIMER_WIDTH                (16)
@@ -95,7 +98,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/arduino-atmega-common/include/periph_conf.h

@@ -28,14 +28,14 @@ extern "C" {
 #endif
 
 /**
- * @brief   Clock configuration
+ * @name    Clock configuration
  * @{
  */
 #define CLOCK_CORECLOCK     (16000000L)
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  *
  * arduino uno and arduino duemilanove:
  * The timer driver only supports the 16-bit timer (Timer1)
@@ -74,12 +74,10 @@ extern "C" {
 #define TIMER_1_ISRB        TIMER4_COMPB_vect
 #define TIMER_1_ISRC        TIMER4_COMPC_vect
 #endif
-
-
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  *
  * The UART devices have fixed pin mappings, so all we need to do, is to specify
  * which devices we would like to use and their corresponding RX interrupts. See
@@ -112,7 +110,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  *
  * The atmega2560 has only one hardware SPI with fixed pin configuration, so all
  * we can do here, is to enable or disable it...

boards/arduino-due/include/arduino_pinmap.h

@@ -29,7 +29,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Mapping of MCU pins to Arduino pins
+ * @name    Mapping of MCU pins to Arduino pins
  * @{
  */
 #define ARDUINO_PIN_0           GPIO_PIN(PA, 8)

boards/arduino-due/include/sdcard_spi_params.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Set default configuration parameters for the sdcard_spi driver
+ * @name    Default configuration for the sdcard_spi driver
  * @{
  */
 #ifndef SDCARD_SPI_PARAM_SPI
@@ -69,7 +69,6 @@ static const  sdcard_spi_params_t sdcard_spi_params[] = {
         .power_act_high = SDCARD_SPI_PARAM_POWER_AH
     },
 };
-/** @} */
 
 #ifdef __cplusplus
 }

boards/arduino-due/include/w5100_params.h

@@ -24,7 +24,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Set configuration parameters for the W5100 driver
+ * @name    Configuration parameters for the W5100 driver
  * @{
  */
 #ifndef W5100_PARAM_SPI
@@ -52,7 +52,6 @@ static const  w5100_params_t w5100_params[] = {
         .evt = W5100_PARAM_EVT
     },
 };
-/** @} */
 
 #ifdef __cplusplus
 }

boards/arduino-zero/include/arduino_pinmap.h

@@ -29,7 +29,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Mapping of MCU pins to Arduino pins
+ * @name    Mapping of MCU pins to Arduino pins
  * @{
  */
 #define ARDUINO_PIN_0           GPIO_PIN(PA, 11)

boards/arduino-zero/include/board.h

@@ -32,7 +32,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   xtimer configuration
+ * @name    xtimer configuration
  * @{
  */
 #define XTIMER              TIMER_0
@@ -40,7 +40,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(PA, 17)
@@ -54,7 +54,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/avsextrem/include/board.h

@@ -32,7 +32,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(2, 25)
@@ -51,7 +51,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize the board's clock system
+ * @brief   Initialize the board's clock system
  */
 void init_clks1(void);
 

boards/avsextrem/include/periph_conf.h

@@ -26,7 +26,7 @@ extern "C" {
 #endif
 
 /**
- * @name   Clock configuration
+ * @name    Clock configuration
  * @{
  */
 #define CLOCK_CORECLOCK     (72000000U)         /* this board runs with 72MHz */
@@ -35,20 +35,20 @@ extern "C" {
 /** @} */
 
 /**
- * @name   Timer configuration, select a number from 1 to 4
+ * @name    Timer configuration, select a number from 1 to 4
  * @{
  */
 #define TIMER_NUMOF         (1U)
 /** @} */
 
 /**
- * @name Real Time Clock configuration
+ * @name    Real Time Clock configuration
  */
 #define RTC_NUMOF           (1U)
 /** @} */
 
 /**
- * @name UART configuration
+ * @name    UART configuration
  * @{
  */
 #define UART_NUMOF          (1U)
@@ -56,7 +56,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  * @{
  */
 #define SPI_NUMOF           (1U)

boards/calliope-mini/include/board.h

@@ -29,7 +29,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Xtimer configuration
+ * @name    Xtimer configuration
  * @{
  */
 #define XTIMER_DEV                  (0)
@@ -39,7 +39,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   LED matrix pin configuration
+ * @name    LED matrix pin configuration
  * @{
  */
 #define MINI_LED_COL1               GPIO_PIN(0,  4)
@@ -57,7 +57,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   Button configuration
+ * @name    Button configuration
  * @{
  */
 #define BTN0_PIN                    GPIO_PIN(0, 17)

boards/calliope-mini/include/periph_conf.h

@@ -42,7 +42,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -84,7 +84,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 #define UART_NUMOF          (1U)
@@ -95,7 +95,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name   I2C (TWI) configuration
+ * @name    I2C (TWI) configuration
  * @{
  */
 static const i2c_conf_t i2c_config[] = {
@@ -111,7 +111,7 @@ static const i2c_conf_t i2c_config[] = {
 /** @} */
 
 /**
- * @name   ADC configuration
+ * @name    ADC configuration
  *
  * The configuration consists simply of a list of channels that should be used
  * @{
@@ -120,7 +120,7 @@ static const i2c_conf_t i2c_config[] = {
 /** @} */
 
 /**
- * @brief   Radio device configuration
+ * @name    Radio device configuration
  *
  * The radio is not guarded by a NUMOF define, as the radio is selected by its
  * own module in the build system.

boards/cc2538dk/include/board.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(2, 0)
@@ -60,10 +60,9 @@ extern "C" {
 /** @} */
 
 /**
- * @name Flash Customer Configuration Area (CCA) parameters
+ * @name    Flash Customer Configuration Area (CCA) parameters
  * @{
  */
-
 #ifndef UPDATE_CCA
 #define UPDATE_CCA                1
 #endif
@@ -74,7 +73,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name xtimer configuration
+ * @name    xtimer configuration
  * @{
  */
 #define XTIMER_DEV          (0)
@@ -87,7 +86,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/cc2650stk/include/board.h

@@ -28,14 +28,14 @@ extern "C" {
 #endif
 
 /**
- * @brief   Xtimer configuration
+ * @name   Xtimer configuration
  * @{
  */
 #define XTIMER_WIDTH                (16)
 /** @} */
 
 /**
- * @brief   On-board button configuration
+ * @name    On-board button configuration
  * @{
  */
 #define BUTTON1_DIO         GPIO_PIN(0, 4)
@@ -43,7 +43,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   Macros for controlling the on-board LEDs
+ * @name    Macros for controlling the on-board LEDs
  * @{
  */
 #define LED0_PIN            GPIO_PIN(0, 10)

boards/cc2650stk/include/periph_conf.h

@@ -26,7 +26,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Clock configuration
+ * @name    Clock configuration
  * @{
  */
 /* the main clock is fixed to 48MHZ */
@@ -34,7 +34,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -55,7 +55,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  *
  * The used CC26x0 CPU only supports a single UART device, so all we need to
  * configure are the RX and TX pins.

boards/chronos/include/board.h

@@ -15,7 +15,7 @@
  * @file
  * @brief       Header for the chronos board
  *
- * @author      unknwon
+ * @author      unknown
  */
 
 #ifndef CHRONOS_BOARD_H
@@ -28,14 +28,14 @@ extern "C" {
 #endif
 
 /**
- * @brief   Define the CPU model for the <msp430.h>
+ * @name    Define the CPU model for the <msp430.h>
  */
 #ifndef __CC430F6137__
 #define __CC430F6137__
 #endif
 
 /**
- * @brief   Xtimer configuration
+ * @name    Xtimer configuration
  * @{
  */
 #define XTIMER_DEV                  (0)
@@ -44,9 +44,10 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   MSP430 core configuration
+ * @name    MSP430 core configuration
  * @{
  */
+/** @todo Move this to the periph_conf.h */
 #define MSP430_INITIAL_CPU_SPEED    7372800uL
 #define F_CPU                       MSP430_INITIAL_CPU_SPEED
 #define F_RC_OSCILLATOR             32768
@@ -58,5 +59,5 @@ extern "C" {
 }
 #endif
 
-#endif /* _CHRONOS_BOARD_H */
+#endif /* CHRONOS_BOARD_H */
 /** @} */

boards/chronos/include/periph_conf.h

@@ -26,17 +26,17 @@ extern "C" {
 #endif
 
 /**
- * @brief   Clock configuration
+ * @name    Clock configuration
- *
+ * @{
- * @todo    Move all clock configuration code here from the board.h
  */
+/** @todo   Move all clock configuration code here from the board.h */
 #define CLOCK_CORECLOCK     (12000000U)
 
 #define CLOCK_CMCLK         CLOCK_CORECLOCK     /* no divider programmed */
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 #define TIMER_NUMOF         (1U)
@@ -47,7 +47,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 #define UART_NUMOF          (1U)
@@ -68,9 +68,11 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   Real Time Clock configuration
+ * @name    Real Time Clock configuration
+ * @{
  */
 #define RTC_NUMOF           (1)
+/** @} */
 
 #ifdef __cplusplus
 }

boards/ek-lm4f120xl/include/board.h

@@ -30,7 +30,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(5, 7)
@@ -56,7 +56,7 @@ extern "C" {
 /* @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 extern void board_init(void);
 

boards/f4vi1/include/board.h

@@ -30,7 +30,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(PORT_A, 1)
@@ -56,7 +56,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/f4vi1/include/periph_conf.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  */
 #define CLOCK_HSE           (16000000U)          /* external oscillator */
@@ -51,7 +51,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -78,7 +78,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -105,14 +105,14 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @name   ADC configuration
+ * @name    ADC configuration
  * @{
  */
 #define ADC_NUMOF           (0)
 /** @} */
 
 /**
- * @name   DAC configuration
+ * @name    DAC configuration
  * @{
  */
 #define DAC_NUMOF           (0)

boards/fox/include/board.h

@@ -34,12 +34,16 @@ extern "C" {
 #endif
 
 /**
- * @name Tell the xtimer that we use a 16-bit peripheral timer
+ * @name    Xtimer configuration
+ *
+ * Tell the xtimer that we use a 16-bit peripheral timer
+ * @{
  */
 #define XTIMER_WIDTH        (16)
+/** @} */
 
 /**
- * @name Define the interface to the AT86RF231 radio
+ * @brief   Define the interface to the AT86RF231 radio
  *
  * {spi bus, spi speed, cs pin, int pin, reset pin, sleep pin}
  */
@@ -51,7 +55,7 @@ extern "C" {
                                      .reset_pin = GPIO_PIN(PORT_C, 1)}
 
 /**
- * @name Define the interface to the LPS331AP pressure sensor
+ * @name    Define the interface to the LPS331AP pressure sensor
  * @{
  */
 #define LPS331AP_I2C        I2C_0
@@ -59,7 +63,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name Define the interface for the L3G4200D gyroscope
+ * @name    Define the interface for the L3G4200D gyroscope
  * @{
  */
 #define L3G4200D_I2C        I2C_0
@@ -69,7 +73,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name Define the interface to the LSM303DLHC accelerometer and magnetometer
+ * @name    Define the interface to the LSM303DLHC accelerometer and magnetometer
  * @{
  */
 #define LSM303DLHC_I2C      I2C_0
@@ -81,7 +85,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(PORT_B, 10)
@@ -100,7 +104,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/fox/include/periph_conf.h

@@ -26,7 +26,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  **/
 #define CLOCK_HSE           (16000000U)             /* frequency of external oscillator */
@@ -45,21 +45,21 @@ extern "C" {
 /** @} */
 
 /**
- * @name ADC configuration
+ * @name    ADC configuration
  * @{
  */
 #define ADC_NUMOF           (0)
 /** @} */
 
 /**
- * @name   DAC configuration
+ * @name    DAC configuration
  * @{
  */
 #define DAC_NUMOF           (0)
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -86,7 +86,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -115,7 +115,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  *
  * @note    The spi_divtable is auto-generated from
  *          `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -154,7 +154,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name Real time counter configuration
+ * @name    Real time counter configuration
  * @{
  */
 #define RTT_NUMOF           (1U)
@@ -169,7 +169,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name I2C configuration
+ * @name    I2C configuration
   * @{
  */
 #define I2C_NUMOF           (1U)

boards/frdm-k64f/include/board.h

@@ -31,7 +31,7 @@ extern "C"
 #endif
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(PORT_B, 22)
@@ -56,7 +56,7 @@ extern "C"
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/iotlab-common/include/board_common.h

@@ -35,7 +35,7 @@ extern "C" {
 #endif
 
 /**
- * @name Set the default baudrate to 500K for this board
+ * @name    Set the default baudrate to 500K for this board
  * @{
  */
 #ifndef UART_STDIO_BAUDRATE
@@ -44,12 +44,18 @@ extern "C" {
 /** @} */
 
 /**
- * @name Tell the xtimer that we use a 16-bit peripheral timer
+ * @name    Xtimer configuration
+ *
+ * Tell the xtimer that we use a 16-bit peripheral timer
+ * @{
  */
-#define XTIMER_WIDTH        (16)
+#define XTIMER_WIDTH        (16U)
+#define XTIMER_OVERHEAD     (6U)
+#define XTIMER_SHOOT_EARLY  (3U)
+/** @} */
 
 /**
- * @name Define the interface to the AT86RF231 radio
+ * @brief   Define the interface to the AT86RF231 radio
  *
  * {spi bus, spi speed, cs pin, int pin, reset pin, sleep pin}
  */
@@ -61,7 +67,7 @@ extern "C" {
                                      .reset_pin = GPIO_PIN(PORT_C, 1)}
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(PORT_D, 2)
@@ -86,15 +92,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name xtimer tuning values
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
- * @{
- */
-#define XTIMER_OVERHEAD     6
-#define XTIMER_SHOOT_EARLY  3
-/** @} */
-
-/**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/iotlab-common/include/periph_conf_common.h

@@ -27,7 +27,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  **/
 #define CLOCK_HSE           (16000000U)             /* frequency of external oscillator */
@@ -48,7 +48,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name ADC configuration
+ * @name    ADC configuration
  * @{
  */
 #define ADC_CONFIG          {       \
@@ -60,7 +60,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -87,7 +87,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @brief   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -116,14 +116,14 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @name   DAC configuration
+ * @name    DAC configuration
  * @{
  */
 #define DAC_NUMOF           (0)
 /** @} */
 
 /**
- * @name Real time counter configuration
+ * @name    Real time counter configuration
  * @{
  */
 #define RTT_NUMOF           (1U)
@@ -138,7 +138,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @name I2C configuration
+ * @name    I2C configuration
   * @{
  */
 #define I2C_NUMOF           (1U)

boards/limifrog-v1/include/board.h

@@ -31,7 +31,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(PORT_C, 3)
@@ -45,7 +45,7 @@ extern "C" {
  /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/limifrog-v1/include/periph_conf.h

@@ -26,7 +26,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  **/
 #define CLOCK_HSI           (16000000U)         /* internal oscillator */
@@ -50,14 +50,14 @@ extern "C" {
 /** @} */
 
 /**
- * @name   DAC configuration
+ * @name    DAC configuration
  * @{
  */
 #define DAC_NUMOF           (0)
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -76,7 +76,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -109,7 +109,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  *
  * @note    The spi_divtable is auto-generated from
  *          `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -159,7 +159,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name I2C configuration
+ * @name    I2C configuration
   * @{
  */
 #define I2C_0_EN            1

boards/mbed_lpc1768/include/board.h

@@ -33,7 +33,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(1, 18)
@@ -62,7 +62,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, include clocks, LEDs and stdio
+ * @brief   Initialize board specific hardware, include clocks, LEDs and stdio
  */
 void board_init(void);
 

boards/mbed_lpc1768/include/periph_conf.h

@@ -24,7 +24,7 @@ extern "C" {
 #endif
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 #define TIMER_NUMOF         (1U)
@@ -44,7 +44,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 #define UART_NUMOF          (2U)

boards/microbit/include/board.h

@@ -29,7 +29,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Xtimer configuration
+ * @name    Xtimer configuration
  * @{
  */
 #define XTIMER_DEV                  (0)
@@ -39,7 +39,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   LED matrix pin configuration
+ * @name    LED matrix pin configuration
  * @{
  */
 #define MICROBIT_LED_COL1           GPIO_PIN(0,  4)
@@ -57,7 +57,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   Button configuration
+ * @name    Button configuration
  * @{
  */
 #define BTN0_PIN                    GPIO_PIN(0, 17)
@@ -65,7 +65,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   MMA8653 accelerometer configuration
+ * @name    MMA8653 accelerometer configuration
  * @{
  */
 #define MMA8653_PARAM_I2C           I2C_0,
@@ -73,7 +73,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   MAG3110 magnetometer configuration
+ * @name    MAG3110 magnetometer configuration
  * @{
  */
 #define MAG3110_PARAM_I2C           I2C_0,

boards/microbit/include/periph_conf.h

@@ -120,7 +120,7 @@ static const i2c_conf_t i2c_config[] = {
 /** @} */
 
 /**
- * @brief   Radio device configuration
+ * @name   Radio device configuration
  *
  * The radio is not guarded by a NUMOF define, as the radio is selected by its
  * own module in the build system.

boards/mips-malta/include/periph_conf.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Timer definitions
+ * @name    Timer definitions
  * @{
  */
 #define TIMER_NUMOF         (1)
@@ -36,18 +36,18 @@ extern "C" {
 /** @} */
 
 /**
- * @brief No UART driver for this board currently
+ * @brief   No UART driver for this board currently
- *        Note this value must be set though (to 0)
+ *          Note this value must be set though (to 0)
  */
 #define UART_NUMOF          (0)
 
 /**
- * @brief Enable DSP context save + restore.
+ * @brief   Enable DSP context save + restore.
  */
 #define MIPS_DSP            (1)
 
 /**
- * @brief Enable FPU context save + restore.
+ * @brief   Enable FPU context save + restore.
  */
 #define MIPS_HARD_FLOAT     (1)
 

boards/msb-430-common/include/board_common.h

@@ -34,7 +34,7 @@ extern "C" {
 #define INFOMEM     (0x1000)
 
 /**
- * @brief   Xtimer configuration
+ * @name    Xtimer configuration
  * @{
  */
 #define XTIMER_DEV                  (0)
@@ -44,7 +44,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN                    GPIO_PIN(4, 7)

boards/msb-430/include/board.h

@@ -48,11 +48,10 @@ extern "C" {
 #endif
 
 /**
- * @brief   CPU core configuration
+ * @name    CPU core configuration
- *
- * @todo    Move this to the periph_conf.h
  * @{
  */
+/** @todo Move this to the periph_conf.h */
 #define MSP430_INITIAL_CPU_SPEED    2457600uL
 #define F_CPU                       MSP430_INITIAL_CPU_SPEED
 #define F_RC_OSCILLATOR             32768

boards/msb-430/include/periph_conf.h

@@ -26,17 +26,17 @@ extern "C" {
 #endif
 
 /**
- * @brief   Clock configuration
+ * @name    Clock configuration
- *
+ * @{
- * @todo    Move all clock configuration code here from the board.h
  */
+/** @todo   Move all clock configuration code here from the board.h */
 #define CLOCK_CORECLOCK     (7372800U)
 
 #define CLOCK_CMCLK         CLOCK_CORECLOCK     /* no divider programmed */
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 #define TIMER_NUMOF         (1U)
@@ -47,7 +47,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 #define UART_NUMOF          (1U)
@@ -68,7 +68,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  * @{
  */
 #define SPI_NUMOF           (1U)

boards/msb-430h/include/board.h

@@ -36,11 +36,10 @@ extern "C" {
 #endif
 
 /**
- * @brief   CPU core configuration
+ * @name    CPU core configuration
- *
- * @todo    Move this to the periph_conf.h
  * @{
  */
+/** @todo   Move this to the periph_conf.h */
 #define MSP430_INITIAL_CPU_SPEED    7372800uL
 #define F_CPU                       MSP430_INITIAL_CPU_SPEED
 #define F_RC_OSCILLATOR             32768

boards/msb-430h/include/periph_conf.h

@@ -28,17 +28,17 @@ extern "C" {
 #endif
 
 /**
- * @brief   Clock configuration
+ * @name    Clock configuration
- *
+ * @{
- * @todo    Move all clock configuration code here from the board.h
  */
+/** @todo   Move all clock configuration code here from the board.h */
 #define CLOCK_CORECLOCK     (7372800U)
 
 #define CLOCK_CMCLK         CLOCK_CORECLOCK     /* no divider programmed */
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 #define TIMER_NUMOF         (1U)
@@ -49,7 +49,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 #define UART_NUMOF          (1U)
@@ -70,7 +70,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  * @{
  */
 #define SPI_NUMOF           (1U)

boards/msba2/include/board.h

@@ -29,7 +29,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(2, 25)
@@ -48,7 +48,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name xtimer tuning values
+ * @name    xtimer tuning values
  * @{
  */
 #define XTIMER_OVERHEAD     7
@@ -56,7 +56,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief initialize the board's clock system
+ * @brief   initialize the board's clock system
  */
 void init_clks1(void);
 

boards/msba2/include/periph_conf.h

@@ -26,7 +26,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Clock configuration
+ * @name    Clock configuration
  * @{
  */
 #define CLOCK_CORECLOCK     (72000000U)         /* the msba2 runs with 72MHz */
@@ -35,7 +35,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   Timer configuration, select a number from 1 to 4
+ * @name    Timer configuration, select a number from 1 to 4
  * @{
  */
 #define TIMER_NUMOF         (1U)
@@ -46,7 +46,6 @@ extern "C" {
  *
  * Currently, we only support a single device and 3 channels, the implementation
  * is fixed on PWM1.
- *
  * @{
  */
 #define PWM_NUMOF           (1U)
@@ -68,12 +67,14 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Real Time Clock configuration
+ * @name    Real Time Clock configuration
+ * @{
  */
 #define RTC_NUMOF           (1)
+/** @} */
 
 /**
- * @brief uart configuration
+ * @name    UART configuration
  * @{
  */
 #define UART_NUMOF          (1)
@@ -81,7 +82,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  *
  * The SPI implementation is very much fixed, so we don't need to configure
  * anything besides the mandatory SPI_NUMOF.

boards/msbiot/include/board.h

@@ -29,7 +29,7 @@ extern "C" {
 #endif
 
 /**
- * @name Configure connected CC1101 (radio) device
+ * @name    Configure connected CC1101 (radio) device
  * @{
  */
 #define CC110X_SPI          SPI_DEV(0)
@@ -40,7 +40,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name Configure connected MPU-9150 device
+ * @name    Configure connected MPU-9150 device
  * @{
  */
 #define MPU9150_I2C         I2C_0
@@ -49,7 +49,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(PORT_B, 8)
@@ -75,7 +75,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/msbiot/include/periph_conf.h

@@ -26,7 +26,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  */
 #define CLOCK_HSE           (16000000U)         /* external oscillator */
@@ -49,7 +49,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -96,7 +96,7 @@ static const pwm_conf_t pwm_config[] = {
 /** @} */
 
 /**
- * @name ADC configuration
+ * @name    ADC configuration
  *
  * We need to define the following fields:
  * PIN, device (ADCx), channel
@@ -111,7 +111,7 @@ static const pwm_conf_t pwm_config[] = {
 /** @} */
 
 /**
- * @name   DAC configuration
+ * @name    DAC configuration
  *
  * We need to define the following fields:
  * PIN, DAC channel
@@ -126,7 +126,7 @@ static const pwm_conf_t pwm_config[] = {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -187,7 +187,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  *
  * @note    The spi_divtable is auto-generated from
  *          `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -227,7 +227,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name I2C configuration
+ * @name    I2C configuration
  * @{
  */
 #define I2C_NUMOF           (1U)

boards/native/include/board.h

@@ -35,7 +35,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   LED handlers
+ * @name    LED handlers
  * @{
  */
 void _native_LED_GREEN_OFF(void);

boards/nrf52840dk/include/board.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   LED pin configuration
+ * @name    LED pin configuration
  * @{
  */
 #define LED0_PIN            GPIO_PIN(0, 13)
@@ -60,7 +60,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   Button pin configuration
+ * @name    Button pin configuration
  * @{
  */
 #define BUTTON1_PIN         (GPIO_PIN(0, 11))
@@ -70,7 +70,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/nrf52dk/include/board.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   LED pin configuration
+ * @name    LED pin configuration
  * @{
  */
 #define LED0_PIN            GPIO_PIN(0, 17)
@@ -59,7 +59,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   Button pin configuration
+ * @name    Button pin configuration
  * @{
  */
 #define BUTTON1_PIN         (GPIO_PIN(0, 13))
@@ -69,7 +69,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/nrf52dk/include/periph_conf.h

@@ -42,7 +42,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {

boards/nrf6310/include/board.h

@@ -30,7 +30,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(0, 8)
@@ -55,7 +55,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/nrf6310/include/periph_conf.h

@@ -45,7 +45,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -69,7 +69,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name UART configuration
+ * @name    UART configuration
  * @{
  */
 #define UART_NUMOF          (1U)
@@ -85,7 +85,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name Radio device configuration
+ * @name    Radio device configuration
  *
  * The radio is not guarded by a NUMOF define, as the radio is selected by its
  * own module in the build system.
@@ -95,7 +95,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name SPI configuration
+ * @name    SPI configuration
  * @{
  */
 static const spi_conf_t spi_config[] = {
@@ -117,7 +117,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name   ADC configuration
+ * @name    ADC configuration
  *
  * The configuration consists simply of a list of channels that should be used
  * @{

boards/nucleo-f030/include/board.h

@@ -31,7 +31,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Xtimer configuration
+ * @name    Xtimer configuration
  * @{
  */
 #define XTIMER_WIDTH                (16)

boards/nucleo-f070/include/board.h

@@ -32,7 +32,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Xtimer configuration
+ * @name    Xtimer configuration
  * @{
  */
 #define XTIMER_WIDTH                (16)

boards/nucleo-f072/include/board.h

@@ -30,7 +30,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Xtimer configuration
+ * @name    Xtimer configuration
  * @{
  */
 #define XTIMER_WIDTH                (16)

boards/nucleo-f091/include/board.h

@@ -29,7 +29,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Xtimer configuration
+ * @name    Xtimer configuration
  * @{
  */
 #define XTIMER_WIDTH                (16)

boards/nucleo-f103/include/board.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @name xtimer configuration
+ * @name    xtimer configuration
  */
 #define XTIMER_WIDTH        (16)
 #define XTIMER_BACKOFF      5

boards/nucleo-f411/include/board.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @name xtimer configuration
+ * @name    xtimer configuration
  * @{
  */
 #define XTIMER_DEV          TIMER_DEV(0)

boards/nucleo-f411/include/periph_conf.h

@@ -26,7 +26,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  */
 #define CLOCK_HSE           (8000000U)          /* external oscillator */
@@ -49,7 +49,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -69,7 +69,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @brief   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -129,7 +129,7 @@ static const uart_conf_t uart_config[] = {
 #define UART_NUMOF          (sizeof(uart_config) / sizeof(uart_config[0]))
 /** @} */
 
-/** @brief   PWM configuration
+/** @name    PWM configuration
  * @{
  */
 static const pwm_conf_t pwm_config[] = {
@@ -159,7 +159,7 @@ static const pwm_conf_t pwm_config[] = {
 /** @} */
 
 /**
- * @brief   SPI configuration
+ * @name    SPI configuration
  *
  * @note    The spi_divtable is auto-generated from
  *          `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -199,7 +199,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name I2C configuration
+ * @name    I2C configuration
  * @{
  */
 #define I2C_NUMOF           (1U)
@@ -227,14 +227,14 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name   ADC configuration
+ * @name    ADC configuration
  * @{
  */
 #define ADC_NUMOF          (0)
 /** @} */
 
 /**
- * @name   DAC configuration
+ * @name    DAC configuration
  * @{
  */
 #define DAC_NUMOF           (0)

boards/nucleo-l053/include/board.h

@@ -31,7 +31,7 @@ extern "C" {
 #endif
 
 /**
- * @name xtimer configuration
+ * @name    xtimer configuration
  * @{
  */
 #define XTIMER_DEV          TIMER_DEV(0)

boards/nucleo-l053/include/periph_conf.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  */
 #define CLOCK_HSI           (16000000U)         /* internal oscillator */
@@ -52,7 +52,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -71,7 +71,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @brief   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -104,7 +104,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @brief   PWM configuration
+ * @name    PWM configuration
  * @{
  */
 static const pwm_conf_t pwm_config[] = {
@@ -124,7 +124,7 @@ static const pwm_conf_t pwm_config[] = {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  *
  * @note    The spi_divtable is auto-generated from
  *          `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -164,7 +164,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name   ADC configuration
+ * @name    ADC configuration
  * @{
  */
 #define ADC_NUMOF           (0)
@@ -172,14 +172,14 @@ static const spi_conf_t spi_config[] = {
 
 
 /**
- * @name   DAC configuration
+ * @name    DAC configuration
  * @{
  */
 #define DAC_NUMOF           (0)
 /** @} */
 
 /**
- * @name RTC configuration
+ * @name    RTC configuration
  * @{
  */
 #define RTC_NUMOF           (0U)

boards/nucleo-l073/include/board.h

@@ -31,7 +31,7 @@ extern "C" {
 #endif
 
 /**
- * @name xtimer configuration
+ * @name    xtimer configuration
  * @{
  */
 #define XTIMER_DEV          TIMER_DEV(0)

boards/nucleo-l073/include/periph_conf.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  */
 #define CLOCK_HSI           (16000000U)         /* internal oscillator */
@@ -52,7 +52,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -71,7 +71,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @brief   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -104,7 +104,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @brief   PWM configuration
+ * @name    PWM configuration
  * @{
  */
 static const pwm_conf_t pwm_config[] = {
@@ -124,7 +124,7 @@ static const pwm_conf_t pwm_config[] = {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  *
  * @note    The spi_divtable is auto-generated from
  *          `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -164,7 +164,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name   ADC configuration
+ * @name    ADC configuration
  * @{
  */
 #define ADC_NUMOF           (0)
@@ -172,14 +172,14 @@ static const spi_conf_t spi_config[] = {
 
 
 /**
- * @name   DAC configuration
+ * @name    DAC configuration
  * @{
  */
 #define DAC_NUMOF           (0)
 /** @} */
 
 /**
- * @name RTC configuration
+ * @name    RTC configuration
  * @{
  */
 #define RTC_NUMOF           (0U)

boards/nucleo-l476/include/periph_conf.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  */
 /* 0: no external high speed crystal available
@@ -66,7 +66,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -85,7 +85,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @brief   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -141,7 +141,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @brief   PWM configuration
+ * @name    PWM configuration
  * @{
  */
 static const pwm_conf_t pwm_config[] = {
@@ -181,7 +181,7 @@ static const pwm_conf_t pwm_config[] = {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  *
  * @note    The spi_divtable is auto-generated from
  *          `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -221,14 +221,14 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name   ADC configuration
+ * @name    ADC configuration
  * @{
  */
 #define ADC_NUMOF           (0)
 /** @} */
 
 /**
- * @name   DAC configuration
+ * @name    DAC configuration
  * @{
  */
 #define DAC_NUMOF           (0)

boards/nucleo144-common/include/board_common.h

@@ -32,7 +32,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(PORT_B, 0)

boards/nucleo144-f207/include/periph_conf.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  */
 #define CLOCK_HSE           (8000000U)          /* external oscillator */
@@ -71,7 +71,7 @@ static const pwm_conf_t pwm_config[] = {
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -105,8 +105,9 @@ static const timer_conf_t timer_config[] = {
 
 #define TIMER_NUMOF         (sizeof(timer_config) / sizeof(timer_config[0]))
 /** @} */
+
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -167,7 +168,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  *
  * @note    The spi_divtable is auto-generated from
  *          `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -217,7 +218,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name I2C configuration
+ * @name    I2C configuration
  * @{
  */
 #define I2C_NUMOF           (1U)
@@ -247,7 +248,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name   ADC configuration
+ * @name    ADC configuration
  *
  * We need to define the following fields:
  * PIN, device (ADCx), channel
@@ -262,14 +263,14 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name   DAC configuration
+ * @name    DAC configuration
  * @{
  */
 #define DAC_NUMOF           (0)
 /** @} */
 
 /**
- * @brief   RTC configuration
+ * @name    RTC configuration
  * @{
  */
 #define RTC_NUMOF           (1)

boards/nucleo144-f303/include/periph_conf.h

@@ -26,7 +26,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  */
 #define CLOCK_HSE           (8000000U)          /* external oscillator */
@@ -46,7 +46,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -65,7 +65,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -124,7 +124,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @brief   PWM configuration
+ * @name    PWM configuration
  * @{
  */
 static const pwm_conf_t pwm_config[] = {
@@ -144,7 +144,7 @@ static const pwm_conf_t pwm_config[] = {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  *
  * @note    The spi_divtable is auto-generated from
  *          `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -185,7 +185,7 @@ static const spi_conf_t spi_config[] = {
 
 
 /**
- * @name I2C configuration
+ * @name    I2C configuration
  * @{
  */
 #define I2C_NUMOF           (0U)
@@ -199,7 +199,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name   DAC configuration
+ * @name    DAC configuration
  * @{
  */
 #define DAC_NUMOF           (0)

boards/nucleo144-f413/include/board.h

@@ -30,7 +30,7 @@ extern "C" {
 #endif
 
 /**
- * @name xtimer configuration
+ * @name    xtimer configuration
  * @{
  */
 #define XTIMER_DEV          TIMER_DEV(0)

boards/nucleo144-f413/include/periph_conf.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  */
 #define CLOCK_HSE           (8000000U)          /* external oscillator */
@@ -51,7 +51,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -70,7 +70,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -129,7 +129,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @brief   PWM configuration
+ * @name    PWM configuration
  * @{
  */
 static const pwm_conf_t pwm_config[] = {
@@ -169,7 +169,7 @@ static const pwm_conf_t pwm_config[] = {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  *
  * @note    The spi_divtable is auto-generated from
  *          `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -192,8 +192,6 @@ static const uint8_t spi_divtable[2][5] = {
     }
 };
 
-
-
 static const spi_conf_t spi_config[] = {
     {
         .dev      = SPI1,
@@ -210,9 +208,8 @@ static const spi_conf_t spi_config[] = {
 #define SPI_NUMOF           (sizeof(spi_config) / sizeof(spi_config[0]))
 /** @} */
 
-
 /**
- * @name I2C configuration
+ * @name    I2C configuration
  * @{
  */
 #define I2C_NUMOF           (1U)
@@ -240,21 +237,21 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name   ADC configuration
+ * @name    ADC configuration
  * @{
  */
 #define ADC_NUMOF          (0)
 /** @} */
 
 /**
- * @name   DAC configuration
+ * @name    DAC configuration
  * @{
  */
 #define DAC_NUMOF           (0)
 /** @} */
 
 /**
- * @name   RTC configuration
+ * @name    RTC configuration
  * @{
  */
 #define RTC_NUMOF           (1)

boards/nucleo144-f429/include/board.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @name xtimer configuration
+ * @name    xtimer configuration
  * @{
  */
 #define XTIMER_DEV          TIMER_DEV(0)

boards/nucleo144-f429/include/periph_conf.h

@@ -26,7 +26,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  */
 #define CLOCK_HSE           (8000000U)          /* external oscillator */
@@ -49,7 +49,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -68,7 +68,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -127,7 +127,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @brief   PWM configuration
+ * @name    PWM configuration
  * @{
  */
 static const pwm_conf_t pwm_config[] = {
@@ -157,7 +157,7 @@ static const pwm_conf_t pwm_config[] = {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  *
  * @note    The spi_divtable is auto-generated from
  *          `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -196,9 +196,8 @@ static const spi_conf_t spi_config[] = {
 #define SPI_NUMOF           (sizeof(spi_config) / sizeof(spi_config[0]))
 /** @} */
 
-
 /**
- * @name I2C configuration
+ * @name    I2C configuration
  * @{
  */
 #define I2C_NUMOF           (1U)
@@ -226,17 +225,17 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name   ADC configuration
+ * @name    ADC configuration
  * @{
  */
 #define ADC_NUMOF          (0)
 /** @} */
 
 /**
- * @name   DAC configuration
+ * @name    DAC configuration
  * @{
  */
-#define DAC_NUMOF           (0)
+#define DAC_NUMOF          (0)
 /** @} */
 
 #ifdef __cplusplus

boards/nucleo144-f446/include/board.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @name xtimer configuration
+ * @name    xtimer configuration
  * @{
  */
 #define XTIMER_DEV          TIMER_DEV(0)

boards/nucleo144-f446/include/periph_conf.h

@@ -26,7 +26,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  */
 #define CLOCK_HSE           (8000000U)          /* external oscillator */
@@ -49,7 +49,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -68,7 +68,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -127,7 +127,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @brief   PWM configuration
+ * @name    PWM configuration
  * @{
  */
 static const pwm_conf_t pwm_config[] = {
@@ -167,7 +167,7 @@ static const pwm_conf_t pwm_config[] = {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  *
  * @note    The spi_divtable is auto-generated from
  *          `cpu/stm32_common/dist/spi_divtable/spi_divtable.c`
@@ -206,9 +206,8 @@ static const spi_conf_t spi_config[] = {
 #define SPI_NUMOF           (sizeof(spi_config) / sizeof(spi_config[0]))
 /** @} */
 
-
 /**
- * @name I2C configuration
+ * @name    I2C configuration
  * @{
  */
 #define I2C_NUMOF           (1U)
@@ -236,17 +235,17 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name   ADC configuration
+ * @name    ADC configuration
  * @{
  */
 #define ADC_NUMOF          (0)
 /** @} */
 
 /**
- * @name   DAC configuration
+ * @name    DAC configuration
  * @{
  */
-#define DAC_NUMOF           (0)
+#define DAC_NUMOF          (0)
 /** @} */
 
 #ifdef __cplusplus

boards/nucleo32-l031/include/periph_conf.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  */
 #define CLOCK_HSI           (16000000U)         /* internal oscillator */
@@ -52,7 +52,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -71,7 +71,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @brief   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -93,7 +93,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @brief   PWM configuration
+ * @name    PWM configuration
  * @{
  */
 static const pwm_conf_t pwm_config[] = {
@@ -113,7 +113,7 @@ static const pwm_conf_t pwm_config[] = {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  * @{
  */
 static const uint8_t spi_divtable[2][5] = {
@@ -150,22 +150,21 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name   ADC configuration
+ * @name    ADC configuration
  * @{
  */
 #define ADC_NUMOF           (0)
 /** @} */
 
-
 /**
- * @name   DAC configuration
+ * @name    DAC configuration
  * @{
  */
 #define DAC_NUMOF           (0)
 /** @} */
 
 /**
- * @name RTC configuration
+ * @name    RTC configuration
  * @{
  */
 #define RTC_NUMOF           (0U)

boards/opencm904/include/board.h

@@ -67,7 +67,7 @@ extern "C" {
 #define UART_STDIO_DEV      UART_DEV(0)
 
 /**
- * @brief Override with ROBOTIS Bluetooth antenna baudrate for STDIO
+ * @name Override with ROBOTIS Bluetooth antenna baudrate for STDIO
  * @{
  */
 #ifndef UART_STDIO_BAUDRATE

boards/openmote-cc2538/include/board.h

@@ -29,7 +29,7 @@
 #endif
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(2, 4)
@@ -61,7 +61,7 @@
 /** @} */
 
 /**
- * @name xtimer configuration
+ * @name    xtimer configuration
  * @{
  */
 #define XTIMER_DEV          (0)
@@ -74,7 +74,7 @@
 /** @} */
 
 /**
- * @name Flash Customer Configuration Area (CCA) parameters
+ * @name    Flash Customer Configuration Area (CCA) parameters
  * @{
  */
 #ifndef UPDATE_CCA
@@ -87,7 +87,7 @@
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/openmote-cc2538/include/periph_conf.h

@@ -27,14 +27,14 @@
 #endif
 
 /**
- * @name Clock system configuration
+ * @name    Clock system configuration
  * @{
  */
 #define CLOCK_CORECLOCK     (32000000U)     /* desired core clock frequency, 32MHz */
 /** @} */
 
 /**
- * @name Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -65,7 +65,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name UART configuration
+ * @name    UART configuration
  * @{
  */
 #define UART_NUMOF          (1U)
@@ -82,7 +82,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name I2C configuration
+ * @name    I2C configuration
  * @{
  */
 #define I2C_NUMOF               1
@@ -120,7 +120,7 @@ static const spi_clk_conf_t spi_clk_config[] = {
 };
 
 /**
- * @name SPI configuration
+ * @name    SPI configuration
  * @{
  */
 static const spi_conf_t spi_config[] = {
@@ -137,7 +137,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name Radio peripheral configuration
+ * @name    Radio peripheral configuration
  * @{
  */
 #define RADIO_IRQ_PRIO      1

boards/pca10000/include/board.h

@@ -29,7 +29,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Xtimer configuration
+ * @name    Xtimer configuration
  * @{
  */
 #define XTIMER_DEV                  (0)
@@ -39,7 +39,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(0, 21)

boards/pca10000/include/periph_conf.h

@@ -44,7 +44,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -68,7 +68,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name UART configuration
+ * @name    UART configuration
  * @{
  */
 #define UART_NUMOF          (1U)
@@ -81,7 +81,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name   ADC configuration
+ * @name    ADC configuration
  *
  * The configuration consists simply of a list of channels that should be used
  * @{
@@ -90,7 +90,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name Radio device configuration
+ * @name    Radio device configuration
  *
  * The radio is not guarded by a NUMOF define, as the radio is selected by its
  * own module in the build system.

boards/pca10005/include/board.h

@@ -29,7 +29,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Xtimer configuration
+ * @name    Xtimer configuration
  * @{
  */
 #define XTIMER_DEV                  (0)
@@ -39,7 +39,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/pca10005/include/periph_conf.h

@@ -44,7 +44,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -58,7 +58,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name UART configuration
+ * @name    UART configuration
  * @{
  */
 #define UART_NUMOF          (1U)
@@ -78,7 +78,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name SPI configuration
+ * @name    SPI configuration
  * @{
  */
 static const spi_conf_t spi_config[] = {
@@ -100,7 +100,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name   ADC configuration
+ * @name    ADC configuration
  *
  * The configuration consists simply of a list of channels that should be used
  * @{
@@ -110,7 +110,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name Radio device configuration
+ * @name    Radio device configuration
  *
  * The radio is not guarded by a NUMOF define, as the radio is selected by its
  * own module in the build system.

boards/pic32-clicker/include/board.h

@@ -25,8 +25,8 @@
  * @author      Neil Jones <Neil.Jones@imgtec.com>
  */
 
-#ifndef _BOARD_H_
+#ifndef BOARD_H
-#define _BOARD_H_
+#define BOARD_H
 
 #ifdef __cplusplus
 extern "C" {
@@ -35,13 +35,13 @@ extern "C" {
 #include "vendor/p32mx470f512h.h"
 
 /**
- * @brief Set how many increments of the count register per uS
+ * @brief   Set how many increments of the count register per uS
- *        needed by the timer code.
+ *          needed by the timer code.
  */
 #define TICKS_PER_US (48)
 
 /**
- * @brief We are using an External Interrupt Controller (all pic32 devices use this mode)
+ * @brief   We are using an External Interrupt Controller (all pic32 devices use this mode)
  */
 #define EIC_IRQ (1)
 
@@ -55,5 +55,5 @@ void board_init(void);
 #endif
 
 
-#endif /* _BOARD_H_ */
+#endif /* BOARD_H */
 /** @} */

boards/pic32-clicker/include/periph_conf.h

@@ -17,11 +17,11 @@
  * @file
  * @brief       peripheral configuration for the MikroE PIC32 Clicker
  *
- * @author       Neil Jones <Neil.Jones@imgtec.com>
+ * @author      Neil Jones <Neil.Jones@imgtec.com>
  */
 
-#ifndef _PERIPH_CONF_H_
+#ifndef PERIPH_CONF_H
-#define _PERIPH_CONF_H_
+#define PERIPH_CONF_H
 
 #ifdef __cplusplus
 extern "C" {
@@ -29,14 +29,14 @@ extern "C" {
 
 
 /**
- * @brief The peripheral clock is required for the UART Baud rate calculation
+ * @brief   The peripheral clock is required for the UART Baud rate calculation
- *        It is configured by the 'config' registers (see pic32_config_settings.c)
+ *          It is configured by the 'config' registers (see pic32_config_settings.c)
- *        Note 120MHz is the max F for this device.
+ *          Note 120MHz is the max F for this device.
  */
 #define PERIPHERAL_CLOCK (96000000)  /* Hz */
 
 /**
- * @brief   Timer definitions
+ * @name    Timer definitions
  * @{
  */
 #define TIMER_NUMOF         (1)
@@ -44,7 +44,7 @@ extern "C" {
 /** @} */
 
 /**
-  * @brief   UART Definitions
+  * @name    UART Definitions
   *          There are 4 UARTS available on this CPU.
   *          We route debug via UART3 on this board,
   *          this is the UART connected to the MikroBUS
@@ -61,5 +61,5 @@ extern "C" {
 }
 #endif
 
-#endif
+#endif /* PERIPH_CONF_H */
 /** @} */

boards/pic32-wifire/include/board.h

@@ -35,18 +35,18 @@ extern "C" {
 #include "vendor/p32mz2048efg100.h"
 
 /**
- * @brief       Set how many increments of the count register per uS
+ * @brief   Set how many increments of the count register per uS
- *              needed by the timer code.
+ *          needed by the timer code.
  */
 #define TICKS_PER_US (100)
 
 /**
- * @brief We are using an External Interrupt Controller (all pic32 devices use this mode)
+ * @brief   We are using an External Interrupt Controller (all pic32 devices use this mode)
  */
-#define EIC_IRQ (1)
+#define EIC_IRQ      (1)
 
 /**
- * @brief       Board level initialisation
+ * @brief   Board level initialisation
  */
 void board_init(void);
 

boards/pic32-wifire/include/periph_conf.h

@@ -27,13 +27,13 @@ extern "C" {
 #endif
 
 /**
- * @brief The peripheral clock is required for the UART Baud rate calculation
+ * @brief   The peripheral clock is required for the UART Baud rate calculation
- *        It is configured by the 'config' registers (see pic32_config_settings.c)
+ *          It is configured by the 'config' registers (see pic32_config_settings.c)
  */
 #define PERIPHERAL_CLOCK (100000000)  /* Hz */
 
 /**
- * @brief   Timer definitions
+ * @name    Timer definitions
  * @{
  */
 #define TIMER_NUMOF         (1)
@@ -41,7 +41,7 @@ extern "C" {
 /** @} */
 
 /**
-  * @brief   UART Definitions
+  * @name    UART Definitions
   *          There are 6 UARTS available on this CPU.
   *          We route debug via UART4 on this board,
   *          this is the UART connected to the FTDI USB <-> UART device.

boards/qemu-i386/include/board.h

@@ -26,7 +26,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Serial port configuration
+ * @name    Serial port configuration
  * @{
  */
 #define UART_PORT (COM1_PORT) /* IO port to use for UART */

boards/remote-pa/include/board.h

@@ -31,7 +31,7 @@
 #endif
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(3, 2)
@@ -56,14 +56,16 @@
 /** @} */
 
 /**
- * @name User button pin definition
+ * @name    User button pin definition
  * @{
  */
 #define BTN0_PIN            GPIO_PIN(0, 3)
 /** @} */
 
 /**
- * @name 2.4GHz RF switch controlled by SW
+ * @name    Radio configuration
+ *
+ * 2.4GHz RF switch controlled by SW
  * @{
  */
 #define RF_SWITCH_PORT      GPIO_D
@@ -74,7 +76,7 @@
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/remote-pa/include/periph_conf.h

@@ -28,7 +28,7 @@
 #endif
 
 /**
- * @name UART configuration
+ * @name    UART configuration
  * @{
  */
 #define UART_NUMOF          (1U)
@@ -42,11 +42,10 @@
 /* UART 0 pin configuration */
 #define UART_0_TX_PIN       GPIO_PA1
 #define UART_0_RX_PIN       GPIO_PA0
-
 /** @} */
 
 /**
- * @name I2C configuration
+ * @name    I2C configuration
  * @{
  */
 #define I2C_NUMOF               1
@@ -84,7 +83,7 @@ static const spi_clk_conf_t spi_clk_config[] = {
 };
 
 /**
- * @name SPI configuration
+ * @name    SPI configuration
  * @{
  */
 static const spi_conf_t spi_config[] = {

boards/saml21-xpro/include/board.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(1, 10)
@@ -42,12 +42,12 @@ extern "C" {
 /** @} */
 
 /**
- * @brief User button pin
+ * @brief   User button pin
  */
 #define SW0_PIN             GPIO_PIN(PA, 2)
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/saml21-xpro/include/periph_conf.h

@@ -30,12 +30,12 @@ extern "C" {
 #endif
 
 /**
- * @brief GCLK reference speed
+ * @brief   GCLK reference speed
  */
 #define CLOCK_CORECLOCK     (16000000U)
 
 /**
- * @name Timer peripheral configuration
+ * @name    Timer peripheral configuration
  * @{
  */
 #define TIMER_NUMOF        (1U)
@@ -49,7 +49,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name UART configuration
+ * @name    UART configuration
  * @{
  */
 #define UART_NUMOF          (1U)
@@ -71,7 +71,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name SPI configuration
+ * @name    SPI configuration
  * @{
  */
 static const spi_conf_t spi_config[] = {
@@ -93,14 +93,14 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name I2C configuration
+ * @name    I2C configuration
  * @{
  */
 #define I2C_NUMOF          (0)
 /** @} */
 
 /**
- * @name RTC configuration
+ * @name    RTC configuration
  * @{
  */
 #define RTC_NUMOF           (1)
@@ -110,7 +110,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name RTT configuration
+ * @name    RTT configuration
  * @{
  */
 #define RTT_FREQUENCY       (32768U)

boards/samr21-xpro/include/board.h

@@ -31,7 +31,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   xtimer configuration
+ * @name    xtimer configuration
  * @{
  */
 #define XTIMER_DEV          TIMER_1
@@ -39,7 +39,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name AT86RF233 configuration
+ * @name    AT86RF233 configuration
  *
  * {spi bus, spi speed, cs pin, int pin, reset pin, sleep pin}
  */
@@ -51,7 +51,7 @@ extern "C" {
                                      .reset_pin = GPIO_PIN(PB, 15)}
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(0, 19)
@@ -65,7 +65,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name SW0 (Button) pin definitions
+ * @name    SW0 (Button) pin definitions
  * @{
  */
 #define BUTTON_PORT         PORT->Group[0]
@@ -74,7 +74,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/samr21-xpro/include/periph_conf.h

@@ -32,7 +32,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   External oscillator and clock configuration
+ * @name    External oscillator and clock configuration
  *
  * For selection of the used CORECLOCK, we have implemented two choices:
  *
@@ -79,7 +79,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name Timer peripheral configuration
+ * @name    Timer peripheral configuration
  * @{
  */
 #define TIMER_NUMOF         (2U)
@@ -100,7 +100,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -130,7 +130,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @name PWM configuration
+ * @name    PWM configuration
  * @{
  */
 #define PWM_0_EN            1
@@ -165,7 +165,7 @@ static const pwm_conf_t pwm_config[] = {
 /** @} */
 
 /**
- * @name SPI configuration
+ * @name    SPI configuration
  * @{
  */
 static const spi_conf_t spi_config[] = {
@@ -197,7 +197,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name I2C configuration
+ * @name    I2C configuration
  * @{
  */
 #define I2C_NUMOF          (1U)
@@ -219,7 +219,7 @@ static const spi_conf_t spi_config[] = {
 #define I2C_0_MUX           GPIO_MUX_D
 
 /**
- * @name RTC configuration
+ * @name    RTC configuration
  * @{
  */
 #define RTC_NUMOF           (1U)
@@ -227,7 +227,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name RTT configuration
+ * @name    RTT configuration
  * @{
  */
 #define RTT_NUMOF           (1U)

boards/seeeduino_arch-pro/include/board.h

@@ -34,7 +34,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(1, 18)
@@ -63,7 +63,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, include clocks, LEDs and stdio
+ * @brief   Initialize board specific hardware, include clocks, LEDs and stdio
  */
 void board_init(void);
 

boards/seeeduino_arch-pro/include/periph_conf.h

@@ -25,7 +25,7 @@ extern "C" {
 #endif
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 #define TIMER_NUMOF         (1U)
@@ -45,7 +45,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 #define UART_NUMOF          (2U)

boards/slwstk6220a/include/board.h

@@ -36,7 +36,7 @@ extern "C" {
 #define HW_TIMER            TIMER_DEV(0)
 
 /**
- * @brief   Connection to the on-board temperature/humidity sensor (Si7021)
+ * @name    Connection to the on-board temperature/humidity sensor (Si7021)
  * @{
  */
 #define SI7021_I2C          (I2C_0)
@@ -50,7 +50,7 @@ extern "C" {
 #define BC_PIN              GPIO_PIN(PA,12)
 
 /**
- * @brief   User button pin definitions
+ * @name   User button pin definitions
  * @{
  */
 #define PB0_PIN             GPIO_PIN(PE,3)
@@ -58,7 +58,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   LED pin definitions
+ * @name    LED pin definitions
  * @{
  */
 #define LED0_PIN            GPIO_PIN(PF, 6)
@@ -74,7 +74,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/slwstk6220a/include/periph_conf.h

@@ -28,7 +28,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Clock configuration
+ * @name    Clock configuration
  * @{
  */
 #define CLOCK_RCOSC         (14000000)      /* internal RC oscillator speed */
@@ -49,7 +49,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -67,7 +67,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {

boards/sodaq-autonomo/include/board.h

@@ -30,7 +30,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   xtimer configuration
+ * @name    xtimer configuration
  * @{
  */
 #define XTIMER              TIMER_1
@@ -38,7 +38,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(PA, 18)
@@ -52,7 +52,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/sodaq-autonomo/include/periph_conf.h

@@ -29,7 +29,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   External oscillator and clock configuration
+ * @name    External oscillator and clock configuration
  *
  * For selection of the used CORECLOCK, we have implemented two choices:
  *
@@ -76,7 +76,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name Timer peripheral configuration
+ * @name    Timer peripheral configuration
  * @{
  */
 #define TIMER_NUMOF         (2U)
@@ -97,7 +97,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name UART configuration
+ * @name    UART configuration
  * @{
  * See Table 6.1 of the SAM D21 Datasheet
  */
@@ -146,7 +146,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
- * @name PWM configuration
+ * @name    PWM configuration
  * @{
  */
 #define PWM_0_EN            1
@@ -181,7 +181,7 @@ static const pwm_conf_t pwm_config[] = {
 /** @} */
 
 /**
- * @name SPI configuration
+ * @name    SPI configuration
  * @{
  */
 static const spi_conf_t spi_config[] = {
@@ -202,7 +202,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name I2C configuration
+ * @name    I2C configuration
  * @{
  */
 #define I2C_NUMOF           (1U)
@@ -224,7 +224,7 @@ static const spi_conf_t spi_config[] = {
 #define I2C_0_MUX           GPIO_MUX_C
 
 /**
- * @name RTC configuration
+ * @name    RTC configuration
  * @{
  */
 #define RTC_NUMOF          (1U)
@@ -232,7 +232,7 @@ static const spi_conf_t spi_config[] = {
 /** @} */
 
 /**
- * @name RTT configuration
+ * @name    RTT configuration
  * @{
  */
 #define RTT_NUMOF          (1U)

boards/telosb/include/board.h

@@ -42,7 +42,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   Override default baudrate for STDIO
+ * @name    Override default baudrate for STDIO
  * @{
  */
 #ifndef UART_STDIO_BAUDRATE
@@ -51,7 +51,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   Xtimer configuration
+ * @name    Xtimer configuration
  * @{
  */
 #define XTIMER_DEV                  (0)
@@ -61,11 +61,10 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   CPU core configuration
+ * @name    CPU core configuration
- *
- * @todo    Move this to the periph_conf.h
  * @{
  */
+/** @todo   Move this to the periph_conf.h */
 #define MSP430_INITIAL_CPU_SPEED    2457600uL
 #define F_CPU                       MSP430_INITIAL_CPU_SPEED
 #define F_RC_OSCILLATOR             32768
@@ -74,7 +73,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN                    GPIO_PIN(4, 0)

boards/telosb/include/periph_conf.h

@@ -26,17 +26,17 @@ extern "C" {
 #endif
 
 /**
- * @brief   Clock configuration
+ * @name    Clock configuration
- *
+ * @{
- * @todo    Move all clock configuration code here from the board.h
  */
+/** @todo   Move all clock configuration code here from the board.h */
 #define CLOCK_CORECLOCK     (2457600U)
 
 #define CLOCK_CMCLK         CLOCK_CORECLOCK     /* no divider programmed */
 /** @} */
 
 /**
- * @name   Timer configuration
+ * @name    Timer configuration
  * @{
  */
 #define TIMER_NUMOF         (1U)
@@ -47,7 +47,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   UART configuration
+ * @name    UART configuration
  * @{
  */
 #define UART_NUMOF          (1U)
@@ -68,7 +68,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  * @{
  */
 #define SPI_NUMOF           (1U)

boards/udoo/include/board.h

@@ -29,7 +29,7 @@ extern "C" {
 #endif
 
 /**
- * @brief   LED pin definitions and handlers
+ * @name    LED pin definitions and handlers
  * @{
  */
 #define LED0_PIN            GPIO_PIN(PB, 27)
@@ -43,7 +43,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/udoo/include/periph_conf.h

@@ -1,4 +1,4 @@
-/*
+ /*
  * Copyright (C) 2014-2015 Freie Universität Berlin
  *
  * This file is subject to the terms and conditions of the GNU Lesser
@@ -26,7 +26,7 @@ extern "C" {
 #endif
 
 /**
- * @name Clock configuration
+ * @name    Clock configuration
  * @{
  */
 /* targeted system core clock */
@@ -46,7 +46,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name Timer peripheral configuration
+ * @name    Timer peripheral configuration
  * @{
  */
 static const timer_conf_t timer_config[] = {
@@ -62,7 +62,7 @@ static const timer_conf_t timer_config[] = {
 /** @} */
 
 /**
- * @name UART configuration
+ * @name    UART configuration
  * @{
  */
 static const uart_conf_t uart_config[] = {
@@ -83,7 +83,7 @@ static const uart_conf_t uart_config[] = {
 /** @} */
 
 /**
-* @name SPI configuration
+* @name    SPI configuration
 * @{
 */
 static const spi_conf_t spi_config[] = {

boards/waspmote-pro/include/board.h

@@ -30,15 +30,14 @@ extern "C" {
 #endif
 
 /**
-* @brief As the CPU is too slow to handle 115200 baud, we set the default
+* @brief   As the CPU is too slow to handle 115200 baud, we set the default
-*        baudrate to 9600 for this board
+*          baudrate to 9600 for this board
 */
 #define UART_STDIO_BAUDRATE  (9600U)
-/** @} */
 
 /**
- * @brief Use the UART 0 for STDIO on this board, if the XBee socket is not
+ * @brief   Use the UART 0 for STDIO on this board, if the XBee socket is not
- *        being used
+ *          being used
  */
 #ifdef XBEE_UART
 #if XBEE_UART == 0
@@ -48,10 +47,8 @@ extern "C" {
 #endif
 #endif
 
-/** @} */
-
 /**
- * @name LED pin definitions
+ * @name    LED pin definitions
  * @{
  */
 #define LED0_PORT            PORTD
@@ -61,7 +58,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name Macros for controlling the on-board LEDs.
+ * @name    Macros for controlling the on-board LEDs.
  * @{
  */
 #define LED0_ENABLE_PORT     DDRD |= (1 << DDD6)
@@ -84,7 +81,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name Macros for controlling the on-board MUXes.
+ * @name    Macros for controlling the on-board MUXes.
  * @{
  */
 #define MUX_PW_PORT                  PORTD
@@ -146,12 +143,10 @@ extern "C" {
 #define SET_MUX_SOCKET0              MUX_PW_ENABLE_PORT; MUX_PW_ON; \
                                      MUX_USB_XBEE_ENABLE_PORT; \
                                      MUX_USB_XBEE_ON
-
-
 /** @} */
 
 /**
- * Context swap defines
+ * @brief Context swap defines
  * Setup to use PB5 which is pin change interrupt 5
  * This emulates a software triggered interrupt
  **/
@@ -166,7 +161,7 @@ extern "C" {
 /** @endcond */
 
 /**
- * @brief xtimer configuration values
+ * @name    xtimer configuration values
  * @{
  */
 #define XTIMER_WIDTH                (16)
@@ -176,7 +171,7 @@ extern "C" {
 /** @} */
 
 /**
- * @brief Initialize board specific hardware, including clock, LEDs and std-IO
+ * @brief   Initialize board specific hardware, including clock, LEDs and std-IO
  */
 void board_init(void);
 

boards/waspmote-pro/include/periph_conf.h

@@ -26,14 +26,14 @@ extern "C" {
 #endif
 
 /**
- * @brief   Clock configuration
+ * @name    Clock configuration
  * @{
  */
 #define CLOCK_CORECLOCK     (14745600L)
 /** @} */
 
 /**
- * @name   Timer peripheral configuration
+ * @name    Timer peripheral configuration
  *
  * The ATmega1281 has 6 timers. Timer0 and Timer2 are 8 Bit Timers,
  * Timer0 has special uses too and therefore we'll avoid using it.
@@ -60,9 +60,8 @@ extern "C" {
 #define TIMER_1_ISRC        TIMER4_COMPC_vect
 /** @} */
 
-
 /**
- * @name   UART configuration
+ * @name    UART configuration
  *
  * The UART devices have fixed pin mappings, so all we need to do, is to specify
  * which devices we would like to use and their corresponding RX interrupts. See
@@ -85,11 +84,10 @@ extern "C" {
 #define UART_4800           (191)
 #define UART_9600           (95)
 #define UART_115200         (7)
-
 /** @} */
 
 /**
- * @name   SPI configuration
+ * @name    SPI configuration
  *
  * The atmega1281 has only one hardware SPI with fixed pin configuration, so all
  * we can do here, is to enable or disable it...