From 2dd7fb0972aee40eb8f4283e7d4c74415a703ab6 Mon Sep 17 00:00:00 2001
From: "Nathan S. Evans" <evans@in.tum.de>
Date: Tue, 21 Dec 2010 14:59:21 +0000
Subject: [PATCH] doxygen comments, last commit of bugfixes (hopefully)

---
 src/dht/gnunet-dht-driver.c  |  2 +-
 src/dht/gnunet-service-dht.c | 14 ++++++++++++--
 src/dv/gnunet-service-dv.c   |  3 +--
 src/testing/testing_group.c  |  3 +++
 4 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/src/dht/gnunet-dht-driver.c b/src/dht/gnunet-dht-driver.c
index bfab4a388..d0642630c 100644
--- a/src/dht/gnunet-dht-driver.c
+++ b/src/dht/gnunet-dht-driver.c
@@ -1561,7 +1561,7 @@ static void churn_complete (void *cls, const char *emsg)
  * requests once the new peers have done so.
  *
  * @param cls closure (unused)
- * @param cls task context (unused)
+ * @param tc task context (unused)
  */
 static void
 churn_peers (void *cls, const struct GNUNET_SCHEDULER_TaskContext * tc)
diff --git a/src/dht/gnunet-service-dht.c b/src/dht/gnunet-service-dht.c
index bb23153ed..cbcc88e80 100644
--- a/src/dht/gnunet-service-dht.c
+++ b/src/dht/gnunet-service-dht.c
@@ -1829,8 +1829,7 @@ schedule_ping_messages ()
  *
  * @param peer the peer identity of the peer being added
  * @param bucket the bucket that we want this peer to go in
- * @param latency transport latency of this peer
- * @param distance transport distance to this peer
+ * @param atsi transport ATS information
  *
  * @return NULL if the peer was not added,
  *         pointer to PeerInfo for new peer otherwise
@@ -3176,6 +3175,7 @@ compare_peers (const void *p1, const void *p2)
  *
  * @param target the key we are selecting a peer to route to
  * @param bloom a bloomfilter containing entries this request has seen already
+ * @param hops how many hops has this message traversed thus far
  *
  * @return Peer to route to, or NULL on error
  */
@@ -4600,6 +4600,11 @@ handle_dht_local_route_stop (void *cls, struct GNUNET_SERVER_Client *client,
 
 /**
  * Core handler for p2p route requests.
+ *
+ * @param cls closure
+ * @param peer peer identity this notification is about
+ * @param atsi performance data
+ *
  */
 static int
 handle_dht_p2p_route_request (void *cls,
@@ -4698,6 +4703,11 @@ handle_dht_p2p_route_request (void *cls,
 
 /**
  * Core handler for p2p route results.
+ *
+ * @param cls closure
+ * @param peer peer identity this notification is about
+ * @param atsi performance data
+ *
  */
 static int
 handle_dht_p2p_route_result (void *cls,
diff --git a/src/dv/gnunet-service-dv.c b/src/dv/gnunet-service-dv.c
index 0ef8d48f7..cd54686f3 100644
--- a/src/dv/gnunet-service-dv.c
+++ b/src/dv/gnunet-service-dv.c
@@ -1347,8 +1347,7 @@ get_atsi_latency (const struct GNUNET_TRANSPORT_ATS_Information *atsi)
  * @param cls closure
  * @param peer peer which sent the message (immediate sender)
  * @param message the message
- * @param latency the latency of the connection we received the message from
- * @param distance the distance to the immediate peer
+ * @param atsi transport ATS information (latency, distance, etc.)
  */
 static int 
 handle_dv_data_message (void *cls,
diff --git a/src/testing/testing_group.c b/src/testing/testing_group.c
index 4163c3d2e..32bcf4294 100644
--- a/src/testing/testing_group.c
+++ b/src/testing/testing_group.c
@@ -2505,6 +2505,9 @@ copy_allowed_topology (struct GNUNET_TESTING_PeerGroup *pg)
  * of each peer in the peer group
  *
  * @param pg the peer group we are dealing with
+ * @param notify_callback callback to notify when finished
+ * @param notify_cls closure for notify callback
+ *
  * @return the number of connections that will be attempted
  */
 static int
-- 
2.25.1