Restructure documentation. Create two top-level sections for thread-safe and callback-style APIs.

src/api/api_lib.c

@@ -36,6 +36,7 @@
 
 /**
  * @defgroup netconn Netconn API
+ * @ingroup threadsafe_api
  * Thread-safe, to be called from non-TCPIP threads only.
  * TX/RX handling based on @ref netbuf (containing @ref pbuf)
  * to avoid copying data around.
@@ -115,7 +116,6 @@ netconn_apimsg(tcpip_callback_fn fn, struct api_msg *apimsg)
 }
 
 /**
- * @ingroup netconn_common
  * Create a new netconn (of a specific type) that has a callback function.
  * The corresponding pcb is also created.
  *

src/api/netifapi.c

@@ -33,6 +33,7 @@
 
 /**
  * @defgroup netifapi NETIF API
+ * @ingroup threadsafe_api
  * Thread-safe functions to be called from non-TCPIP threads
  * 
  * @defgroup netifapi_netif NETIF related

src/api/sockets.c

@@ -40,6 +40,7 @@
 
 /**
  * @defgroup socket Socket API
+ * @ingroup threadsafe_api
  * BSD-style socket API.\n
  * Thread-safe, to be called from non-TCPIP threads only.\n
  * Can be activated by defining LWIP_SOCKET to 1.\n

src/api/tcpip.c

@@ -441,6 +441,7 @@ tcpip_trycallback(struct tcpip_callback_msg* msg)
 }
 
 /**
+ * @ingroup lwIP
  * Initialize this module:
  * - initialize all sub modules
  * - start the tcpip_thread