doxygen

8 files changed, 20 insertions, 36 deletions

diff --git a/src/ats/ats_api_performance.c b/src/ats/ats_api_performance.c
index 038a349aa..ec0b52fe1 100644
--- a/src/ats/ats_api_performance.c
+++ b/src/ats/ats_api_performance.c
@@ -784,10 +784,7 @@ GNUNET_ATS_performance_monitor_start (struct GNUNET_ATS_PerformanceHandle * ph,
 /**
  * Stop monitoring performance information
  *
- * @param ph performance handle to use
- * @param monitor_cb function to call on performance changes
- * @param monitor_cb_cls closure for infocb
- * @return a performance monitor handle
+ * @param phm performance monitor handle to use
  */
 void
 GNUNET_ATS_performance_monitor_stop (struct GNUNET_ATS_PerformanceMonitorHandle * phm)
diff --git a/src/core/gnunet-service-core_neighbours.c b/src/core/gnunet-service-core_neighbours.c
index ea1cca7d6..78213f9d9 100644
--- a/src/core/gnunet-service-core_neighbours.c
+++ b/src/core/gnunet-service-core_neighbours.c
@@ -297,8 +297,6 @@ process_queue (struct Neighbour *n)
  *
  * @param cls closure
  * @param peer the peer that connected
- * @param atsi performance data
- * @param atsi_count number of entries in ats (excluding 0-termination)
  */
 static void
 handle_transport_notify_connect (void *cls,
@@ -366,8 +364,6 @@ handle_transport_notify_disconnect (void *cls,
  * @param cls closure
  * @param peer (claimed) identity of the other peer
  * @param message the message
- * @param atsi performance data
- * @param atsi_count number of entries in ats (excluding 0-termination)
  */
 static void
 handle_transport_receive (void *cls, const struct GNUNET_PeerIdentity *peer,
diff --git a/src/include/gnunet_ats_service.h b/src/include/gnunet_ats_service.h
index 7ac9f7f4a..1e5643794 100644
--- a/src/include/gnunet_ats_service.h
+++ b/src/include/gnunet_ats_service.h
@@ -773,10 +773,7 @@ GNUNET_ATS_performance_monitor_start (struct GNUNET_ATS_PerformanceHandle * ph,
 /**
  * Stop monitoring performance information
  *
- * @param ph performance handle to use
- * @param monitor_cb function to call on performance changes
- * @param monitor_cb_cls closure for infocb
- * @return a performance monitor handle
+ * @param phm performance monitoring handle to use
  */
 void
 GNUNET_ATS_performance_monitor_stop (struct GNUNET_ATS_PerformanceMonitorHandle * phm);
diff --git a/src/include/gnunet_transport_plugin.h b/src/include/gnunet_transport_plugin.h
index bc635b1cc..3e0a590ba 100644
--- a/src/include/gnunet_transport_plugin.h
+++ b/src/include/gnunet_transport_plugin.h
@@ -135,12 +135,12 @@ typedef struct GNUNET_ATS_Information
  */
 typedef void
 (*GNUNET_TRANSPORT_UpdateAddressMetrics) (void *cls,
-                                                                                                                                                                        const struct GNUNET_PeerIdentity *peer,
-                                                                                                                                                        const char *address,
-                                                                                                                                                        uint16_t address_len,
-                                                                                                                                                        struct Session *session,
-                                                                                                                                                        struct GNUNET_ATS_Information *ats,
-                                                                                                                                                        uint32_t ats_count);
+                                                                                                                                                                 struct GNUNET_PeerIdentity *peer,
+                                                                                                                                                                 const void *address,
+                                                                                                                                                                 uint16_t address_len,
+                                                                                                                                                                 struct Session *session,
+                                                                                                                                                                 struct GNUNET_ATS_Information *ats,
+                                                                                                                                                                 uint32_t ats_count);
 
 /**
  * Function that will be called for each address the transport
diff --git a/src/testbed/gnunet-service-testbed_cache.c b/src/testbed/gnunet-service-testbed_cache.c
index 5e93da1f5..6be53f00e 100644
--- a/src/testbed/gnunet-service-testbed_cache.c
+++ b/src/testbed/gnunet-service-testbed_cache.c
@@ -540,8 +540,6 @@ peer_connect_notify_cb (void *cls, const struct GNUNET_PeerIdentity *peer,
  *
  * @param cls closure
  * @param peer the peer that connected
- * @param ats performance data
- * @param ats_count number of entries in ats (excluding 0-termination)
  */
 static void
 transport_peer_connect_notify_cb (void *cls,
diff --git a/src/transport/gnunet-service-transport.c b/src/transport/gnunet-service-transport.c
index 685113b10..54342bfde 100644
--- a/src/transport/gnunet-service-transport.c
+++ b/src/transport/gnunet-service-transport.c
@@ -103,8 +103,6 @@ struct GNUNET_TIME_Relative hello_expiration;
  *
  * @param cls the 'HELLO' message
  * @param target a connected neighbour
- * @param ats performance information (unused)
- * @param ats_count number of records in ats (unused)
  * @param address the address
  * @param bandwidth_in inbound quota in NBO
  * @param bandwidth_out outbound quota in NBO
@@ -144,8 +142,6 @@ process_hello_update (void *cls, const struct GNUNET_MessageHeader *hello)
  * @param address the address
  * @param session session used
  * @param message the message to process
- * @param ats performance information
- * @param ats_count number of records in ats
  * @return how long the plugin should wait until receiving more data
  */
 static struct GNUNET_TIME_Relative
@@ -204,8 +200,6 @@ process_payload (const struct GNUNET_PeerIdentity *peer,
  * @param peer (claimed) identity of the other peer
  * @param message the message, NULL if we only care about
  *                learning about the delay until we should receive again -- FIXME!
- * @param ats performance information
- * @param ats_count number of records in ats
  * @param session identifier used for this session (NULL for plugins
  *                that do not offer bi-directional communication to the sender
  *                using the same "connection")
@@ -415,9 +409,12 @@ GST_update_ats_metrics (struct GNUNET_PeerIdentity *peer,
  * LAN, WAN etc. address
  *
  * @param cls closure
- * @param addr binary address
- * @param addrlen length of the address
- * @return ATS Information containing the network type
+ * @param peer the peer
+ * @param address binary address
+ * @param address_len length of the address
+ * @param session the session
+ * @param ats the ats information to update
+ * @param ats_count the number of ats elements
  */
 static void
 plugin_env_update_metrics (void *cls,
@@ -492,8 +489,6 @@ ats_request_address_change (void *cls,
  *
  * @param cls closure
  * @param peer the peer that connected
- * @param ats performance data
- * @param ats_count number of entries in ats
  * @param bandwidth_in inbound bandwidth in NBO
  * @param bandwidth_out outbound bandwidth in NBO
  */
diff --git a/src/transport/gnunet-service-transport.h b/src/transport/gnunet-service-transport.h
index 9a4233f01..b944da730 100644
--- a/src/transport/gnunet-service-transport.h
+++ b/src/transport/gnunet-service-transport.h
@@ -76,8 +76,6 @@ extern struct GNUNET_ATS_SchedulingHandle *GST_ats;
  * @param peer (claimed) identity of the other peer
  * @param message the message, NULL if we only care about
  *                learning about the delay until we should receive again -- FIXME!
- * @param ats performance information
- * @param ats_count number of records in ats
  * @param session identifier used for this session (NULL for plugins
  *                that do not offer bi-directional communication to the sender
  *                using the same "connection")
diff --git a/src/transport/gnunet-service-transport_manipulation.c b/src/transport/gnunet-service-transport_manipulation.c
index 831d8fd5d..e6a8f5580 100644
--- a/src/transport/gnunet-service-transport_manipulation.c
+++ b/src/transport/gnunet-service-transport_manipulation.c
@@ -351,9 +351,12 @@ GST_manipulation_send (const struct GNUNET_PeerIdentity *target, const void *msg
  * LAN, WAN etc. address
  *
  * @param cls closure
- * @param addr binary address
- * @param addrlen length of the address
- * @return ATS Information containing the network type
+ * @param peer the peer
+ * @param address binary address
+ * @param address_len length of the address
+ * @param session the session
+ * @param ats the ats information
+ * @param ats_count the number of ats information
  */
 void
 GST_manipulation_metrics_recv (void *cls,