[GNUnet-SVN] r10001 - in gnunet/src: fs include peerinfo util

[gnunet]

Author: grothoff
Date: 2010-01-14 19:24:18 +0100 (Thu, 14 Jan 2010)
New Revision: 10001

Modified:
   gnunet/src/fs/fs_uri.c
   gnunet/src/fs/gnunet-directory.c
   gnunet/src/fs/gnunet-publish.c
   gnunet/src/include/gnunet_transport_service.h
   gnunet/src/peerinfo/gnunet-service-peerinfo.c
   gnunet/src/util/container_meta_data.c
   gnunet/src/util/pseudonym.c
Log:
fixing documentation

Modified: gnunet/src/fs/fs_uri.c
===================================================================
--- gnunet/src/fs/fs_uri.c      2010-01-14 14:56:57 UTC (rev 10000)
+++ gnunet/src/fs/fs_uri.c      2010-01-14 18:24:18 UTC (rev 10001)
@@ -1470,7 +1470,7 @@
  *
  * @param cls URI to update
  * @param plugin_name name of the plugin that produced this value;
- *        special values can be used (i.e. '<zlib>' for zlib being
+ *        special values can be used (i.e. '&lt;zlib&gt;' for zlib being
  *        used in the main libextractor library and yielding
  *        meta data).
  * @param type libextractor-type describing the meta data

Modified: gnunet/src/fs/gnunet-directory.c
===================================================================
--- gnunet/src/fs/gnunet-directory.c    2010-01-14 14:56:57 UTC (rev 10000)
+++ gnunet/src/fs/gnunet-directory.c    2010-01-14 18:24:18 UTC (rev 10001)
@@ -32,7 +32,11 @@
  *
  * @param cls closure (unused)
  * @param type type of the keyword
- * @param data value of the keyword
+ * @param format format of data
+ * @param data_mime_type mime type of data
+ * @param data value of the meta data
+ * @param data_size number of bytes in data
+ * @return always 0 (to continue iterating)
  */
 static int
 item_printer (void *cls,

Modified: gnunet/src/fs/gnunet-publish.c
===================================================================
--- gnunet/src/fs/gnunet-publish.c      2010-01-14 14:56:57 UTC (rev 10000)
+++ gnunet/src/fs/gnunet-publish.c      2010-01-14 18:24:18 UTC (rev 10001)
@@ -139,7 +139,10 @@
  *
  * @param cls closure
  * @param type type of the meta data
+ * @param format format of data
+ * @param data_mime_type mime type of data
  * @param data value of the meta data
+ * @param data_size number of bytes in data
  * @return always 0
  */
 static int
@@ -169,7 +172,10 @@
  *
  * @param cls closure, target metadata structure
  * @param type type of the meta data
+ * @param format format of data
+ * @param data_mime_type mime type of data
  * @param data value of the meta data
+ * @param data_size number of bytes in data
  * @return always 0
  */
 static int

Modified: gnunet/src/include/gnunet_transport_service.h
===================================================================
--- gnunet/src/include/gnunet_transport_service.h       2010-01-14 14:56:57 UTC 
(rev 10000)
+++ gnunet/src/include/gnunet_transport_service.h       2010-01-14 18:24:18 UTC 
(rev 10001)
@@ -235,10 +235,17 @@
                               const struct GNUNET_MessageHeader *hello);
 
 /**
- *  Obtain a AddressLookupMessage from a client and return to client all the 
host addresses of other peers.
+ * Convert a binary address into a human
+ * readable address.
  *
- *  @param handle connection to transport service
- *  @param addLUmsg the address-lookup message
+ * @param handle connection to transport service
+ * @param cfg configuration to use
+ * @param address address to convert (binary format)
+ * @param addressLen number of bytes in address
+ * @param nameTrans name of the transport to which the address belongs
+ * @param timeout how long is the lookup allowed to take at most
+ * @param aluc function to call with the results
+ * @param aluc_cls closure for aluc
  */
 void
 GNUNET_TRANSPORT_address_lookup (struct GNUNET_SCHEDULER_Handle *sched,
@@ -246,9 +253,9 @@
                                  const char * address,
                                  size_t addressLen,
                                  const char * nameTrans,
-                                        struct GNUNET_TIME_Relative timeout,
-                                        GNUNET_TRANSPORT_AddressLookUpCallback 
aluc,
-                                        void *aluc_cls);
+                                struct GNUNET_TIME_Relative timeout,
+                                GNUNET_TRANSPORT_AddressLookUpCallback aluc,
+                                void *aluc_cls);
 
 
 

Modified: gnunet/src/peerinfo/gnunet-service-peerinfo.c
===================================================================
--- gnunet/src/peerinfo/gnunet-service-peerinfo.c       2010-01-14 14:56:57 UTC 
(rev 10000)
+++ gnunet/src/peerinfo/gnunet-service-peerinfo.c       2010-01-14 18:24:18 UTC 
(rev 10001)
@@ -220,7 +220,7 @@
  * list was previously empty.
  *
  * @param nl client to notify
- * @param hc entry to notify about
+ * @param he entry to notify about
  */
 static void
 do_notify (struct NotifyList *nl,

Modified: gnunet/src/util/container_meta_data.c
===================================================================
--- gnunet/src/util/container_meta_data.c       2010-01-14 14:56:57 UTC (rev 
10000)
+++ gnunet/src/util/container_meta_data.c       2010-01-14 18:24:18 UTC (rev 
10001)
@@ -227,7 +227,7 @@
  *
  * @param md metadata to extend
  * @param plugin_name name of the plugin that produced this value;
- *        special values can be used (i.e. '<zlib>' for zlib being
+ *        special values can be used (i.e. '&lt;zlib&gt;' for zlib being
  *        used in the main libextractor library and yielding
  *        meta data).
  * @param type libextractor-type describing the meta data
@@ -565,7 +565,7 @@
  *
  * @param cls closure, our meta data container
  * @param plugin_name name of the plugin that produced this value;
- *        special values can be used (i.e. '<zlib>' for zlib being
+ *        special values can be used (i.e. '&lt;zlib&gt;' for zlib being
  *        used in the main libextractor library and yielding
  *        meta data).
  * @param type libextractor-type describing the meta data

Modified: gnunet/src/util/pseudonym.c
===================================================================
--- gnunet/src/util/pseudonym.c 2010-01-14 14:56:57 UTC (rev 10000)
+++ gnunet/src/util/pseudonym.c 2010-01-14 18:24:18 UTC (rev 10001)
@@ -541,7 +541,11 @@
  *
  * @param cls metadata to add to
  * @param type type of entry to insert
- * @param data value of entry to insert
+ * @param format format of data
+ * @param data_mime_type mime type of data
+ * @param data value of the meta data
+ * @param data_size number of bytes in data
+ * @return always 0
  */
 static int
 merge_meta_helper (void *cls,