From 08bf8b71216ae1dc9272dc0ad0630aafa442327c Mon Sep 17 00:00:00 2001
From: Dirk Ziegelmeier <dirk@ziegelmeier.net>
Date: Sat, 3 Mar 2018 11:00:04 +0100
Subject: [PATCH] Improve documentation for 6LOWPAN BLE and ZEPIF

---
 src/netif/lowpan6_ble.c | 12 ++++++++++--
 src/netif/zepif.c       | 16 ++++++++--------
 2 files changed, 18 insertions(+), 10 deletions(-)

diff --git a/src/netif/lowpan6_ble.c b/src/netif/lowpan6_ble.c
index 42ac8ca9..810c52e4 100644
--- a/src/netif/lowpan6_ble.c
+++ b/src/netif/lowpan6_ble.c
@@ -91,7 +91,9 @@ err_t tcpip_rfc7668_input(struct pbuf *p, struct netif *inp);
 err_t rfc7668_set_context(u8_t index, const ip6_addr_t * context);
 
 
-/** convert BT address to EUI64 addr
+/**
+ * @ingroup rfc7668if
+ *  convert BT address to EUI64 addr
  * 
  * This method converts a Bluetooth MAC address to an EUI64 address,
  * which is used within IPv6 communication
@@ -121,7 +123,9 @@ void ble_addr_to_eui64(uint8_t *dst, uint8_t *src, uint8_t public_addr)
 #endif
 }
 
-/** convert EUI64 address to Bluetooth MAC addr
+/**
+ * @ingroup rfc7668if
+ *  convert EUI64 address to Bluetooth MAC addr
  * 
  * This method converts an EUI64 address to a Bluetooth MAC address,
  * 
@@ -455,6 +459,7 @@ rfc7668_frag(struct netif *netif, struct pbuf *p, const ip6_addr_t * src, const
 }
 
 /**
+ * @ingroup rfc7668if
  * Set context id IPv6 address
  *
  * Store one IPv6 address to a given context id.
@@ -483,6 +488,7 @@ rfc7668_set_context(u8_t idx, const ip6_addr_t *context)
 }
 
 /**
+ * @ingroup rfc7668if
  * Resolve and fill-in IEEE 802.15.4 address header for outgoing IPv6 packet.
  *
  * Perform Header Compression and fragment if necessary.
@@ -875,6 +881,7 @@ rfc7668_decompress(struct pbuf * p, const ip6_addr_t * src, const ip6_addr_t * d
 
 
 /**
+ * @ingroup rfc7668if
  * Process a received raw payload from an L2CAP channel
  *
  * @param p the received packet, p->payload pointing to the
@@ -938,6 +945,7 @@ rfc7668_input(struct pbuf * p, struct netif *netif, const ip6_addr_t *src)
 }
 
 /**
+ * @ingroup rfc7668if
  * Initialize the netif
  * 
  * No flags are used (broadcast not possible, not ethernet, ...)
diff --git a/src/netif/zepif.c b/src/netif/zepif.c
index 1df65474..f1b91f58 100644
--- a/src/netif/zepif.c
+++ b/src/netif/zepif.c
@@ -1,14 +1,18 @@
 /**
  * @file
  *
- * A netif implementing the ZigBee Eencapsulation Protocol (ZEP).
+ * @defgroup zepif ZEP - ZigBee Encapsulation Protocol
+ * @ingroup netifs
+ * A netif implementing the ZigBee Encapsulation Protocol (ZEP).
  * This is used to tunnel 6LowPAN over UDP.
  *
  * Usage (there must be a default netif before!):
+ * @code{.c}
  *   netif_add(&zep_netif, NULL, NULL, NULL, NULL, zepif_init, tcpip_6lowpan_input);
  *   netif_create_ip6_linklocal_address(&zep_netif, 1);
  *   netif_set_up(&zep_netif);
  *   netif_set_link_up(&zep_netif);
+ * @endcode
  */
 
 /*
@@ -43,12 +47,6 @@
  *
  */
 
-/**
- * @defgroup sixlowpan 6LowPAN
- * @ingroup netifs
- * ZEP netif implementation
- */
-
 #include "netif/zepif.h"
 
 #if LWIP_IPV6 && LWIP_6LOWPAN
@@ -215,7 +213,9 @@ zepif_linkoutput(struct netif *netif, struct pbuf *p)
   return err;
 }
 
-/** Set up a raw 6LowPAN netif and surround it with input- and output
+/**
+ * @ingroup zepif
+ * Set up a raw 6LowPAN netif and surround it with input- and output
  * functions for ZEP
  */
 err_t