docu

2 files changed, 8 insertions, 3 deletions

diff --git a/src/include/gnunet_hello_lib.h b/src/include/gnunet_hello_lib.h
index c56289286..f1b67121e 100644
--- a/src/include/gnunet_hello_lib.h
+++ b/src/include/gnunet_hello_lib.h
@@ -174,6 +174,7 @@ typedef int
  *         otherwise NULL will be returned
  * @param it iterator to call on each address
  * @param it_cls closure for it
+ * @return the modified HELLO or NULL
  */
 struct GNUNET_HELLO_Message *GNUNET_HELLO_iterate_addresses (const struct
                                                              GNUNET_HELLO_Message
diff --git a/src/include/gnunet_transport_service.h b/src/include/gnunet_transport_service.h
index 24b9e90af..0e17a0135 100644
--- a/src/include/gnunet_transport_service.h
+++ b/src/include/gnunet_transport_service.h
@@ -640,13 +640,15 @@ GNUNET_TRANSPORT_address_lookup (const struct GNUNET_CONFIGURATION_Handle *cfg,
                                  const char * address,
                                  size_t addressLen,
                                  int numeric,
-                                 const char * nameTrans,
+                                 const char *nameTrans,
                                  struct GNUNET_TIME_Relative timeout,
                                  GNUNET_TRANSPORT_AddressLookUpCallback aluc,
                                  void *aluc_cls);
 
+
 /**
- * Return all the known addresses for a peer.
+ * Return all the known addresses for a peer. FIXME: document better!
+ * FIXME: use better name!
  *
  * @param cfg configuration to use
  * @param peer peer identity to look up the addresses of
@@ -663,7 +665,8 @@ GNUNET_TRANSPORT_peer_address_lookup (const struct GNUNET_CONFIGURATION_Handle *
 
 
 /**
- * Return all the known addresses for a peer.
+ * Return all the known addresses. FIXME: document better!
+ * FIXME: use better name!
  *
  * @param cfg configuration to use
  * @param timeout how long is the lookup allowed to take at most
@@ -676,6 +679,7 @@ GNUNET_TRANSPORT_address_iterate (const struct GNUNET_CONFIGURATION_Handle *cfg,
                                   GNUNET_TRANSPORT_AddressLookUpCallback peer_address_callback,
                                   void *peer_address_callback_cls);
 
+
 /**
  * Handle for blacklisting peers.
  */