doc: add or move module description where missing

drivers/include/netdev/802154.h

@@ -7,7 +7,7 @@
  */
 
 /**
- * @ingroupgroup  netdev
+ * @addtogroup  netdev
  *
  * @{
  * @file

drivers/include/nrf24l01p.h

@@ -9,6 +9,9 @@
 /**
  * @defgroup    drivers_nrf24l01p NRF24L01+ Driver Interface
  * @ingroup     drivers
+ *
+ * @brief       Low-level driver for nrf24l01+ transceiver
+ *
  * @{
  * @file
  *

drivers/include/radio_driver.h

@@ -8,9 +8,10 @@
 
 /**
  * @defgroup radio_driver IEEE 802.15.4 radio driver interface
- * @brief API definitions for 802.15.4 radio transceivers' drivers
  * @ingroup drivers
  *
+ * @brief API definitions for 802.15.4 radio transceivers' drivers
+ *
  * @{
  * @file
  * @author Kévin Roussel <Kevin.Roussel@inria.fr>

sys/include/pipe.h

@@ -19,14 +19,16 @@
 /**
  * @defgroup    sys_pipe Pipe IPC
  * @ingroup     sys
- * @{
- * @file
  *
  * @brief       Generic pipe implementation.
  * @details     This pipe implementation is a tight wrapper around a ringbuffer.
  *              It sends the calling thread to sleep if the ringbuffer is full
  *              or empty, respectively. It can be used in ISRs, too.
  *
+ *
+ * @{
+ * @file
+ *
  * @author      René Kijewski <rene.kijewski@fu-berlin.de>
  */
 

sys/include/transceiver.h

@@ -9,10 +9,13 @@
 /**
  * @defgroup    sys_transceiver Transceiver
  * @ingroup     sys
+ *
+ * @brief       The transceiver module implements a generic link abstraction to
+ *              any radio interface.
+ *
  * @{
  *
  * @file
- * @brief       Transceiver library
  * @author      Oliver Hahm <oliver.hahm@inria.fr>
  */
 

sys/net/include/socket_base.h

@@ -1,7 +1,4 @@
-/**
+/*
- * socket_base.h - Wraps all API types, constants and functions of the transport
- *             layer implementation.
- *
  * Copyright (C) 2013  INRIA.
  *
  * This file is subject to the terms and conditions of the GNU Lesser
@@ -11,10 +8,15 @@
 
 /**
  * @defgroup socket_base    Transport layer implementation
+ * 
  * @ingroup net
- * @brief   This module implements the transport layer. This includes
+ * @brief   This module implements basic transport layer socket functionality.
- *          6LoWPAN UDP header compression and (experimental) 6LoWPAN TCP header
+ *          This includes 6LoWPAN UDP header compression and (experimental)
- *          compression.
+ *          6LoWPAN TCP header compression.
+ *
+ *          It wraps all API types, constants and functions of the transport layer
+ *          implementation.
+ *
  * @see     <a href="http://tools.ietf.org/html/rfc6282#section-4.3">
  *              RFC 6282 - Compression Format for IPv6 Datagrams over
  *                  IEEE 802.15.4-Based Networks - UDP Header Compression

sys/oneway-malloc/include/malloc.h

@@ -7,18 +7,22 @@
  */
 
 /**
- * @defgroup    oneway_malloc Oneway malloc implementation
+ * @defgroup    oneway_malloc Oneway malloc
  * @ingroup     sys
- * @{
- * @file        malloc.h
- * @brief       A malloc implementation for MSP-430 boards without free.
  *
- * @details     The toolchain of MSP-430 does not contain malloc() and friends.
+ * @brief       A malloc implementation without free for boards where the
- *              These functions provide the same interface as the stdlib functions,
+ *              toolchain does not implement dynamic memory allocation.
- *              but the option to free memory.
+ *
+ *              The toolchain of MSP-430, for example, does not contain
+ *              malloc() and friends.  These functions provide the same
+ *              interface as the stdlib functions, but the option to free
+ *              memory.
  *
  * @note        You should prefer statically allocated memory whenever possible.
  *
+ * @{
+ * @file
+ *
  * @author      Kaspar Schleiser <kaspar@schleiser.de>
  * @author      René Kijewski <rene.kijewski@fu-berlin.de>
  */