doc: fix unbalaced grouping

- most were trivial
    - missing group close or open
    - extra space
    - no doxygen comment
- name commad might open an implicit group
    this hould also be implicit cosed but does not happen somtimes
- crazy: internal declared groups have to be closed internal

boards/adafruit-clue/include/board.h

@@ -94,7 +94,7 @@ extern "C" {
 #define BACKLIGHT_MASK         (1 << 5)                             /**< Backlight pin mask */
 #define BACKLIGHT_ON           (NRF_P1->OUTSET = BACKLIGHT_MASK)    /**< Turn backlight on */
 #define BACKLIGHT_OFF          (NRF_P1->OUTCLR = BACKLIGHT_MASK)    /**< Turn backlight off */
-/** @ */
+/** @} */
 
 /**
  * @name    Display configuration

boards/adafruit-itsybitsy-nrf52/include/periph_conf.h

@@ -91,3 +91,4 @@ static const i2c_conf_t i2c_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/airfy-beacon/include/periph_conf.h

@@ -96,3 +96,4 @@ static const adc_conf_t adc_config[] = {3, 4, 5, 6};
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/arduino-nano-33-ble/include/periph_conf.h

@@ -88,3 +88,4 @@ static const spi_conf_t spi_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/atmega1284p/include/periph_conf.h

@@ -40,3 +40,4 @@ extern "C" {
 #include "periph_conf_atmega_common.h"
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/atmega256rfr2-xpro/include/periph_conf.h

@@ -30,3 +30,4 @@ extern "C" {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/atmega328p-xplained-mini/include/periph_conf.h

@@ -42,3 +42,4 @@ extern "C" {
 #include "periph_conf_atmega_common.h"
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/atmega328p/include/periph_conf.h

@@ -40,3 +40,4 @@ extern "C" {
 #include "periph_conf_atmega_common.h"
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/avr-rss2/include/board.h

@@ -57,6 +57,7 @@ extern "C" {
 #define LED1_OFF            (LED_PORT |=  LED1_MASK)
 #define LED1_ON             (LED_PORT &= ~LED1_MASK)
 #define LED1_TOGGLE         (LED_PORT ^=  LED1_MASK)
+/** @} */
 
 /**
  * @name    Usage of LED to turn on when a kernel panic occurs.
@@ -71,6 +72,7 @@ extern "C" {
  */
 #define DS18_PARAM_PIN      GPIO_PIN(PORT_D, 7)
 #define DS18_PARAM_PULL     (GPIO_IN_PU)
+/** @} */
 
 /**
  * @name xtimer configuration values
@@ -80,6 +82,7 @@ extern "C" {
 #define XTIMER_CHAN         (0)
 #define XTIMER_WIDTH        (16)
 #define XTIMER_HZ           (62500UL)
+/** @} */
 
 /**
  * @name Indicate Watchdog cleared in bootloader an
@@ -94,7 +97,7 @@ extern "C" {
 
 /**
  * @name CPU clock scale for avr-rss2
- *
+ * @{
  */
 #define CPU_ATMEGA_CLK_SCALE_INIT    CPU_ATMEGA_CLK_SCALE_DIV1
 /** @} */

boards/cc1352-launchpad/include/periph_conf.h

@@ -76,14 +76,6 @@ static const timer_conf_t timer_config[] = {
 * rts_pin.
 * @{
 */
-/**
- * @name    UART configuration
- *
- *
- * Add a second UART configuration if using external pins.
- * @{
- */
-
 static const uart_conf_t uart_config[] = {
     {
         .regs = UART0,

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

@@ -8,7 +8,7 @@
  * directory for more details.
  */
 
-/*
+/**
  * @defgroup    boards_common_arduino-atmega Arduino Atmega Common
  * @ingroup     boards_common
  * @brief       Shared files and configuration for Arduino Atmega boards.
@@ -93,7 +93,7 @@ extern "C" {
 
 /**
  * @name CPU clock scale for arduino boards
- *
+ * @{
  */
 #define CPU_ATMEGA_CLK_SCALE_INIT    CPU_ATMEGA_CLK_SCALE_DIV1
 /** @} */

boards/common/arduino-zero/include/arduino_pinmap.h

@@ -55,7 +55,7 @@ extern "C" {
 #define ARDUINO_PIN_A3          GPIO_PIN(PA, 4)
 #define ARDUINO_PIN_A4          GPIO_PIN(PA, 5)
 #define ARDUINO_PIN_A5          GPIO_PIN(PB, 2)
-/** @ */
+/** @} */
 
 /**
  * @name    Mapping of Arduino analog pins to RIOT ADC lines

boards/common/atmega/include/periph_conf_atmega_common.h

@@ -226,3 +226,4 @@ extern "C" {
 #endif
 
 #endif /* PERIPH_CONF_ATMEGA_COMMON_H */
+/** @} */

boards/common/nrf51/include/cfg_clock_16_0.h

@@ -45,3 +45,4 @@
 #endif
 
 #endif /* CFG_CLOCK_16_0_H */
+/** @} */

boards/common/nrf51/include/cfg_clock_16_1.h

@@ -45,3 +45,4 @@
 #endif
 
 #endif /* CFG_CLOCK_16_1_H */
+/** @} */

boards/common/nrf51/include/cfg_rtt_default.h

@@ -48,3 +48,4 @@ extern "C" {
 #endif
 
 #endif /* CFG_RTT_DEFAULT_H */
+/** @} */

boards/common/nrf51/include/cfg_timer_01.h

@@ -57,3 +57,4 @@ static const timer_conf_t timer_config[] = {
 #endif
 
 #endif /* CFG_TIMER_01_H */
+/** @} */

boards/common/nrf51/include/cfg_timer_012.h

@@ -64,3 +64,4 @@ static const timer_conf_t timer_config[] = {
 #endif
 
 #endif /* CFG_TIMER_012_H */
+/** @} */

boards/common/nucleo144/include/arduino_pinmap.h

@@ -74,7 +74,7 @@ extern "C" {
 #define ARDUINO_PIN_A4          GPIO_PIN(PORT_F, 5)
 #define ARDUINO_PIN_A5          GPIO_PIN(PORT_F, 10)
 #endif
-/** @ */
+/** @} */
 
 /**
  * @name    Mapping of Arduino analog pins to RIOT ADC lines

boards/common/nucleo64/include/arduino_pinmap.h

@@ -63,7 +63,7 @@ extern "C" {
 #define ARDUINO_PIN_A3          GPIO_PIN(PORT_B, 0)
 #define ARDUINO_PIN_A4          GPIO_PIN(PORT_C, 1)
 #define ARDUINO_PIN_A5          GPIO_PIN(PORT_C, 0)
-/** @ */
+/** @} */
 
 /**
  * @name    Mapping of Arduino analog pins to RIOT ADC lines

boards/common/particle-mesh/include/periph_conf_common.h

@@ -69,3 +69,4 @@ static const pwm_conf_t pwm_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_COMMON_H */
+/** @} */

boards/derfmega128/include/periph_conf.h

@@ -30,3 +30,4 @@ extern "C" {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/derfmega256/include/periph_conf.h

@@ -30,3 +30,4 @@ extern "C" {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/ek-lm4f120xl/include/board.h

@@ -62,7 +62,7 @@ extern "C" {
 #define LED2_ON             (LED_PORT |=  LED2_MASK)
 #define LED2_OFF            (LED_PORT &= ~LED2_MASK)
 #define LED2_TOGGLE         (LED_PORT ^=  LED2_MASK)
-/* @} */
+/** @} */
 
 /**
  * @name    ztimer configuration

boards/ek-lm4f120xl/include/periph_conf.h

@@ -66,6 +66,7 @@ static const timer_conf_t timer_config[] = {
 
 #define TIMER_0_ISR         isr_wtimer0a
 #define TIMER_1_ISR         isr_wtimer1a
+/** @} */
 
 /**
  * @name UART configuration

boards/esp32-ethernet-kit-v1_0/include/periph_conf.h

@@ -13,6 +13,7 @@
  * @file
  * @author      Gunar Schorcht <gunar@schorcht.net>
  * @author      Erik Ekman <eekman@google.com>
+ * @{
  */
 
 #ifndef PERIPH_CONF_H
@@ -39,6 +40,7 @@
 #ifndef ADC_GPIOS
 #define ADC_GPIOS   { GPIO34, GPIO35, GPIO36, GPIO39 }
 #endif
+/** @} */
 
 /**
  * @name    Declaration of GPIOs that can be used as DAC channels

boards/feather-nrf52840/include/periph_conf.h

@@ -88,3 +88,4 @@ static const i2c_conf_t i2c_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/hamilton/include/periph_conf.h

@@ -238,6 +238,7 @@ static const i2c_conf_t i2c_config[] = {
      }
 };
 #define I2C_NUMOF          ARRAY_SIZE(i2c_config)
+/** @} */
 
 /**
  * @name Random Number Generator configuration

boards/maple-mini/include/periph_conf.h

@@ -157,3 +157,4 @@ static const spi_conf_t spi_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/mcb2388/include/periph_conf.h

@@ -111,6 +111,7 @@ static const adc_conf_t adc_config[] = {
 };
 
 #define ADC_NUMOF           (1)
+/** @} */
 
 /**
  * @name I2C configuration

boards/mega-xplained/include/board.h

@@ -120,7 +120,7 @@ extern "C" {
 
 /**
  * @name CPU clock scale for mega-xplained
- *
+ * @{
  */
 #define CPU_ATMEGA_CLK_SCALE_INIT    CPU_ATMEGA_CLK_SCALE_DIV1
 /** @} */

boards/mega-xplained/include/periph_conf.h

@@ -49,3 +49,4 @@ extern "C" {
 #include "periph_conf_atmega_common.h"
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/msb-430/include/periph_conf.h

@@ -90,3 +90,4 @@ extern "C" {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

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

@@ -92,3 +92,4 @@ extern "C" {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/mulle/include/board.h

@@ -101,7 +101,6 @@ extern "C" {
  /** @todo Work around missing RESET pin on Mulle v0.6x
  *
  * {spi bus, spi speed, cs pin, int pin, reset pin, sleep pin}
- * @{
  */
 #define AT86RF2XX_PARAM_CS             SPI_HWCS(1)
 #define AT86RF2XX_PARAM_INT            GPIO_PIN(PORT_B, 9)

boards/nrf52832-mdk/include/periph_conf.h

@@ -45,3 +45,4 @@ extern "C" {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/nrf52840-mdk-dongle/include/periph_conf.h

@@ -74,3 +74,4 @@ static const pwm_conf_t pwm_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/nrf52840-mdk/include/periph_conf.h

@@ -58,3 +58,4 @@ static const uart_conf_t uart_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/nrf52840dongle/include/periph_conf.h

@@ -117,3 +117,4 @@ static const i2c_conf_t i2c_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/nucleo-wl55jc/include/arduino_pinmap.h

@@ -57,7 +57,7 @@ extern "C" {
 #define ARDUINO_PIN_A3          GPIO_PIN(PORT_B, 4)
 #define ARDUINO_PIN_A4          GPIO_PIN(PORT_B, 14)
 #define ARDUINO_PIN_A5          GPIO_PIN(PORT_B, 13)
-/** @ */
+/** @} */
 
 /**
  * @name    Mapping of Arduino analog pins to RIOT ADC lines

boards/opencm904/include/periph_conf.h

@@ -101,3 +101,4 @@ static const uart_conf_t uart_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/openlabs-kw41z-mini/include/periph_conf.h

@@ -237,6 +237,7 @@ typedef struct {
     uint8_t chan_numof;     /**< number of actually configured channels */
     uint8_t tpm_num;        /**< FTM number used */
 } pwm_conf_t;
+/** @} */
 
 /**
  * @name    PWM configuration

boards/openmote-b/include/board.h

@@ -112,6 +112,7 @@
 #define OPENWSN_DEBUGPIN_FSM    GPIO_PIN(1, 2) /* B2 */
 #define OPENWSN_DEBUGPIN_TASK   GPIO_PIN(1, 1) /* B1 */
 #define OPENWSN_DEBUGPIN_RADIO  GPIO_PIN(1, 0) /* B0 */
+/** @} */
 
 /**
  * @name    AT86RF215 configuration

boards/p-nucleo-wb55/include/arduino_pinmap.h

@@ -58,7 +58,7 @@ extern "C" {
 #define ARDUINO_PIN_A3          GPIO_PIN(PORT_A, 0)
 #define ARDUINO_PIN_A4          GPIO_PIN(PORT_C, 3)
 #define ARDUINO_PIN_A5          GPIO_PIN(PORT_C, 2)
-/** @ */
+/** @} */
 
 /**
  * @name    Mapping of Arduino analog pins to RIOT ADC lines

boards/particle-argon/include/periph_conf.h

@@ -65,3 +65,4 @@ static const uart_conf_t uart_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/particle-boron/include/periph_conf.h

@@ -65,3 +65,4 @@ static const uart_conf_t uart_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/particle-xenon/include/periph_conf.h

@@ -65,3 +65,4 @@ static const uart_conf_t uart_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/phynode-kw41z/include/board.h

@@ -60,6 +60,7 @@ extern "C"
 #define LED3_ON             (GPIOB->PCOR = LED3_MASK)
 #define LED3_OFF            (GPIOB->PSOR = LED3_MASK)
 #define LED3_TOGGLE         (GPIOB->PTOR = LED3_MASK)
+/** @} */
 
 /**
  * @name    Button pin definitions

boards/pic32-wifire/include/gpio_params.h

@@ -68,3 +68,4 @@ static const saul_gpio_params_t saul_gpio_params[] =
 #endif
 
 #endif /* GPIO_PARAMS_H */
+/** @} */

boards/pinetime/include/board.h

@@ -61,7 +61,7 @@ extern "C" {
 #endif
 #define BACKLIGHT_ON                (NRF_P0->OUTCLR = BACKLIGHT_MASK)
 #define BACKLIGHT_OFF               (NRF_P0->OUTSET = BACKLIGHT_MASK)
-/** @ */
+/** @} */
 
 /**
  * @name LCD configuration

boards/reel/include/board.h

@@ -98,6 +98,7 @@ extern "C" {
 
 /**
  * @name    Digital proximity and ambient light sensor configuration (ADPS9960)
+ * @{
  */
 #define ADPS9960_PARAM_I2C      I2C_DEV(0)
 #define ADPS9960_PARAM_ADDR     (0x29)

boards/reel/include/periph_conf.h

@@ -73,3 +73,4 @@ static const spi_conf_t spi_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/same54-xpro/include/periph_conf.h

@@ -392,6 +392,7 @@ static const sam0_common_gmac_config_t sam_gmac_config[] = {
         .int_pin = GPIO_PIN(PD, 12),
     }
 };
+/** @} */
 
 #ifdef __cplusplus
 }

boards/samr30-xpro/include/periph_conf.h

@@ -194,6 +194,7 @@ static const sam0_common_usb_config_t sam_usbdev_config[] = {
         .gclk_src = SAM0_GCLK_48MHZ,
     }
 };
+/** @} */
 
 #ifdef __cplusplus
 }

boards/sensebox_samd21/include/periph_conf.h

@@ -181,6 +181,7 @@ static const spi_conf_t spi_config[] = {
 };
 
 #define SPI_NUMOF           ARRAY_SIZE(spi_config)
+/** @} */
 
 /**
  * @name    I2C configuration
@@ -208,6 +209,7 @@ static const i2c_conf_t i2c_config[] = {
 };
 
 #define I2C_NUMOF          ARRAY_SIZE(i2c_config)
+/** @} */
 
 /**
  * @name RTT configuration

boards/sodaq-explorer/include/board.h

@@ -42,6 +42,7 @@ extern "C" {
 
 /**
  * @name    User button
+ * @{
  */
 #define BTN0_PIN            GPIO_PIN(PA, 14)
 #define BTN0_MODE           GPIO_IN_PU

boards/sodaq-one/include/board.h

@@ -60,6 +60,7 @@ extern "C" {
 
 /**
  * @name    User button
+ * @{
  */
 #define BTN0_PIN            GPIO_PIN(PA, 16)
 #define BTN0_MODE           GPIO_IN
@@ -67,6 +68,7 @@ extern "C" {
 
 /**
  * @name    GPS Time Pulse
+ * @{
  */
 #define GPS_TIMEPULSE_PIN   GPIO_PIN(PA, 14)
 #define GPS_TIMEPULSE_MODE  GPIO_IN

boards/sodaq-sara-sff/include/board.h

@@ -72,6 +72,7 @@ extern "C" {
 
 /**
  * @name    User button
+ * @{
  */
 #define BTN0_PIN            GPIO_PIN(PB, 8)
 #define BTN0_MODE           GPIO_IN

boards/stm32f0discovery/include/periph_conf.h

@@ -145,3 +145,4 @@ static const spi_conf_t spi_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/stm32f3discovery/include/periph_conf.h

@@ -213,3 +213,4 @@ static const i2c_conf_t i2c_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/stm32f4discovery/include/arduino_pinmap.h

@@ -41,7 +41,7 @@ extern "C" {
 #define ARDUINO_PIN_5           GPIO_PIN(PORT_A, 15)
 #define ARDUINO_PIN_6           GPIO_PIN(PORT_B, 1)
 #define ARDUINO_PIN_7           GPIO_PIN(PORT_B, 2)
-/** @ */
+/** @} */
 
 /**
  * @name    Mapping of Arduino analog pins to RIOT ADC lines

boards/stm32l0538-disco/include/periph_conf.h

@@ -110,3 +110,4 @@ static const spi_conf_t spi_config[] = {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/stm32mp157c-dk2/include/board.h

@@ -14,8 +14,6 @@
  * @brief       Board specific definitions for the STM32MP157C-DK2 board
  *
  * @author      Gilles DOFFE <gilles.doffe@savoirfairelinux.com>
- *
- * @}
  */
 
 #ifndef BOARD_H

boards/telosb/include/periph_conf.h

@@ -90,3 +90,4 @@ extern "C" {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/ublox-c030-u201/include/arduino_pinmap.h

@@ -58,7 +58,7 @@ extern "C" {
 #define ARDUINO_PIN_A3          GPIO_PIN(PORT_A, 4)
 #define ARDUINO_PIN_A4          GPIO_PIN(PORT_B, 7)
 #define ARDUINO_PIN_A5          GPIO_PIN(PORT_B, 6)
-/** @ */
+/** @} */
 
 /**
  * @name    Mapping of Arduino analog pins to RIOT ADC lines

boards/waspmote-pro/include/board.h

@@ -152,7 +152,7 @@ extern "C" {
 
 /**
  * @name CPU clock scale for waspmote-pro
- *
+ * @{
  */
 #define CPU_ATMEGA_CLK_SCALE_INIT    CPU_ATMEGA_CLK_SCALE_DIV1
 /** @} */

boards/waspmote-pro/include/periph_conf.h

@@ -41,3 +41,4 @@ extern "C" {
 #include "periph_conf_atmega_common.h"
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/yunjia-nrf51822/include/periph_conf.h

@@ -93,3 +93,4 @@ static const adc_conf_t adc_config[] = {4, 5, 6, 7};
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/z1/include/periph_conf.h

@@ -89,3 +89,4 @@ extern "C" {
 #endif
 
 #endif /* PERIPH_CONF_H */
+/** @} */

boards/zigduino/include/board.h

@@ -46,6 +46,7 @@ extern "C" {
 
 /**
  * @name    Grove PIR Motion sensor
+ * @{
  */
 #define PIR_MOTION_PIN      GPIO_PIN(PORT_D, 4)
 #define PIR_MOTION_MODE     GPIO_IN_PU

cpu/kinetis/include/mcg.h

@@ -8,7 +8,7 @@
  */
 
 /* please doxygen by hiding dangling references */
-#if defined(MODULE_PERIPH_MCG) || defined(MODULE_PERIPH_MCG_LITE)
+#if defined(MODULE_PERIPH_MCG) || defined(MODULE_PERIPH_MCG_LITE) || defined(DOXYGEN)
 /**
  * @defgroup    cpu_kinetis_mcg Kinetis MCG
  * @ingroup     cpu_kinetis

cpu/lpc23xx/include/periph_cpu.h

@@ -31,6 +31,7 @@ extern "C" {
  * @{
  */
 #define __IO volatile
+/** @} */
 
 /**
  * @name    Power mode configuration

cpu/nrf52/include/periph_cpu.h

@@ -127,6 +127,7 @@ typedef enum {
 
 /**
  * @brief   I2C (TWI) configuration options
+ * @{
  */
 typedef struct {
     NRF_TWIM_Type *dev;         /**< TWIM hardware device */

cpu/nrf9160/include/periph_cpu.h

@@ -100,6 +100,7 @@ typedef enum {
 
 /**
  * @brief   I2C (TWI) configuration options
+ * @{
  */
 typedef struct {
     NRF_TWIM_Type *dev;         /**< TWIM hardware device */

cpu/qn908x/include/periph_cpu.h

@@ -328,7 +328,6 @@ typedef enum {
  * lines in the board, just using different adc_conf_t entries.
  */
 typedef uint16_t adc_conf_t;
-/** @} */
 
 /**
  * @brief   CPU specific timer Counter/Timers (CTIMER) configuration

dist/tools/doccheck/check.sh

@@ -13,6 +13,7 @@
 SCRIPTDIR="$(cd "$(dirname "$0")"; pwd)"
 RIOTBASE="$(cd "${SCRIPTDIR}"/../../..; pwd)"
 EXCLUDE_PATTERN_FILE="${SCRIPTDIR}/exclude_patterns"
+GENERIC_EXCLUDE_PATTERN_FILE="${SCRIPTDIR}/generic_exclude_patterns"
 
 . "${RIOTBASE}"/dist/tools/ci/github_annotate.sh
 
@@ -28,7 +29,7 @@ else
     CRESET=
 fi
 
-DOXY_OUTPUT=$(make -C "${RIOTBASE}" doc 2>&1 | grep -Evf "${EXCLUDE_PATTERN_FILE}")
+DOXY_OUTPUT=$(make -C "${RIOTBASE}" doc 2>&1 | grep -Evf "${EXCLUDE_PATTERN_FILE}" -f"${GENERIC_EXCLUDE_PATTERN_FILE}")
 DOXY_ERRCODE=$?
 RESULT=0
 

dist/tools/doccheck/generic_exclude_patterns

@@ -0,0 +1,19 @@
+warning: Member BTN[0-9]_INT_FLANK \(macro definition\) of
+warning: Member BTN[0-9]_MASK \(macro definition\) of
+warning: Member BTN[0-9]_MODE \(macro definition\) of
+warning: Member BTN[0-9]_PIN \(macro definition\) of
+warning: Member BTN[0-9]_PORT \(macro definition\) of
+warning: Member BTN[0-9]_PRESSED \(macro definition\) of
+warning: Member BTN[0-9]_RELEASED \(macro definition\) of
+warning: Member LED[0-9]_ENABLE_PORT \(macro definition\) of
+warning: Member LED[0-9]_IS_INVERTED \(macro definition\) of
+warning: Member LED[0-9]_MASK \(macro definition\) of
+warning: Member LED[0-9]_MODE \(macro definition\) of
+warning: Member LED[0-9]_NAME \(macro definition\) of
+warning: Member LED[0-9]_OFF \(macro definition\) of
+warning: Member LED[0-9]_ON \(macro definition\) of
+warning: Member LED[0-9]_PIN \(macro definition\) of
+warning: Member LED[0-9]_PIN_NUM \(macro definition\) of
+warning: Member LED[0-9]_PORT \(macro definition\) of
+warning: Member LED[0-9]_PORT_NUM \(macro definition\) of
+warning: Member LED[0-9]_TOGGLE \(macro definition\) of

drivers/ads101x/include/ads101x_regs.h

@@ -98,6 +98,7 @@ extern "C" {
 #define ADS101X_DATAR_1600    ((1 << 7) | (0 << 6) | (0 << 5))
 #define ADS101X_DATAR_2400    ((1 << 7) | (0 << 6) | (1 << 5))
 #define ADS101X_DATAR_3300    ((1 << 7) | (1 << 6) | (0 << 5))
+/** @} */
 
 #ifdef __cplusplus
 }

drivers/at25xxx/include/at25xxx_params.h

@@ -14,7 +14,6 @@
  * @brief       Default configuration for the M95M01 EEPROM
  *
  * @author      Benjamin Valentin <benjamin.valentin@ml-pa.com>
- * @}
  */
 
 #ifndef AT25XXX_PARAMS_H
@@ -65,6 +64,7 @@ extern "C" {
                                   .size = AT25XXX_PARAM_SIZE,       \
                                   .page_size = AT25XXX_PARAM_PAGE_SIZE }
 #endif
+/** @} */
 
 /**
  * @brief   AT25XXX configuration
@@ -79,3 +79,4 @@ static const at25xxx_params_t at25xxx_params[] =
 #endif
 
 #endif /* AT25XXX_PARAMS_H */
+/** @} */

drivers/at86rf215/include/at86rf215_netdev.h

@@ -14,7 +14,6 @@
  * @brief       Netdev interface to AT86RF215 driver
  *
  * @author      Benjamin Valentin <benjamin.valentin@ml-pa.com>
- * @}
  */
 
 #ifndef AT86RF215_NETDEV_H

drivers/at86rf215/include/at86rf215_params.h

@@ -14,7 +14,6 @@
  * @brief       Default configuration for the AT86RF215 driver
  *
  * @author      Benjamin Valentin <benjamin.valentin@ml-pa.com>
- * @}
  */
 
 #ifndef AT86RF215_PARAMS_H

drivers/at86rf215/include/at86rf215_registers.h

@@ -14,7 +14,6 @@
  * @brief       Register Definitions for the AT86RF215 chip
  *
  * @author      Benjamin Valentin <benjamin.valentin@ml-pa.com>
- * @}
  */
 
 #ifndef AT86RF215_REGISTERS_H
@@ -609,10 +608,9 @@ static const struct at86rf215_BBC_regs BBC1_regs = {
 /** Lower values increase the preamble detector sensitivity. */
 #define FSKC3_PDT(n)  (((n) << FSKC3_PDT_SHIFT) & FSKC3_PDT_MASK)
 
-/** @} */
-
 #ifdef __cplusplus
 }
 #endif
 
 #endif /* AT86RF215_REGISTERS_H */
+/** @} */

drivers/at86rf2xx/include/at86rf2xx_registers.h

@@ -170,6 +170,7 @@ extern "C" {
 
 /* Map TX_END and RX_END to TRX_END to be compatible to SPI Devices */
 #define AT86RF2XX_IRQ_STATUS_MASK__TRX_END                      (0x48)
+/** @} */
 
 /**
  * @name   Bitfield definitions for the IRQ_MASK1/IRQ_STATUS1 register
@@ -532,6 +533,7 @@ extern "C" {
 #define AT86RF2XX_TRX_RPC_MASK__PLL_RPC_EN                      (0x08)
 #define AT86RF2XX_TRX_RPC_MASK__XAH_TX_RPC_EN                   (0x04)
 #define AT86RF2XX_TRX_RPC_MASK__IPAN_RPC_EN                     (0x02)
+/** @} */
 
 /**
  * @brief   Bits to set to enable smart idle

drivers/ata8520e/include/ata8520e_internals.h

@@ -85,3 +85,4 @@ extern "C" {
 #endif
 
 #endif /* ATA8520E_INTERNALS_H */
+/** @} */

drivers/ata8520e/include/ata8520e_params.h

@@ -72,3 +72,4 @@ static const ata8520e_params_t ata8520e_params[] =
 #endif
 
 #endif /* ATA8520E_PARAMS_H */
+/** @} */

drivers/cc2420/include/cc2420_registers.h

@@ -36,7 +36,7 @@ extern "C" {
 /** @} */
 
 /**
- * @name    Possible device state change commands
+ * @name    device state change commands
  * @{
  */
 enum {
@@ -46,9 +46,11 @@ enum {
     CC2420_GOTO_TXON,       /**< transmit packet without CCA */
     CC2420_GOTO_TXONCCA     /**< transmit packet using CCA */
 };
+/** @} */
 
 /**
  * @name    (Selected) device states
+ * @{
  */
 enum {
     CC2420_STATE_PD          = 0,   /**< power down */
@@ -57,6 +59,7 @@ enum {
     CC2420_STATE_RX_SEARCH   = 6,   /**< receive SFD search */
     CC2420_STATE_RX_OVERFLOW = 17   /**< receive buffer overflow */
 };
+/** @} */
 
 /**
  * @name    CC2420 SPI commands

drivers/dac_dds/include/dac_dds_params.h

@@ -14,7 +14,6 @@
  * @brief       Default configuration for the DAC DDS driver
  *
  * @author      Benjamin Valentin <benpicco@beuth-hochschule.de>
- * @}
  */
 
 #ifndef DAC_DDS_PARAMS_H
@@ -47,7 +46,7 @@ extern "C" {
                                   .timer_hz = DAC_DDS_PARAM_TIMER_HZ, \
                                 }
 #endif
-/**@}*/
+/** @} */
 
 /**
  * @brief   DAC DDS configuration

drivers/enc28j60/include/enc28j60_params.h

@@ -56,7 +56,6 @@ extern "C" {
 static const  enc28j60_params_t enc28j60_params[] = {
     ENC28J60_PARAMS
 };
-/** @} */
 
 #ifdef __cplusplus
 }

drivers/encx24j600/include/encx24j600_defines.h

@@ -194,7 +194,8 @@ extern "C" {
 /** @} */
 
 /**
- * @name    ERXFCON bits
+ * @brief    ERXFCON bits
+ * @{
  */
 #define ENC_MCEN        (1<<1)
 /** @} */

drivers/ethos/include/ethos_params.h

@@ -29,7 +29,6 @@ extern "C" {
 #define ETHOS_PARAMS        { .uart = ETHOS_UART,   \
                               .baudrate = ETHOS_BAUDRATE }
 #endif
-/** @} */
 
 /**
  * @brief   ethos configuration

drivers/hmc5883l/include/hmc5883l_regs.h

@@ -73,3 +73,4 @@ extern "C"
 #endif
 
 #endif /* HMC5883L_REGS_H */
+/** @} */

drivers/include/at86rf215.h

@@ -298,6 +298,7 @@ typedef enum {
     AT86RF215_CLKO_2_MHz,           /**<  2 MHz */
     AT86RF215_CLKO_1_MHz,           /**<  1 MHz */
 } at86rf215_clko_freq_t;
+/** @} */
 
 /**
  * @name    Internal device option flags

drivers/include/at86rf2xx.h

@@ -263,7 +263,6 @@ typedef struct {
     /* Only radios with the XAH_CTRL_2 register support frame retry reporting */
     int8_t tx_retries;                  /**< Number of NOACK retransmissions */
 #endif
-    /** @} */
 } at86rf2xx_t;
 
 /**

drivers/include/lm75.h

@@ -15,7 +15,6 @@
  *
  * @author      Vitor Batista <vitor.batista@ml-pa.com>
  *
- * @}
  */
 
 /**

drivers/include/tmp00x.h

@@ -166,6 +166,8 @@ extern "C"
 #define TMP00X_CONFIG_CR_AS8       (0x03)   /**< Conversion Time 2s, AVG Samples: 8 */
 #define TMP00X_CONFIG_CR_AS16      (0x04)   /**< Conversion Time 4s, AVG Samples: 16 */
 #define TMP00X_CONFIG_CR_DEF       TMP00X_CONFIG_CR_AS4 /**< Default for Testing */
+/** @} */
+
 
 /**
  * @name    Constants for TMP00X calibration

drivers/include/usbdev_mock.h

@@ -30,11 +30,13 @@ extern "C" {
 
 /**
  * @name usbdev mock device endpoint states
+ * @{
  */
 typedef enum {
     EP_STATE_READY,             /**< Endpoint is ready/idle */
     EP_STATE_DATA_AVAILABLE,    /**< Endpoint has data      */
 } usbdev_mock_ep_state_t;
+/** @} */
 
 /**
  * @brief usbdev mock device endpoint
@@ -114,4 +116,3 @@ void usbdev_mock_setup(usbdev_mock_esr_cb_t esr_cb,
 
 #endif /* USBDEV_MOCK_H */
 /** @} */
-/** @} */

drivers/include/w5100.h

@@ -87,4 +87,4 @@ void w5100_setup(w5100_t *dev, const w5100_params_t *params, uint8_t index);
 #endif
 
 #endif /* W5100_H */
-/* @} */
+/** @} */

drivers/itg320x/include/itg320x_regs.h

@@ -72,3 +72,4 @@ extern "C"
 #endif
 
 #endif /* ITG320X_REGS_H */
+/** @} */

drivers/l3g4200d/include/l3g4200d-regs.h

@@ -74,6 +74,7 @@
 
 /**
  * @name    CTRL4 bitfields
+ * @{
  */
 #define L3G4200D_CTRL4_BDU              0x80
 #define L3G4200D_CTRL4_BLE              0x40