From b2b1ec14f5417ebb56088b4863f86683b4653b79 Mon Sep 17 00:00:00 2001
From: Dirk Ziegelmeier <dirk@ziegelmeier.net>
Date: Wed, 27 Jul 2016 20:28:12 +0200
Subject: [PATCH] Make hook macros visible to doxygen

---
 src/include/lwip/opt.h | 37 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/src/include/lwip/opt.h b/src/include/lwip/opt.h
index 34358d60..f45a34e7 100644
--- a/src/include/lwip/opt.h
+++ b/src/include/lwip/opt.h
@@ -2349,7 +2349,12 @@
    ---------------------------------------
 */
 
-/* Hooks are undefined by default, define them to a function if you need them. */
+/**
+ * @defgroup lwip_opts_hooks Hooks
+ * @ingroup lwip_opts
+ * Hooks are undefined by default, define them to a function if you need them.
+ * @{
+ */
 
 /**
  * LWIP_HOOK_IP4_INPUT(pbuf, input_netif):
@@ -2362,6 +2367,9 @@
  * If the hook consumed the packet, 'pbuf' is in the responsibility of the hook
  * (i.e. free it when done).
  */
+#ifdef __DOXYGEN__
+#define LWIP_HOOK_IP4_INPUT(pbuf, input_netif)
+#endif
 
 /**
  * LWIP_HOOK_IP4_ROUTE(dest):
@@ -2370,11 +2378,17 @@
  * Returns the destination netif or NULL if no destination netif is found. In
  * that case, ip_route() continues as normal.
  */
+#ifdef __DOXYGEN__
+#define LWIP_HOOK_IP4_ROUTE()
+#endif
 
 /**
  * LWIP_HOOK_IP4_ROUTE_SRC(dest, src):
  * - source-based routing for IPv4 (see LWIP_HOOK_IP4_ROUTE(), src may be NULL)
  */
+#ifdef __DOXYGEN__
+#define LWIP_HOOK_IP4_ROUTE_SRC(dest, src)
+#endif
 
 /**
  * LWIP_HOOK_ETHARP_GET_GW(netif, dest):
@@ -2388,6 +2402,9 @@
  * LWIP_HOOK_IP4_ROUTE(). The actual routing/gateway table implementation is
  * not part of lwIP but can e.g. be hidden in the netif's state argument.
 */
+#ifdef __DOXYGEN__
+#define LWIP_HOOK_ETHARP_GET_GW(netif, dest)
+#endif
 
 /**
  * LWIP_HOOK_IP6_INPUT(pbuf, input_netif):
@@ -2400,6 +2417,9 @@
  * If the hook consumed the packet, 'pbuf' is in the responsibility of the hook
  * (i.e. free it when done).
  */
+#ifdef __DOXYGEN__
+#define LWIP_HOOK_IP6_INPUT(pbuf, input_netif)
+#endif
 
 /**
  * LWIP_HOOK_IP6_ROUTE(src, dest):
@@ -2409,6 +2429,9 @@
  * Returns the destination netif or NULL if no destination netif is found. In
  * that case, ip6_route() continues as normal.
  */
+#ifdef __DOXYGEN__
+#define LWIP_HOOK_IP6_ROUTE(src, dest)
+#endif
 
 /**
  * LWIP_HOOK_VLAN_CHECK(netif, eth_hdr, vlan_hdr):
@@ -2420,6 +2443,9 @@
  * - 0: Packet must be dropped.
  * - != 0: Packet must be accepted.
  */
+#ifdef __DOXYGEN__
+#define LWIP_HOOK_VLAN_CHECK(netif, eth_hdr, vlan_hdr)
+#endif
 
 /**
  * LWIP_HOOK_VLAN_SET(netif, eth_hdr, vlan_hdr):
@@ -2432,11 +2458,20 @@
  * - != 0: Packet shall contain VLAN header.
  * Hook can be used to set prio_vid field of vlan_hdr.
  */
+#ifdef __DOXYGEN__
+#define LWIP_HOOK_VLAN_SET(netif, eth_hdr, vlan_hdr)
+#endif
 
 /**
  * LWIP_HOOK_MEMP_AVAILABLE(memp_t_type):
  * - called from memp_free() when a memp pool was empty and an item is now available
  */
+#ifdef __DOXYGEN__
+#define LWIP_HOOK_MEMP_AVAILABLE(memp_t_type)
+#endif
+/**
+ * @}
+ */
 
 /*
    ---------------------------------------