From 5a38c8f0d1826ea964e3e3452e1a3a2a24d7d35b Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Wed, 21 Aug 2013 15:16:58 +0000 Subject: -misc doxygen fixes --- src/include/gnunet_resolver_service.h | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) (limited to 'src/include/gnunet_resolver_service.h') diff --git a/src/include/gnunet_resolver_service.h b/src/include/gnunet_resolver_service.h index ae98bb8a6..31fd178ca 100644 --- a/src/include/gnunet_resolver_service.h +++ b/src/include/gnunet_resolver_service.h @@ -22,6 +22,8 @@ * @file include/gnunet_resolver_service.h * @brief functions related to doing DNS lookups * @author Christian Grothoff + * @defgroup resolver asynchronous standard DNS lookups + * @{ */ #ifndef GNUNET_RESOLVER_SERVICE_H @@ -45,7 +47,7 @@ extern "C" * * @param cls closure * @param addr one of the addresses of the host, NULL for the last address - * @param addrlen length of the address + * @param addrlen length of @a addr */ typedef void (*GNUNET_RESOLVER_AddressCallback) (void *cls, const struct sockaddr *addr, @@ -80,7 +82,7 @@ GNUNET_RESOLVER_disconnect (void); * @param hostname the hostname to resolve * @param af AF_INET or AF_INET6; use AF_UNSPEC for "any" * @param callback function to call with addresses - * @param callback_cls closure for callback + * @param callback_cls closure for @a callback * @param timeout how long to try resolving * @return handle that can be used to cancel the request, NULL on error */ @@ -96,7 +98,7 @@ GNUNET_RESOLVER_ip_get (const char *hostname, int af, * * @param af AF_INET or AF_INET6; use AF_UNSPEC for "any" * @param callback function to call with addresses - * @param cls closure for callback + * @param cls closure for @a callback * @param timeout how long to try resolving * @return handle that can be used to cancel the request, NULL on error */ @@ -130,11 +132,11 @@ GNUNET_RESOLVER_local_fqdn_get (void); * Perform a reverse DNS lookup. * * @param sa host address - * @param salen length of host address - * @param do_resolve use GNUNET_NO to return numeric hostname + * @param salen length of @a sa + * @param do_resolve use #GNUNET_NO to return numeric hostname * @param timeout how long to try resolving * @param callback function to call with hostnames - * @param cls closure for callback + * @param cls closure for @a callback * @return handle that can be used to cancel the request, NULL on error */ struct GNUNET_RESOLVER_RequestHandle * @@ -164,6 +166,8 @@ GNUNET_RESOLVER_request_cancel (struct GNUNET_RESOLVER_RequestHandle *rh); } #endif +/** @} */ /* end of group resolver */ + /* ifndef GNUNET_RESOLVER_SERVICE_H */ #endif /* end of gnunet_resolver_service.h */ -- cgit v1.2.3