Merge pull request #11814 from aabadie/pr/doc/remove_duplicate_group_define

doc: remove duplicate definitions of Doxygen groups

boards/arduino-leonardo/include/board.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_arduino-leonardo Arduino Leonardo
+ * @ingroup     boards_arduino-leonardo
- * @ingroup     boards
- * @brief       Support for the Arduino Leonardo board
  * @{
  *
  * @file

boards/common/esp32/board_common.c

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_common_esp32 ESP32 Board Commons
+ * @ingroup     boards_common_esp32
- * @ingroup     boards_common
- * @brief       Common definitions for all ESP32 boards
  * @{
  *
  * @file

boards/common/esp8266/board_common.c

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_common_esp8266 ESP8266 Common
+ * @ingroup     boards_common_esp8266
- * @ingroup     boards_common
- * @brief       Common files for the esp8266 board.
  * @{
  *
  * @file

boards/esp8266-esp-12x/include/board.h

@@ -7,8 +7,7 @@
  */
 
 /**
- * @defgroup    boards_esp8266_esp-12x  ESP-12x based boards
+ * @ingroup     boards_esp8266_esp-12x
- * @ingroup     boards_esp8266
  */
 
 /**

boards/esp8266-olimex-mod/include/board.h

@@ -7,8 +7,7 @@
  */
 
 /**
- * @defgroup    boards_esp8266_olimex-mod Olimex MOD-WIFI-ESP8266-DEV
+ * @ingroup     boards_esp8266_olimex-mod
- * @ingroup     boards_esp8266
  */
 
 /**

boards/esp8266-sparkfun-thing/include/board.h

@@ -7,8 +7,7 @@
  */
 
 /**
- * @defgroup    boards_esp8266_sparkfun-thing SparkFun ESP8266 Thing
+ * @ingroup     boards_esp8266_sparkfun-thing
- * @ingroup     boards_esp8266
  */
 
 /**

boards/nucleo-f030r8/include/periph_conf.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-f030r8 STM32 Nucleo-F030R8
+ * @ingroup     boards_nucleo-f030r8
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-F030R8
  * @{
  *
  * @file

boards/nucleo-f070rb/include/periph_conf.h

@@ -8,9 +8,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-f070rb STM32 Nucleo-F070RB
+ * @ingroup     boards_nucleo-f070rb
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-F070RB
  * @{
  *
  * @file

boards/nucleo-f072rb/include/periph_conf.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-f072rb STM32 Nucleo-F072RB
+ * @ingroup     boards_nucleo-f072rb
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-F072RB
  * @{
  *
  * @file

boards/nucleo-f091rc/include/periph_conf.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-f091rc STM32 Nucleo-F091RC
+ * @ingroup     boards_nucleo-f091rc
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-F091RC
  * @{
  *
  * @file

boards/nucleo-f103rb/include/periph_conf.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-f103rb STM32 Nucleo-F103RB
+ * @ingroup     boards_nucleo-f103rb
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-F103RB
  * @{
  *
  * @file

boards/nucleo-f302r8/include/periph_conf.h

@@ -9,9 +9,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-f302r8 STM32 Nucleo-F302R8
+ * @ingroup     boards_nucleo-f302r8
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-F302R8
  * @{
  *
  * @file

boards/nucleo-f303k8/include/periph_conf.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-f303k8 STM32 Nucleo-F303K8
+ * @ingroup     boards_nucleo-f303k8
- * @ingroup     boards_common_nucleo32
- * @brief       Support for the STM32 Nucleo-F303K8
  * @{
  *
  * @file

boards/nucleo-f303re/include/periph_conf.h

@@ -8,9 +8,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-f303re STM32 Nucleo-F303RE
+ * @ingroup     boards_nucleo-f303re
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-F303RE
  * @{
  *
  * @file

boards/nucleo-f303ze/include/periph_conf.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-f303ze STM32 Nucleo-F303ZE
+ * @ingroup     boards_nucleo-f303ze
- * @ingroup     boards_common_nucleo144
- * @brief       Support for the STM32 Nucleo-F303ZE
  * @{
  *
  * @file

boards/nucleo-f334r8/include/periph_conf.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-f334r8 STM32 Nucleo-F334R8
+ * @ingroup     boards_nucleo-f334r8
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-F334R8
  * @{
  *
  * @file

boards/nucleo-f401re/include/periph_conf.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-f401re STM32 Nucleo-F401RE
+ * @ingroup     boards_nucleo-f401re
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-F401RE
  * @{
  *
  * @file

boards/nucleo-f410rb/include/periph_conf.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-f410rb STM32 Nucleo-F410RB
+ * @ingroup     boards_nucleo-f410rb
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-F410RB
  * @{
  *
  * @file

boards/nucleo-f411re/include/periph_conf.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-f411re STM32 Nucleo-F411RE
+ * @ingroup     boards_nucleo-f411re
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-F411RE
  * @{
  *
  * @file

boards/nucleo-f446re/include/periph_conf.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-f446re STM32 Nucleo-F446RE
+ * @ingroup     boards_nucleo-f446re
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-F446RE
  * @{
  *
  * @file

boards/nucleo-f446ze/include/periph_conf.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-f446ze STM32 Nucleo-F446ZE
+ * @ingroup     boards_nucleo-f446ze
- * @ingroup     boards_common_nucleo144
- * @brief       Support for the STM32 Nucleo-F446ZE
  * @{
  *
  * @file

boards/nucleo-l053r8/include/periph_conf.h

@@ -8,9 +8,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-l053r8 STM32 Nucleo-L053R8
+ * @ingroup     boards_nucleo-l053r8
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-L053R8
  * @{
  *
  * @file

boards/nucleo-l073rz/include/periph_conf.h

@@ -8,9 +8,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-l073rz STM32 Nucleo-L073RZ
+ * @ingroup     boards_nucleo-l073rz
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-L073RZ
  * @{
  *
  * @file

boards/nucleo-l152re/include/periph_conf.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-l152re STM32 Nucleo-L152RE
+ * @ingroup     boards_nucleo-l152re
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-L152RE
  * @{
  *
  * @file

boards/nucleo-l476rg/include/periph_conf.h

@@ -9,9 +9,7 @@
  */
 
 /**
- * @defgroup    boards_nucleo-l476rg STM32 Nucleo-L476RG
+ * @ingroup     boards_nucleo-l476rg
- * @ingroup     boards_common_nucleo64
- * @brief       Support for the STM32 Nucleo-L476RG
  * @{
  *
  * @file

boards/stm32f769i-disco/include/board.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    boards_stm32f769i-disco STM32F769I-DISCO board
+ * @ingroup     boards_stm32f769i-disco
- * @ingroup     boards
- * @brief       Support for the STM32F769I-DISCO board
  * @{
  *
  * @file

core/include/native_sched.h

@@ -7,9 +7,9 @@
  */
 
 /**
- * @defgroup    core_sched Scheduler
+ * @defgroup    core_sched_native Scheduler for native
- * @ingroup     core
+ * @ingroup     core_sched
- * @brief       The RIOT scheduler
+ * @brief       The RIOT scheduler for the native platform
  * @details
  *
  * @{

cpu/efm32/include/cpu_conf.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    cpu_efm32 Silicon Labs EFM32/EFR32/EZR32
+ * @ingroup     cpu_efm32
- * @ingroup     cpu
- * @brief       Support for Silicon Labs EFM32/EFR32/EZR32 CPUs
  * @{
  *
  * @file

pkg/lwip/doc.txt

@@ -4,4 +4,7 @@
  * @ingroup  net
  * @brief    Provides the lwIP network stack
  * @see      http://savannah.nongnu.org/projects/lwip/
+ *
+ * lwIP is a lightweight TCP/IP stack primarily for usage with Ethernet.
+ * It can be used with the @ref sock API.
  */

pkg/lwip/include/lwip.h

@@ -7,13 +7,7 @@
  */
 
 /**
- * @defgroup    pkg_lwip    lwIP
+ * @ingroup     pkg_lwip
- * @ingroup     pkg
- * @brief       A lightweight TCP/IP stack
- * @see         http://savannah.nongnu.org/projects/lwip/
- *
- * lwIP is a lightweight TCP/IP stack primarily for usage with Ethernet.
- * It can be used with the the @ref conn.
  *
  * @{
  *

sys/hashes/sha1.c

@@ -11,14 +11,12 @@
  */
 
 /**
- * @defgroup    sys_hashes_sha1 SHA-1
+ * @ingroup     sys_hashes_sha1
- * @ingroup     sys_hashes
- * @brief       Implementation of the SHA-1 hashing function
 
  * @{
  *
  * @file
- * @brief       SHA-1 interface definition
+ * @brief       Implementation of the SHA-1 hashing function
  *
  * @author      Wei Dai and others
  * @author      Oliver Hahm <oliver.hahm@inria.fr>

sys/include/net/gnrc/tcp/config.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    net_gnrc_tcp TCP
+ * @ingroup     net_gnrc_tcp
- * @ingroup     net_gnrc
- * @brief       RIOT's TCP implementation for the GNRC network stack.
  *
  * @{
  *

sys/include/net/gnrc/tcp/tcb.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    net_gnrc_tcp TCP
+ * @ingroup     net_gnrc_tcp
- * @ingroup     net_gnrc
- * @brief       RIOT's TCP implementation for the GNRC network stack.
  *
  * @{
  *

sys/net/gnrc/sock/include/gnrc_sock_internal.h

@@ -7,15 +7,12 @@
  */
 
 /**
- * @defgroup    net_gnrc_sock   GNRC-specific implementation of the sock API
+ * @ingroup     net_gnrc_sock
- * @ingroup     net_gnrc
- * @brief       Provides an implementation of the @ref net_sock by the
- *              @ref net_gnrc
  *
  * @{
  *
  * @file
- * @brief   GNRC-specific types and function definitions
+ * @brief   Internal GNRC-specific types and function definitions
  *
  * @author  Martine Lenders <mlenders@inf.fu-berlin.de>
  */

sys/net/gnrc/transport_layer/tcp/internal/common.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    net_gnrc_tcp TCP
+ * @ingroup     net_gnrc_tcp
- * @ingroup     net_gnrc
- * @brief       RIOT's TCP implementation for the GNRC network stack.
  *
  * @{
  *

sys/net/gnrc/transport_layer/tcp/internal/eventloop.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    net_gnrc_tcp TCP
+ * @ingroup     net_gnrc_tcp
- * @ingroup     net_gnrc
- * @brief       RIOT's TCP implementation for the GNRC network stack.
  *
  * @{
  *

sys/net/gnrc/transport_layer/tcp/internal/fsm.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    net_gnrc_tcp TCP
+ * @ingroup     net_gnrc_tcp
- * @ingroup     net_gnrc
- * @brief       RIOT's TCP implementation for the GNRC network stack.
  *
  * @{
  *

sys/net/gnrc/transport_layer/tcp/internal/option.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    net_gnrc_tcp TCP
+ * @ingroup     net_gnrc_tcp
- * @ingroup     net_gnrc
- * @brief       RIOT's TCP implementation for the GNRC network stack.
  *
  * @{
  *

sys/net/gnrc/transport_layer/tcp/internal/pkt.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    net_gnrc_tcp TCP
+ * @ingroup     net_gnrc_tcp
- * @ingroup     net_gnrc
- * @brief       RIOT's TCP implementation for the GNRC network stack.
  *
  * @{
  *

sys/net/gnrc/transport_layer/tcp/internal/rcvbuf.h

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup    net_gnrc_tcp TCP
+ * @ingroup     net_gnrc_tcp
- * @ingroup     net_gnrc
- * @brief       RIOT's TCP implementation for the GNRC network stack.
  *
  * @{
  *

sys/posix/pthread/pthread.c

@@ -7,9 +7,7 @@
  */
 
 /**
- * @defgroup pthread POSIX threads
+ * @ingroup pthread
- * POSIX conforming multi-threading features.
- * @ingroup posix
  * @{
  * @file
  * @brief   Thread creation features.