diff --git a/boards/arduino-leonardo/include/board.h b/boards/arduino-leonardo/include/board.h index a0186a2b7f..17078925c7 100644 --- a/boards/arduino-leonardo/include/board.h +++ b/boards/arduino-leonardo/include/board.h @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_arduino-leonardo Arduino Leonardo - * @ingroup boards - * @brief Support for the Arduino Leonardo board + * @ingroup boards_arduino-leonardo * @{ * * @file diff --git a/boards/common/esp32/board_common.c b/boards/common/esp32/board_common.c index f5fa4df3ac..d57222ff60 100644 --- a/boards/common/esp32/board_common.c +++ b/boards/common/esp32/board_common.c @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_common_esp32 ESP32 Board Commons - * @ingroup boards_common - * @brief Common definitions for all ESP32 boards + * @ingroup boards_common_esp32 * @{ * * @file diff --git a/boards/common/esp8266/board_common.c b/boards/common/esp8266/board_common.c index c7b25d16e2..2b703b2b13 100644 --- a/boards/common/esp8266/board_common.c +++ b/boards/common/esp8266/board_common.c @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_common_esp8266 ESP8266 Common - * @ingroup boards_common - * @brief Common files for the esp8266 board. + * @ingroup boards_common_esp8266 * @{ * * @file diff --git a/boards/esp8266-esp-12x/include/board.h b/boards/esp8266-esp-12x/include/board.h index eafc405183..1ab77c25fe 100644 --- a/boards/esp8266-esp-12x/include/board.h +++ b/boards/esp8266-esp-12x/include/board.h @@ -7,8 +7,7 @@ */ /** - * @defgroup boards_esp8266_esp-12x ESP-12x based boards - * @ingroup boards_esp8266 + * @ingroup boards_esp8266_esp-12x */ /** diff --git a/boards/esp8266-olimex-mod/include/board.h b/boards/esp8266-olimex-mod/include/board.h index 20c0e53527..38e540409e 100644 --- a/boards/esp8266-olimex-mod/include/board.h +++ b/boards/esp8266-olimex-mod/include/board.h @@ -7,8 +7,7 @@ */ /** - * @defgroup boards_esp8266_olimex-mod Olimex MOD-WIFI-ESP8266-DEV - * @ingroup boards_esp8266 + * @ingroup boards_esp8266_olimex-mod */ /** diff --git a/boards/esp8266-sparkfun-thing/include/board.h b/boards/esp8266-sparkfun-thing/include/board.h index 7f80ced168..e40f67ac7a 100644 --- a/boards/esp8266-sparkfun-thing/include/board.h +++ b/boards/esp8266-sparkfun-thing/include/board.h @@ -7,8 +7,7 @@ */ /** - * @defgroup boards_esp8266_sparkfun-thing SparkFun ESP8266 Thing - * @ingroup boards_esp8266 + * @ingroup boards_esp8266_sparkfun-thing */ /** diff --git a/boards/nucleo-f030r8/include/periph_conf.h b/boards/nucleo-f030r8/include/periph_conf.h index 5e2254589a..b02f40ad6f 100644 --- a/boards/nucleo-f030r8/include/periph_conf.h +++ b/boards/nucleo-f030r8/include/periph_conf.h @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_nucleo-f030r8 STM32 Nucleo-F030R8 - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-F030R8 + * @ingroup boards_nucleo-f030r8 * @{ * * @file diff --git a/boards/nucleo-f070rb/include/periph_conf.h b/boards/nucleo-f070rb/include/periph_conf.h index ec3926ff81..e36395babc 100644 --- a/boards/nucleo-f070rb/include/periph_conf.h +++ b/boards/nucleo-f070rb/include/periph_conf.h @@ -8,9 +8,7 @@ */ /** - * @defgroup boards_nucleo-f070rb STM32 Nucleo-F070RB - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-F070RB + * @ingroup boards_nucleo-f070rb * @{ * * @file diff --git a/boards/nucleo-f072rb/include/periph_conf.h b/boards/nucleo-f072rb/include/periph_conf.h index 95511438bf..6dd8aa188e 100644 --- a/boards/nucleo-f072rb/include/periph_conf.h +++ b/boards/nucleo-f072rb/include/periph_conf.h @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_nucleo-f072rb STM32 Nucleo-F072RB - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-F072RB + * @ingroup boards_nucleo-f072rb * @{ * * @file diff --git a/boards/nucleo-f091rc/include/periph_conf.h b/boards/nucleo-f091rc/include/periph_conf.h index 4fb17ab37d..a6a94c792d 100644 --- a/boards/nucleo-f091rc/include/periph_conf.h +++ b/boards/nucleo-f091rc/include/periph_conf.h @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_nucleo-f091rc STM32 Nucleo-F091RC - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-F091RC + * @ingroup boards_nucleo-f091rc * @{ * * @file diff --git a/boards/nucleo-f103rb/include/periph_conf.h b/boards/nucleo-f103rb/include/periph_conf.h index ccd9b97f00..b73bd1280b 100644 --- a/boards/nucleo-f103rb/include/periph_conf.h +++ b/boards/nucleo-f103rb/include/periph_conf.h @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_nucleo-f103rb STM32 Nucleo-F103RB - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-F103RB + * @ingroup boards_nucleo-f103rb * @{ * * @file diff --git a/boards/nucleo-f302r8/include/periph_conf.h b/boards/nucleo-f302r8/include/periph_conf.h index 7c63fc6f8a..5e92edb403 100644 --- a/boards/nucleo-f302r8/include/periph_conf.h +++ b/boards/nucleo-f302r8/include/periph_conf.h @@ -9,9 +9,7 @@ */ /** - * @defgroup boards_nucleo-f302r8 STM32 Nucleo-F302R8 - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-F302R8 + * @ingroup boards_nucleo-f302r8 * @{ * * @file diff --git a/boards/nucleo-f303k8/include/periph_conf.h b/boards/nucleo-f303k8/include/periph_conf.h index c436fecf1f..de9e586d6d 100644 --- a/boards/nucleo-f303k8/include/periph_conf.h +++ b/boards/nucleo-f303k8/include/periph_conf.h @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_nucleo-f303k8 STM32 Nucleo-F303K8 - * @ingroup boards_common_nucleo32 - * @brief Support for the STM32 Nucleo-F303K8 + * @ingroup boards_nucleo-f303k8 * @{ * * @file diff --git a/boards/nucleo-f303re/include/periph_conf.h b/boards/nucleo-f303re/include/periph_conf.h index 1fd6b37262..337d46caf6 100644 --- a/boards/nucleo-f303re/include/periph_conf.h +++ b/boards/nucleo-f303re/include/periph_conf.h @@ -8,9 +8,7 @@ */ /** - * @defgroup boards_nucleo-f303re STM32 Nucleo-F303RE - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-F303RE + * @ingroup boards_nucleo-f303re * @{ * * @file diff --git a/boards/nucleo-f303ze/include/periph_conf.h b/boards/nucleo-f303ze/include/periph_conf.h index 835026347c..eb58955727 100644 --- a/boards/nucleo-f303ze/include/periph_conf.h +++ b/boards/nucleo-f303ze/include/periph_conf.h @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_nucleo-f303ze STM32 Nucleo-F303ZE - * @ingroup boards_common_nucleo144 - * @brief Support for the STM32 Nucleo-F303ZE + * @ingroup boards_nucleo-f303ze * @{ * * @file diff --git a/boards/nucleo-f334r8/include/periph_conf.h b/boards/nucleo-f334r8/include/periph_conf.h index 2e32e8a57b..b9b213d195 100644 --- a/boards/nucleo-f334r8/include/periph_conf.h +++ b/boards/nucleo-f334r8/include/periph_conf.h @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_nucleo-f334r8 STM32 Nucleo-F334R8 - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-F334R8 + * @ingroup boards_nucleo-f334r8 * @{ * * @file diff --git a/boards/nucleo-f401re/include/periph_conf.h b/boards/nucleo-f401re/include/periph_conf.h index fd45bb01d3..7abb56219e 100644 --- a/boards/nucleo-f401re/include/periph_conf.h +++ b/boards/nucleo-f401re/include/periph_conf.h @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_nucleo-f401re STM32 Nucleo-F401RE - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-F401RE + * @ingroup boards_nucleo-f401re * @{ * * @file diff --git a/boards/nucleo-f410rb/include/periph_conf.h b/boards/nucleo-f410rb/include/periph_conf.h index 17e4524369..4519da3594 100644 --- a/boards/nucleo-f410rb/include/periph_conf.h +++ b/boards/nucleo-f410rb/include/periph_conf.h @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_nucleo-f410rb STM32 Nucleo-F410RB - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-F410RB + * @ingroup boards_nucleo-f410rb * @{ * * @file diff --git a/boards/nucleo-f411re/include/periph_conf.h b/boards/nucleo-f411re/include/periph_conf.h index 558ecd2fb6..43e6d24ec2 100644 --- a/boards/nucleo-f411re/include/periph_conf.h +++ b/boards/nucleo-f411re/include/periph_conf.h @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_nucleo-f411re STM32 Nucleo-F411RE - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-F411RE + * @ingroup boards_nucleo-f411re * @{ * * @file diff --git a/boards/nucleo-f446re/include/periph_conf.h b/boards/nucleo-f446re/include/periph_conf.h index 25ca136d84..27d6139e0c 100644 --- a/boards/nucleo-f446re/include/periph_conf.h +++ b/boards/nucleo-f446re/include/periph_conf.h @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_nucleo-f446re STM32 Nucleo-F446RE - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-F446RE + * @ingroup boards_nucleo-f446re * @{ * * @file diff --git a/boards/nucleo-f446ze/include/periph_conf.h b/boards/nucleo-f446ze/include/periph_conf.h index 4f3cd2fac3..2535b9162d 100644 --- a/boards/nucleo-f446ze/include/periph_conf.h +++ b/boards/nucleo-f446ze/include/periph_conf.h @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_nucleo-f446ze STM32 Nucleo-F446ZE - * @ingroup boards_common_nucleo144 - * @brief Support for the STM32 Nucleo-F446ZE + * @ingroup boards_nucleo-f446ze * @{ * * @file diff --git a/boards/nucleo-l053r8/include/periph_conf.h b/boards/nucleo-l053r8/include/periph_conf.h index f54deb252a..143d334f8b 100644 --- a/boards/nucleo-l053r8/include/periph_conf.h +++ b/boards/nucleo-l053r8/include/periph_conf.h @@ -8,9 +8,7 @@ */ /** - * @defgroup boards_nucleo-l053r8 STM32 Nucleo-L053R8 - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-L053R8 + * @ingroup boards_nucleo-l053r8 * @{ * * @file diff --git a/boards/nucleo-l073rz/include/periph_conf.h b/boards/nucleo-l073rz/include/periph_conf.h index 829b6c76c1..c02e9d6624 100644 --- a/boards/nucleo-l073rz/include/periph_conf.h +++ b/boards/nucleo-l073rz/include/periph_conf.h @@ -8,9 +8,7 @@ */ /** - * @defgroup boards_nucleo-l073rz STM32 Nucleo-L073RZ - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-L073RZ + * @ingroup boards_nucleo-l073rz * @{ * * @file diff --git a/boards/nucleo-l152re/include/periph_conf.h b/boards/nucleo-l152re/include/periph_conf.h index 935a733763..0e9110b136 100644 --- a/boards/nucleo-l152re/include/periph_conf.h +++ b/boards/nucleo-l152re/include/periph_conf.h @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_nucleo-l152re STM32 Nucleo-L152RE - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-L152RE + * @ingroup boards_nucleo-l152re * @{ * * @file diff --git a/boards/nucleo-l476rg/include/periph_conf.h b/boards/nucleo-l476rg/include/periph_conf.h index 1404a2d940..92347d218c 100644 --- a/boards/nucleo-l476rg/include/periph_conf.h +++ b/boards/nucleo-l476rg/include/periph_conf.h @@ -9,9 +9,7 @@ */ /** - * @defgroup boards_nucleo-l476rg STM32 Nucleo-L476RG - * @ingroup boards_common_nucleo64 - * @brief Support for the STM32 Nucleo-L476RG + * @ingroup boards_nucleo-l476rg * @{ * * @file diff --git a/boards/stm32f769i-disco/include/board.h b/boards/stm32f769i-disco/include/board.h index b5f1bb6358..6c34df9730 100644 --- a/boards/stm32f769i-disco/include/board.h +++ b/boards/stm32f769i-disco/include/board.h @@ -7,9 +7,7 @@ */ /** - * @defgroup boards_stm32f769i-disco STM32F769I-DISCO board - * @ingroup boards - * @brief Support for the STM32F769I-DISCO board + * @ingroup boards_stm32f769i-disco * @{ * * @file diff --git a/core/include/native_sched.h b/core/include/native_sched.h index a3a049c593..a2a4c51c64 100644 --- a/core/include/native_sched.h +++ b/core/include/native_sched.h @@ -7,9 +7,9 @@ */ /** - * @defgroup core_sched Scheduler - * @ingroup core - * @brief The RIOT scheduler + * @defgroup core_sched_native Scheduler for native + * @ingroup core_sched + * @brief The RIOT scheduler for the native platform * @details * * @{ diff --git a/cpu/efm32/include/cpu_conf.h b/cpu/efm32/include/cpu_conf.h index 1c8d4748e9..8d64d34082 100644 --- a/cpu/efm32/include/cpu_conf.h +++ b/cpu/efm32/include/cpu_conf.h @@ -7,9 +7,7 @@ */ /** - * @defgroup cpu_efm32 Silicon Labs EFM32/EFR32/EZR32 - * @ingroup cpu - * @brief Support for Silicon Labs EFM32/EFR32/EZR32 CPUs + * @ingroup cpu_efm32 * @{ * * @file diff --git a/pkg/lwip/doc.txt b/pkg/lwip/doc.txt index af79f3d8f2..5cb9fb6a70 100644 --- a/pkg/lwip/doc.txt +++ b/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. */ diff --git a/pkg/lwip/include/lwip.h b/pkg/lwip/include/lwip.h index a866c85c5b..4053fbada1 100644 --- a/pkg/lwip/include/lwip.h +++ b/pkg/lwip/include/lwip.h @@ -7,13 +7,7 @@ */ /** - * @defgroup pkg_lwip 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. + * @ingroup pkg_lwip * * @{ * diff --git a/sys/hashes/sha1.c b/sys/hashes/sha1.c index 62f256e692..5bfec518c5 100644 --- a/sys/hashes/sha1.c +++ b/sys/hashes/sha1.c @@ -11,14 +11,12 @@ */ /** - * @defgroup sys_hashes_sha1 SHA-1 - * @ingroup sys_hashes - * @brief Implementation of the SHA-1 hashing function + * @ingroup sys_hashes_sha1 * @{ * * @file - * @brief SHA-1 interface definition + * @brief Implementation of the SHA-1 hashing function * * @author Wei Dai and others * @author Oliver Hahm diff --git a/sys/include/net/gnrc/tcp/config.h b/sys/include/net/gnrc/tcp/config.h index ce9e2d2745..8237e744f4 100644 --- a/sys/include/net/gnrc/tcp/config.h +++ b/sys/include/net/gnrc/tcp/config.h @@ -7,9 +7,7 @@ */ /** - * @defgroup net_gnrc_tcp TCP - * @ingroup net_gnrc - * @brief RIOT's TCP implementation for the GNRC network stack. + * @ingroup net_gnrc_tcp * * @{ * diff --git a/sys/include/net/gnrc/tcp/tcb.h b/sys/include/net/gnrc/tcp/tcb.h index dadb1b7952..b73ceed655 100644 --- a/sys/include/net/gnrc/tcp/tcb.h +++ b/sys/include/net/gnrc/tcp/tcb.h @@ -7,9 +7,7 @@ */ /** - * @defgroup net_gnrc_tcp TCP - * @ingroup net_gnrc - * @brief RIOT's TCP implementation for the GNRC network stack. + * @ingroup net_gnrc_tcp * * @{ * diff --git a/sys/net/gnrc/sock/include/gnrc_sock_internal.h b/sys/net/gnrc/sock/include/gnrc_sock_internal.h index be7bd91fa2..043634b858 100644 --- a/sys/net/gnrc/sock/include/gnrc_sock_internal.h +++ b/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 - * @brief Provides an implementation of the @ref net_sock by the - * @ref net_gnrc + * @ingroup net_gnrc_sock * * @{ * * @file - * @brief GNRC-specific types and function definitions + * @brief Internal GNRC-specific types and function definitions * * @author Martine Lenders */ diff --git a/sys/net/gnrc/transport_layer/tcp/internal/common.h b/sys/net/gnrc/transport_layer/tcp/internal/common.h index 8451be756c..1b35968e12 100644 --- a/sys/net/gnrc/transport_layer/tcp/internal/common.h +++ b/sys/net/gnrc/transport_layer/tcp/internal/common.h @@ -7,9 +7,7 @@ */ /** - * @defgroup net_gnrc_tcp TCP - * @ingroup net_gnrc - * @brief RIOT's TCP implementation for the GNRC network stack. + * @ingroup net_gnrc_tcp * * @{ * diff --git a/sys/net/gnrc/transport_layer/tcp/internal/eventloop.h b/sys/net/gnrc/transport_layer/tcp/internal/eventloop.h index c89189aa9e..5ae25ab5fd 100644 --- a/sys/net/gnrc/transport_layer/tcp/internal/eventloop.h +++ b/sys/net/gnrc/transport_layer/tcp/internal/eventloop.h @@ -7,9 +7,7 @@ */ /** - * @defgroup net_gnrc_tcp TCP - * @ingroup net_gnrc - * @brief RIOT's TCP implementation for the GNRC network stack. + * @ingroup net_gnrc_tcp * * @{ * diff --git a/sys/net/gnrc/transport_layer/tcp/internal/fsm.h b/sys/net/gnrc/transport_layer/tcp/internal/fsm.h index 849eb85874..ae6f639ec3 100644 --- a/sys/net/gnrc/transport_layer/tcp/internal/fsm.h +++ b/sys/net/gnrc/transport_layer/tcp/internal/fsm.h @@ -7,9 +7,7 @@ */ /** - * @defgroup net_gnrc_tcp TCP - * @ingroup net_gnrc - * @brief RIOT's TCP implementation for the GNRC network stack. + * @ingroup net_gnrc_tcp * * @{ * diff --git a/sys/net/gnrc/transport_layer/tcp/internal/option.h b/sys/net/gnrc/transport_layer/tcp/internal/option.h index b49bf6913d..2699ab29fc 100644 --- a/sys/net/gnrc/transport_layer/tcp/internal/option.h +++ b/sys/net/gnrc/transport_layer/tcp/internal/option.h @@ -7,9 +7,7 @@ */ /** - * @defgroup net_gnrc_tcp TCP - * @ingroup net_gnrc - * @brief RIOT's TCP implementation for the GNRC network stack. + * @ingroup net_gnrc_tcp * * @{ * diff --git a/sys/net/gnrc/transport_layer/tcp/internal/pkt.h b/sys/net/gnrc/transport_layer/tcp/internal/pkt.h index 9f0fc3f195..1cace73261 100644 --- a/sys/net/gnrc/transport_layer/tcp/internal/pkt.h +++ b/sys/net/gnrc/transport_layer/tcp/internal/pkt.h @@ -7,9 +7,7 @@ */ /** - * @defgroup net_gnrc_tcp TCP - * @ingroup net_gnrc - * @brief RIOT's TCP implementation for the GNRC network stack. + * @ingroup net_gnrc_tcp * * @{ * diff --git a/sys/net/gnrc/transport_layer/tcp/internal/rcvbuf.h b/sys/net/gnrc/transport_layer/tcp/internal/rcvbuf.h index 0a603e4013..c9c5911795 100644 --- a/sys/net/gnrc/transport_layer/tcp/internal/rcvbuf.h +++ b/sys/net/gnrc/transport_layer/tcp/internal/rcvbuf.h @@ -7,9 +7,7 @@ */ /** - * @defgroup net_gnrc_tcp TCP - * @ingroup net_gnrc - * @brief RIOT's TCP implementation for the GNRC network stack. + * @ingroup net_gnrc_tcp * * @{ * diff --git a/sys/posix/pthread/pthread.c b/sys/posix/pthread/pthread.c index 3fd937e2e4..cbd237c632 100644 --- a/sys/posix/pthread/pthread.c +++ b/sys/posix/pthread/pthread.c @@ -7,9 +7,7 @@ */ /** - * @defgroup pthread POSIX threads - * POSIX conforming multi-threading features. - * @ingroup posix + * @ingroup pthread * @{ * @file * @brief Thread creation features.