pkg: enhance doxygen packages documentation

pkg/ccn-lite/ccn-lite-riot.h

@@ -12,6 +12,7 @@
 /**
  * @defgroup    pkg_ccnlite CCN-Lite stack
  * @ingroup     pkg
+ * @ingroup     net
  * @brief       Provides a NDN implementation
  *
  * This package provides the CCN-Lite stack as a port of NDN for RIOT.

pkg/emb6/doc.txt

 /**
  * @defgroup pkg_emb6 emb6 network stack
- * @ingroup pkg
- * @brief   emb6 network stack
- * @see     https://github.com/hso-esk/emb6/raw/develop/doc/pdf/emb6.pdf
+ * @ingroup  pkg
+ * @ingroup  net
+ * @brief    emb6 network stack
+ * @see      https://github.com/hso-esk/emb6/raw/develop/doc/pdf/emb6.pdf
  *
  * emb6 is a fork of Contiki's uIP network stack without its usage of
  * proto-threads. It uses periodic event polling instead.

pkg/fatfs/doc.txt

+/**
+ * @defgroup pkg_fatfs   FAT file system
+ * @ingroup  pkg
+ * @ingroup  sys
+ * @brief    Provides FAT file system support
+ * @see      http://elm-chan.org/fsw/ff/00index_e.html
+ */
\ No newline at end of file

pkg/heatshrink/README.md

-# Introduction
-
-This package provides a compression library specifically developed for
-memory-constrained devices.  See https://github.com/atomicobject/heatshrink for
-more information.
-
-# License
-
-The library is ISC licensed.

pkg/heatshrink/doc.txt

+/**
+ * @defgroup pkg_heatshrink   Lightweight compression library
+ * @ingroup  pkg
+ * @ingroup  sys
+ * @brief    Provides a lightweight compression library to RIOT
+ *
+ * # Introduction
+ * 
+ * This package provides a compression library specifically developed for
+ * memory-constrained devices.
+ * 
+ * # License
+ * 
+ * The library is ISC licensed.
+ *
+ * @see https://github.com/atomicobject/heatshrink
+ */
\ No newline at end of file

pkg/jerryscript/doc.txt

+/**
+ * @defgroup pkg_jerryscript   Ultra-lightweight Javascript for Internet Of Things
+ * @ingroup  pkg
+ * @ingroup  sys
+ * @brief    Provides Javascript support for RIOT
+ * @see      https://github.com/jerryscript-project/jerryscript
+ */
\ No newline at end of file

pkg/jsmn/doc.txt

+/**
+ * @defgroup pkg_jsmn  JSON parser library
+ * @ingroup  pkg
+ * @ingroup  sys
+ * @brief    Provides a JSON parser library to RIOT
+ *
+ * @see      https://github.com/zserge/jsmn
+ */
\ No newline at end of file

pkg/libfixmath/doc.txt

+/**
+ * @defgroup pkg_lib_fix_math Cross platform fixed point maths library
+ * @ingroup  pkg
+ * @ingroup  sys
+ * @brief    Provides a cross platform fixed point maths library to RIOT.
+ * @see      https://github.com/PetteriAimonen/libfixmath
+ */
\ No newline at end of file

pkg/lwip/doc.txt

 /**
  * @defgroup pkg_lwip   lwIP network stack
- * @ingroup pkg
- * @brief   Provides the lwIP network stack
- * @see     http://savannah.nongnu.org/projects/lwip/
+ * @ingroup  pkg
+ * @ingroup  net
+ * @brief    Provides the lwIP network stack
+ * @see      http://savannah.nongnu.org/projects/lwip/
  */

pkg/micro-ecc/doc.txt

+/**
+ * @defgroup pkg_micro_ecc   Micro-ECC for RIOT
+ * @ingroup  pkg
+ * @ingroup  sys
+ * @brief    Micro-ECC for RIOT
+ *
+ * # Micro-ECC for RIOT
+ * 
+ * This port of Micro-ECC to RIOT is based on the Micro-ECC
+ * [upstream](https://github.com/kmackay/micro-ecc) and adds `hwrng_read`
+ * (provided by RIOT) as the default RNG function if it is available on the target
+ * platform. This port also fixes a minor issue with unused variables in the
+ * upstream code.
+ * 
+ * # Usage
+ * 
+ * ## Build
+ * 
+ * Add
+ * ```Makefile
+ * USEPKG += micro-ecc
+ * ```
+ * to your Makefile.
+ * 
+ * ## Choosing the right API
+ * 
+ * Before using the Micro-ECC library, you need to check the `Makefile.features`
+ * of your target board to see if `periph_hwrng` is provided.
+ * 
+ * If it is provided, you may safely use `uECC_make_key` to generate ECDSA key
+ * pairs and call `uECC_sign`/`uECC_verify` to sign/verify the ECDSA signatures.
+ * 
+ * If not, you cannot use `uECC_make_key` or `uECC_sign` APIs anymore. The ECDSA
+ * keys have to be generated on a platform with HWRNG support (e.g., `native`) and
+ * transferred to your target device. You need to use `uECC_sign_deterministic` to
+ * perform ECDSA deterministic signing (standardized by RFC 6979). You can still
+ * use `uECC_verify` to verify the signatures from both signing APIs.
+ * 
+ * **WARNING** Calling `uECC_make_key` and `uECC_sign` APIs on platforms without
+ * HWRNG support will lead to compile failure.
+ * 
+ * Examples of using these uECC APIs can be found in the `test` folder of the
+ * Micro-ECC upstream.
+ *
+ * @see     https://github.com/kmackay/micro-ecc
+ */
\ No newline at end of file

pkg/minmea/README.md

-# Introduction
-
-"Minmea is a minimalistic GPS parser library written in pure C intended for
-resource-constrained platforms, especially microcontrollers and other embedded
-systems."
-
-See https://github.com/cloudyourcar/minmea for more information.
-
-# License
-
-Licensed under WTFPL.

pkg/minmea/doc.txt

+/**
+ * @defgroup pkg_minmea   GPS parser library 
+ * @ingroup  pkg
+ * @ingroup  sys
+ * @brief    Provides a GPS parser library to RIOT
+ *
+ * # Introduction
+ * 
+ * "Minmea is a minimalistic GPS parser library written in pure C intended for
+ * resource-constrained platforms, especially microcontrollers and other embedded
+ * systems."
+ * 
+ * # License
+ * 
+ * Licensed under WTFPL.
+ *
+ * @see      https://github.com/cloudyourcar/minmea
+ */
\ No newline at end of file

pkg/nanocoap/doc.txt

+/**
+ * @defgroup pkg_nanocoap   CoAP lightweight implementation
+ * @ingroup  pkg
+ * @ingroup  net
+ * @brief    Provides a low-level and lightweight implementation of CoAP
+ * @see      https://github.com/kaspar030/sock/tree/master/nanocoap
+ */
\ No newline at end of file

pkg/openthread/doc.txt

+/**
+ * @defgroup pkg_openthread   OpenThread network stack
+ * @ingroup  pkg
+ * @ingroup  net
+ * @brief    Provides a RIOT adaption of the OpenThread network stack
+ * @see      https://github.com/openthread/openthread
+ */
\ No newline at end of file

pkg/relic/README.md

-# Configuration Options
-You can pass along configuration flags for RELIC from your project makefile via:
-
-```export RELIC_CONFIG_FLAGS=-DARCH=NONE -DQUIET=off -DWORD=32 -DFP_PRIME=255 -DWITH="BN;MD;DV;FP;EP;CP;BC;EC" -DSEED=ZERO```
-
-This should happen before the ```USEPKG``` line.
-
-# Usage
-Just put ```USEPKG += relic``` in your Makefile and ```#include <relic.h>```.
\ No newline at end of file

pkg/relic/doc.txt

+/**
+ * @defgroup pkg_relic  Relic toolkit for RIOT
+ * @ingroup  pkg
+ * @ingroup  sys
+ * @brief    Provides the Relic cryptographic toolkit to RIOT
+ *
+ *
+ * # Configuration Options
+ * You can pass along configuration flags for RELIC from your project makefile via:
+ * ```
+ * export RELIC_CONFIG_FLAGS=-DARCH=NONE -DQUIET=off -DWORD=32 -DFP_PRIME=255 -DWITH="BN;MD;DV;FP;EP;CP;BC;EC" -DSEED=ZERO
+ * ```
+ * 
+ * This should happen before the ```USEPKG``` line.
+ * 
+ * # Usage
+ * Just put
+ * ```
+ * USEPKG += relic
+ * ```
+ * in your Makefile and
+ * ```c
+ * #include <relic.h>
+ * ```
+ * in your `main.c`.
+ *
+ * @see      https://github.com/relic-toolkit/relic
+ */
\ No newline at end of file

pkg/spiffs/doc.txt

+/**
+ * @defgroup pkg_spiffs   SPI flash file system
+ * @ingroup  pkg
+ * @ingroup  sys
+ * @brief    Provides a file system for SPI NOR flash devices
+ * @see      https://github.com/pellepl/spiffs
+ */
\ No newline at end of file

pkg/tiny-asn1/doc.txt

 /**
- * @defgroup tiny-asn1 tiny-asn1
- * @ingroup pkg
- * @brief   Lightweight ASN.1 decoding/encoding library
- * @see     https://gitlab.com/matthegap/tiny-asn1
+ * @defgroup pkg_tiny-asn1 Lightweight ASN.1 decoding/encoding library
+ * @ingroup  pkg
+ * @ingroup  sys
+ * @brief    Lightweight ASN.1 decoding/encoding library
+ * @see      https://gitlab.com/matthegap/tiny-asn1
  */

pkg/tinydtls/doc.txt

+/**
+ * @defgroup pkg_tinydtls  TinyDTLS for RIOT
+ * @ingroup  pkg
+ * @ingroup  net
+ * @brief    Provides the Eclipse TinyDTLS to RIOT
+ * @see      https://projects.eclipse.org/projects/iot.tinydtls
+ */
\ No newline at end of file