[GNUnet-SVN] r10704 - gnunet/src/dht

[gnunet]

Author: nevans
Date: 2010-03-29 15:30:39 +0200 (Mon, 29 Mar 2010)
New Revision: 10704

Modified:
   gnunet/src/dht/dht_api.c
   gnunet/src/dht/gnunet-service-dht.c
Log:
doxygen cleanup

Modified: gnunet/src/dht/dht_api.c
===================================================================
--- gnunet/src/dht/dht_api.c    2010-03-29 09:40:46 UTC (rev 10703)
+++ gnunet/src/dht/dht_api.c    2010-03-29 13:30:39 UTC (rev 10704)
@@ -338,11 +338,12 @@
 /**
  * Initialize the connection with the DHT service.
  *
+ * @param sched scheduler to use
  * @param cfg configuration to use
- * @param sched scheduler to use
  * @param ht_len size of the internal hash table to use for
  *               processing multiple GET/FIND requests in parallel
- * @return NULL on error
+ *
+ * @return handle to the DHT service, or NULL on error
  */
 struct GNUNET_DHT_Handle *
 GNUNET_DHT_connect (struct GNUNET_SCHEDULER_Handle *sched,
@@ -381,7 +382,7 @@
 /**
  * Shutdown connection with the DHT service.
  *
- * @param h connection to shut down
+ * @param handle handle of the DHT connection to stop
  */
 void
 GNUNET_DHT_disconnect (struct GNUNET_DHT_Handle *handle)
@@ -574,12 +575,14 @@
  * @param iter function to call on each result, NULL if no replies are expected
  * @param iter_cls closure for iter
  * @param timeout when to abort with an error if we fail to get
- *                a confirmation for the PUT from the local DHT service
+ *                a confirmation for the request (when necessary) or how long
+ *                to wait for tramission to the service
  * @param cont continuation to call when done;
  *             reason will be TIMEOUT on error,
  *             reason will be PREREQ_DONE on success
  * @param cont_cls closure for cont
- * @return handle to stop the request
+ *
+ * @return handle to stop the request, NULL if the request is "fire and forget"
  */
 struct GNUNET_DHT_RouteHandle *
 GNUNET_DHT_route_start (struct GNUNET_DHT_Handle *handle,
@@ -680,7 +683,8 @@
 /**
  * Perform an asynchronous GET operation on the DHT identified.
  *
- * @param h handle to the DHT service
+ * @param handle handle to the DHT service
+ * @param timeout how long to wait for transmission of this request to the 
service
  * @param type expected type of the response object
  * @param key the key to look up
  * @param iter function to call on each result
@@ -775,12 +779,12 @@
 
 
 /**
- * Stop async DHT-get.  Frees associated resources.
+ * Stop async DHT-get.
  *
- * @param record GET operation to stop.
+ * @param get_handle handle to the GET operation to stop
  */
 void
-GNUNET_DHT_get_stop (struct GNUNET_DHT_RouteHandle *handle)
+GNUNET_DHT_get_stop (struct GNUNET_DHT_RouteHandle *get_handle)
 {
 #if OLDREMOVE
   struct GNUNET_DHT_GetMessage *get_msg;
@@ -788,7 +792,7 @@
   GNUNET_HashCode *uid_key;
 #endif
 
-  GNUNET_DHT_route_stop(handle);
+  GNUNET_DHT_route_stop(get_handle);
 
 #if OLDREMOVE
   uid_key = hash_from_uid(get_handle->uid);
@@ -805,7 +809,7 @@
 #endif
 #if DEBUG_DHT_API
   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
-              "`%s': Removing pending get request with key %s, uid %llu\n", 
"DHT API", GNUNET_h2s(&handle->key), handle->uid);
+              "`%s': Removing pending get request with key %s, uid %llu\n", 
"DHT API", GNUNET_h2s(&get_handle->key), get_handle->uid);
 #endif
 }
 

Modified: gnunet/src/dht/gnunet-service-dht.c
===================================================================
--- gnunet/src/dht/gnunet-service-dht.c 2010-03-29 09:40:46 UTC (rev 10703)
+++ gnunet/src/dht/gnunet-service-dht.c 2010-03-29 13:30:39 UTC (rev 10704)
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file dht/gnunet_dht_service.c
+ * @file dht/gnunet-service-dht.c
  * @brief main DHT service shell, building block for DHT implementations
  * @author Christian Grothoff
  * @author Nathan Evans