[GNUnet-SVN] r34942 - gnunet/src/include

[gnunet]

Author: grothoff
Date: 2015-01-19 02:05:57 +0100 (Mon, 19 Jan 2015)
New Revision: 34942

Modified:
   gnunet/src/include/gnunet_container_lib.h
   gnunet/src/include/gnunet_transport_plugin.h
Log:
-indentation, doxygen

Modified: gnunet/src/include/gnunet_container_lib.h
===================================================================
--- gnunet/src/include/gnunet_container_lib.h   2015-01-18 23:55:18 UTC (rev 
34941)
+++ gnunet/src/include/gnunet_container_lib.h   2015-01-19 01:05:57 UTC (rev 
34942)
@@ -612,9 +612,10 @@
  *         iterate,
  *         #GNUNET_NO if not.
  */
-typedef int (*GNUNET_CONTAINER_HashMapIterator) (void *cls,
-                                                 const struct GNUNET_HashCode 
*key,
-                                                 void *value);
+typedef int
+(*GNUNET_CONTAINER_HashMapIterator) (void *cls,
+                                     const struct GNUNET_HashCode *key,
+                                     void *value);
 
 
 /**
@@ -856,9 +857,10 @@
  *         iterate,
  *         #GNUNET_NO if not.
  */
-typedef int (*GNUNET_CONTAINER_PeerMapIterator) (void *cls,
-                                                 const struct 
GNUNET_PeerIdentity *key,
-                                                 void *value);
+typedef int
+(*GNUNET_CONTAINER_PeerMapIterator) (void *cls,
+                                     const struct GNUNET_PeerIdentity *key,
+                                     void *value);
 
 
 struct GNUNET_CONTAINER_MultiPeerMap;

Modified: gnunet/src/include/gnunet_transport_plugin.h
===================================================================
--- gnunet/src/include/gnunet_transport_plugin.h        2015-01-18 23:55:18 UTC 
(rev 34941)
+++ gnunet/src/include/gnunet_transport_plugin.h        2015-01-19 01:05:57 UTC 
(rev 34942)
@@ -85,11 +85,12 @@
  */
 typedef void
 (*GNUNET_TRANSPORT_SessionStart) (void *cls,
-                                  struct GNUNET_HELLO_Address *address,
+                                  const struct GNUNET_HELLO_Address *address,
                                   struct Session *session,
                                   const struct GNUNET_ATS_Information *ats,
                                   uint32_t ats_count);
 
+
 /**
  * Function called by the transport for each received message.
  * This function should also be called with "NULL" for the
@@ -120,8 +121,9 @@
 
 
 /**
- * Function that will be called to figure if an address is an
- * loopback, LAN, WAN etc. address
+ * Function that can be called by plugins to figure if an address is
+ * an loopback, LAN or WAN address.   Ultimately invokes
+ * #GNUNET_ATS_address_get_type().
  *
  * @param cls closure
  * @param addr binary address
@@ -152,6 +154,7 @@
                                          const struct GNUNET_ATS_Information 
*ats,
                                          uint32_t ats_count);
 
+
 /**
  * Function that will be called for each address the transport
  * is aware that it might be reachable under.
@@ -587,7 +590,7 @@
 /**
  * Function to obtain the network type for a session
  *
- * @param cls closure ('struct Plugin*')
+ * @param cls closure (`struct Plugin *`)
  * @param session the session
  * @return the network type
  */
@@ -718,7 +721,7 @@
 
   /**
    * Function that will be called tell the plugin to create a session
-   * object
+   * object.
    */
   GNUNET_TRANSPORT_CreateSession get_session;