- doxygen

8 files changed, 28 insertions, 18 deletions

diff --git a/src/testbed/gnunet-service-testbed.h b/src/testbed/gnunet-service-testbed.h
index 37f6a6aaf..8b3650e28 100644
--- a/src/testbed/gnunet-service-testbed.h
+++ b/src/testbed/gnunet-service-testbed.h
@@ -828,7 +828,7 @@ GST_cache_lookup_hello (const unsigned int peer_id);
  * Caches the HELLO of the given peer. Updates the HELLO if it was already
  * cached before
  *
- * @param id the peer identity of the peer whose HELLO has to be cached
+ * @param peer_id the peer identity of the peer whose HELLO has to be cached
  * @param hello the HELLO message
  */
 void
diff --git a/src/testbed/gnunet-service-testbed_cache.c b/src/testbed/gnunet-service-testbed_cache.c
index 5686c9258..ac4bcecec 100644
--- a/src/testbed/gnunet-service-testbed_cache.c
+++ b/src/testbed/gnunet-service-testbed_cache.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file testbed/gnunet-service-testbed_cache.h
+ * @file testbed/gnunet-service-testbed_cache.c
  * @brief testbed cache implementation
  * @author Sree Harsha Totakura
  */
@@ -299,7 +299,8 @@ static unsigned int cache_size;
 /**
  * Looks up in the cache and returns the entry
  *
- * @param id the peer identity of the peer whose corresponding entry has to be looked up
+ * @param key the peer identity of the peer whose corresponding entry has to be
+ *          looked up
  * @return the HELLO message; NULL if not found
  */
 static struct CacheEntry *
@@ -713,7 +714,19 @@ oprelease_get_handle_core (void *cls)
  * lookup in the cache; if not, a new operation is started to open the transport
  * handle and will be given in the callback when it is available.
  *
- * @param cls the cache entry
+ * @param peer_id the index of the peer
+ * @param cgh the CacheGetHandle
+ * @param cfg the configuration with which the transport handle has to be
+ *          created if it was not present in the cache
+ * @param target the peer identify of the peer whose connection to
+ *          TRANSPORT/CORE (depending on the type of 'cgh') subsystem will be
+ *          notified through the connect_notify_cb. Can be NULL
+ * @param connect_notify_cb the callback to call when the given target peer is
+ *          connected. This callback will only be called once or never again (in
+ *          case the target peer cannot be connected). Can be NULL
+ * @param connect_notify_cb_cls the closure for the above callback
+ * @return the handle which can be used to cancel or mark that the handle is no
+ *           longer being used
  */
 static struct GSTCacheGetHandle *
 cache_get_handle (unsigned int peer_id, struct GSTCacheGetHandle *cgh,
@@ -950,7 +963,7 @@ GST_cache_get_handle_done (struct GSTCacheGetHandle *cgh)
  *          connected. This callback will only be called once or never again (in
  *          case the target peer cannot be connected). Can be NULL
  * @param connect_notify_cb_cls the closure for the above callback
- * @return the handle which can be used cancel or mark that the handle is no
+ * @return the handle which can be used to cancel or mark that the handle is no
  *           longer being used
  */
 struct GSTCacheGetHandle *
@@ -990,7 +1003,7 @@ GST_cache_get_handle_transport (unsigned int peer_id,
  *          connected. This callback will only be called once or never again (in
  *          case the target peer cannot be connected). Can be NULL
  * @param connect_notify_cb_cls the closure for the above callback
- * @return the handle which can be used cancel or mark that the handle is no
+ * @return the handle which can be used to cancel or mark that the handle is no
  *           longer being used
  */
 struct GSTCacheGetHandle *
@@ -1039,7 +1052,7 @@ GST_cache_lookup_hello (const unsigned int peer_id)
  * Caches the HELLO of the given peer. Updates the HELLO if it was already
  * cached before
  *
- * @param id the peer identity of the peer whose HELLO has to be cached
+ * @param peer_id the peer identity of the peer whose HELLO has to be cached
  * @param hello the HELLO message
  */
 void
diff --git a/src/testbed/gnunet-service-testbed_oc.c b/src/testbed/gnunet-service-testbed_oc.c
index 4d573cb1a..7f7695cc2 100644
--- a/src/testbed/gnunet-service-testbed_oc.c
+++ b/src/testbed/gnunet-service-testbed_oc.c
@@ -1357,10 +1357,8 @@ timeout_rocc_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
  * Function called to notify transport users that another
  * peer connected to us.
  *
- * @param cls closure
+ * @param cls the RemoteOverlayConnectContext
  * @param new_peer the peer that connected
- * @param ats performance data
- * @param ats_count number of entries in ats (excluding 0-termination)
  */
 static void
 cache_transport_peer_connect_notify (void *cls,
diff --git a/src/testbed/gnunet_testbed_ll_master.c b/src/testbed/gnunet_testbed_ll_master.c
index 68a815545..ebef5a3aa 100644
--- a/src/testbed/gnunet_testbed_ll_master.c
+++ b/src/testbed/gnunet_testbed_ll_master.c
@@ -19,7 +19,7 @@
  */
 
 /**
- * @file testbed/ll_master.c
+ * @file testbed/gnunet_testbed_ll_master.c
  * @brief The load level master. Creates child processes through LoadLeveler
  * @author Sree Harsha Totakura <sreeharsha@totakura.in>
  */
diff --git a/src/testbed/gnunet_testbed_ll_monitor.c b/src/testbed/gnunet_testbed_ll_monitor.c
index 3a43b490b..666543ff7 100644
--- a/src/testbed/gnunet_testbed_ll_monitor.c
+++ b/src/testbed/gnunet_testbed_ll_monitor.c
@@ -19,7 +19,7 @@
  */
 
 /**
- * @file testbed/ll_monitor.c
+ * @file testbed/gnunet_testbed_ll_monitor.c
  * @brief The load level monitor process. This is called whenever a job event
  *          happens. This file is called with the following syntax:
  *          "monitor_program job_id user_arg state exit_status"
diff --git a/src/testbed/testbed_api_operations.c b/src/testbed/testbed_api_operations.c
index d213d3334..a60ecfd97 100644
--- a/src/testbed/testbed_api_operations.c
+++ b/src/testbed/testbed_api_operations.c
@@ -287,11 +287,11 @@ GNUNET_TESTBED_operation_queue_destroy_ (struct OperationQueue *queue)
  *           is not empty)
  */
 int
-GNUNET_TESTBED_operation_queue_destroy_empty_ (struct OperationQueue *q)
+GNUNET_TESTBED_operation_queue_destroy_empty_ (struct OperationQueue *queue)
 {
-  if (NULL != q->head)
+  if (NULL != queue->head)
     return GNUNET_NO;
-  GNUNET_TESTBED_operation_queue_destroy_ (q);
+  GNUNET_TESTBED_operation_queue_destroy_ (queue);
   return GNUNET_YES;
 }
 
diff --git a/src/testbed/testbed_api_operations.h b/src/testbed/testbed_api_operations.h
index 403dd889c..8ab6944f2 100644
--- a/src/testbed/testbed_api_operations.h
+++ b/src/testbed/testbed_api_operations.h
@@ -66,7 +66,7 @@ GNUNET_TESTBED_operation_queue_destroy_ (struct OperationQueue *queue);
  *           is not empty)
  */
 int
-GNUNET_TESTBED_operation_queue_destroy_empty_ (struct OperationQueue *q);
+GNUNET_TESTBED_operation_queue_destroy_empty_ (struct OperationQueue *queue);
 
 
 /**
diff --git a/src/testbed/testbed_api_testbed.c b/src/testbed/testbed_api_testbed.c
index 5e62a2845..76177b486 100644
--- a/src/testbed/testbed_api_testbed.c
+++ b/src/testbed/testbed_api_testbed.c
@@ -516,8 +516,7 @@ shutdown_run (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
 /**
  * call test master callback
  *
- * @param cls the run context
- * @param tc the task context
+ * @param rc the RunContext
  */
 static void
 call_master (struct RunContext *rc)