fixing docu issues

diff --git a/src/arm/arm_api.c b/src/arm/arm_api.c
index 7ae3e9513da473feadbff7ad5b770d6fd8c6bfb8..e5071c4dcf61b531e9b10193aed0706dc0c9fb2a 100644 (file)
--- a/src/arm/arm_api.c
+++ b/src/arm/arm_api.c
@@ -33,18 +33,52 @@
 #include "arm.h"
 
 
+/**
+ * FIXME: document.
+ */
 struct ArmContext
 {
+
+  /**
+   * FIXME: document.
+   */
   GNUNET_ARM_Callback callback;
+
+  /**
+   * FIXME: document.
+   */
   void *cls;
+
+  /**
+   * FIXME: document.
+   */
   char *service_name;
+
+  /**
+   * FIXME: document.
+   */
   struct GNUNET_CLIENT_Connection *client;
+
+  /**
+   * FIXME: document.
+   */
   const struct GNUNET_CONFIGURATION_Handle *cfg;
+
+  /**
+   * FIXME: document.
+   */
   struct GNUNET_TIME_Absolute timeout;
+
+  /**
+   * FIXME: document.
+   */
   uint16_t type;
 };
 
 
+/**
+ * FIXME: document.
+ */
 static void
 arm_service_report (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
 {
@@ -192,6 +226,7 @@ send_service_msg (void *cls, size_t size, void *buf)
  * @param timeout how long to wait before failing for good
  * @param cb callback to invoke when service is ready
  * @param cb_cls closure for callback
+ * @param type type of the request 
  */
 static void
 change_service (const char *service_name,

diff --git a/src/datacache/datacache.c b/src/datacache/datacache.c
index 3b233d16ddcd5ff85c8524bd9b87c89de5896b23..afdfb0c4c8b651cba6c8c46d6f3653f2858183b0 100644 (file)
--- a/src/datacache/datacache.c
+++ b/src/datacache/datacache.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file datacache/datacache_api.c
+ * @file datacache/datacache.c
  * @brief datacache API implementation
  * @author Christian Grothoff
  */

diff --git a/src/datacache/plugin_datacache.h b/src/datacache/plugin_datacache.h
index 39119339ddc1487afbde707bf0afd08736f59fc5..d3768cf441ca1b73c12a8b2cd972a640dad7f332 100644 (file)
--- a/src/datacache/plugin_datacache.h
+++ b/src/datacache/plugin_datacache.h
@@ -105,7 +105,7 @@ struct GNUNET_DATACACHE_PluginFunctions {
   /**
    * Store an item in the datastore.
    *
-   * @param key key to store data under
+   * @param cls closure (internal context for the plugin)
    * @param size number of bytes in data
    * @param data data to store
    * @param type type of the value
@@ -124,9 +124,11 @@ struct GNUNET_DATACACHE_PluginFunctions {
    * Iterate over the results for a particular key
    * in the datastore.
    *
+   * @param cls closure (internal context for the plugin)
    * @param key
    * @param type entries of which type are relevant?
    * @param iter maybe NULL (to just count)
+   * @param iter_cls closure for iter
    * @return the number of results found
    */
   unsigned int (*get) (void *cls,
@@ -140,6 +142,7 @@ struct GNUNET_DATACACHE_PluginFunctions {
    * Delete the entry with the lowest expiration value
    * from the datacache right now.
    * 
+   * @param cls closure (internal context for the plugin)
    * @return GNUNET_OK on success, GNUNET_SYSERR on error
    */ 
   int (*del) (void *cls);

diff --git a/src/datacache/plugin_datacache_sqlite.c b/src/datacache/plugin_datacache_sqlite.c
index e8ef5cd098b7c7b296815324fd6f1349c6ce2e14..7595211c10cf228e381bd4f3a8bc57bc818616f9 100644 (file)
--- a/src/datacache/plugin_datacache_sqlite.c
+++ b/src/datacache/plugin_datacache_sqlite.c
@@ -86,6 +86,7 @@ sq_prepare (sqlite3 * dbh, const char *zSql,    /* SQL statement, UTF-8 encoded
 /**
  * Store an item in the datastore.
  *
+ * @param cls closure (our "struct Plugin")
  * @param key key to store data under
  * @param size number of bytes in data
  * @param data data to store
@@ -155,9 +156,11 @@ sqlite_plugin_put (void *cls,
  * Iterate over the results for a particular key
  * in the datastore.
  *
+ * @param cls closure (our "struct Plugin")
  * @param key
  * @param type entries of which type are relevant?
  * @param iter maybe NULL (to just count)
+ * @param iter_cls closure for iter
  * @return the number of results found
  */
 static unsigned int 
@@ -259,6 +262,7 @@ sqlite_plugin_get (void *cls,
  * Delete the entry with the lowest expiration value
  * from the datacache right now.
  * 
+ * @param cls closure (our "struct Plugin")
  * @return GNUNET_OK on success, GNUNET_SYSERR on error
  */ 
 static int 
@@ -337,6 +341,9 @@ sqlite_plugin_del (void *cls)
 
 /**
  * Entry point for the plugin.
+ *
+ * @param cls closure (the "struct GNUNET_DATACACHE_PluginEnvironmnet")
+ * @return the plugin's closure (our "struct Plugin")
  */
 void *
 libgnunet_plugin_datacache_sqlite_init (void *cls)
@@ -398,6 +405,9 @@ libgnunet_plugin_datacache_sqlite_init (void *cls)
 
 /**
  * Exit point from the plugin.
+ *
+ * @param cls closure (our "struct Plugin")
+ * @return NULL
  */
 void *
 libgnunet_plugin_datacache_sqlite_done (void *cls)

diff --git a/src/datacache/plugin_datacache_template.c b/src/datacache/plugin_datacache_template.c
index 501284c30b0612807a81a4e960a7896bde771591..163f72a7ad631590f34e2be7b643cd44fb1b8c32 100644 (file)
--- a/src/datacache/plugin_datacache_template.c
+++ b/src/datacache/plugin_datacache_template.c
@@ -43,6 +43,7 @@ struct Plugin
 /**
  * Store an item in the datastore.
  *
+ * @param cls closure (our "struct Plugin")
  * @param key key to store data under
  * @param size number of bytes in data
  * @param data data to store
@@ -67,9 +68,11 @@ template_plugin_put (void *cls,
  * Iterate over the results for a particular key
  * in the datastore.
  *
+ * @param cls closure (our "struct Plugin")
  * @param key
  * @param type entries of which type are relevant?
  * @param iter maybe NULL (to just count)
+ * @param iter_cls closure for iter
  * @return the number of results found
  */
 static unsigned int 
@@ -88,6 +91,7 @@ template_plugin_get (void *cls,
  * Delete the entry with the lowest expiration value
  * from the datacache right now.
  * 
+ * @param cls closure (our "struct Plugin")
  * @return GNUNET_OK on success, GNUNET_SYSERR on error
  */ 
 static int 
@@ -100,6 +104,9 @@ template_plugin_del (void *cls)
 
 /**
  * Entry point for the plugin.
+ *
+ * @param cls closure (the "struct GNUNET_DATACACHE_PluginEnvironmnet")
+ * @return the plugin's closure (our "struct Plugin")
  */
 void *
 libgnunet_plugin_datacache_template_init (void *cls)
@@ -123,6 +130,9 @@ libgnunet_plugin_datacache_template_init (void *cls)
 
 /**
  * Exit point from the plugin.
+ *
+ * @param cls closure (our "struct Plugin")
+ * @return NULL
  */
 void *
 libgnunet_plugin_datacache_template_done (void *cls)

diff --git a/src/datastore/datastore_api.c b/src/datastore/datastore_api.c
index 929698a5bd99fd199a210d72082ba8551579d10d..7b674087ecc60a50f76c33b15aff30ae923e7c03 100644 (file)
--- a/src/datastore/datastore_api.c
+++ b/src/datastore/datastore_api.c
@@ -335,6 +335,8 @@ transmit_for_status (struct GNUNET_DATASTORE_Handle *h,
  * lower anonymity level is used.
  *
  * @param h handle to the datastore
+ * @param rid reservation ID to use (from "reserve"); use 0 if no
+ *            prior reservation was made
  * @param key key for the value
  * @param size number of bytes in data
  * @param data content stored

diff --git a/src/datastore/gnunet-service-datastore.c b/src/datastore/gnunet-service-datastore.c
index 900c1a8c8eec8cf7c370540b2e9a9195b2e3c046..f139998e909bb6f3eaa9256f3bdbf9c7e96ed27e 100644 (file)
--- a/src/datastore/gnunet-service-datastore.c
+++ b/src/datastore/gnunet-service-datastore.c
@@ -456,6 +456,8 @@ transmit_callback (void *cls,
  *
  * @param client target of the message
  * @param msg message to transmit, will be freed!
+ * @param tc function to call afterwards
+ * @param tc_cls closure for tc
  * @param end is this the last response (and we should
  *        signal the server completion accodingly after
  *        transmitting this message)?
@@ -537,7 +539,7 @@ transmit_status (struct GNUNET_SERVER_Client *client,
  * Function called once the transmit operation has
  * either failed or succeeded.
  *
- * @param cls closure
+ * @param next_cls closure for calling "next_request" callback
  * @param status GNUNET_OK on success, GNUNET_SYSERR on error
  */
 static void 

diff --git a/src/fs/gnunet-service-fs.c b/src/fs/gnunet-service-fs.c
index 18cb69d68c5b0a4fc069598c364a4770eaa3d4f5..2fad754c0535f1cad213ed9807c1cb14ae0a132a 100644 (file)
--- a/src/fs/gnunet-service-fs.c
+++ b/src/fs/gnunet-service-fs.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file statistics/gnunet-service-fs.c
+ * @file fs/gnunet-service-fs.c
  * @brief program that provides the file-sharing service
  * @author Christian Grothoff
  */

diff --git a/src/include/gnunet_fs_service.h b/src/include/gnunet_fs_service.h
index 108c0c68f3077bd5ac39253aa6cc7d07ab09ce21..f89a343b96a0e7e9dd0a5ccce6260deac1083386 100644 (file)
--- a/src/include/gnunet_fs_service.h
+++ b/src/include/gnunet_fs_service.h
@@ -382,7 +382,9 @@ GNUNET_FS_uri_test_loc (const struct GNUNET_FS_Uri *uri);
  * Construct a keyword-URI from meta-data (take all entries
  * in the meta-data and construct one large keyword URI
  * that lists all keywords that can be found in the meta-data).
- * @deprecated
+ *
+ * @param md metadata to use
+ * @return NULL on error, otherwise a KSK URI
  */
 struct GNUNET_FS_Uri *
 GNUNET_FS_uri_ksk_create_from_meta_data (const struct GNUNET_CONTAINER_MetaData *md);

diff --git a/src/include/gnunet_getopt_lib.h b/src/include/gnunet_getopt_lib.h
index e7063d3d0aaf1a181fa9f0a303f29b1e160a7cbd..35db3f6d192f4ae1d40f95195d6ad41256858f61 100644 (file)
--- a/src/include/gnunet_getopt_lib.h
+++ b/src/include/gnunet_getopt_lib.h
@@ -99,7 +99,7 @@ struct GNUNET_GETOPT_CommandLineOption
 {
 
   /**
-   * Short name of the option (use '\0' for none).
+   * Short name of the option (use '\\0' for none).
    */
   const char shortName;
 

diff --git a/src/include/winproc.h b/src/include/winproc.h
index 9619f60d91c0bc620d94629453bf04f15992dace..a4241814187202841a4c806f7ff94f2b26b7d405 100644 (file)
--- a/src/include/winproc.h
+++ b/src/include/winproc.h
@@ -19,10 +19,10 @@
 */
 
 /**
- * @file util/winproc.h
+ * @file include/winproc.h
  * @brief Definitions for MS Windows
  * @author Nils Durner
- **/
+ */
 
 #ifndef _WINPROC_H
 #define _WINPROC_H

diff --git a/src/transport/gnunet-transport.c b/src/transport/gnunet-transport.c
index 52475e3eb11549cbf4fb645534420bf9f07d280b..17f6e6f7852e9f1a81bb029882bc8102d90ffd57 100644 (file)
--- a/src/transport/gnunet-transport.c
+++ b/src/transport/gnunet-transport.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file server/gnunet-transport.c
+ * @file src/transport/gnunet-transport.c
  * @brief Tool to help configure the transports.
  * @author Christian Grothoff
  *

diff --git a/src/transport/plugin_transport_http.c b/src/transport/plugin_transport_http.c
index 78691852d646af46cf348724c44f06a77ae69f8e..c2f531b54d2ea234e82482906283562e828eb371 100644 (file)
--- a/src/transport/plugin_transport_http.c
+++ b/src/transport/plugin_transport_http.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file transports/http.c
+ * @file transport/plugin_transport_http.c
  * @brief Implementation of the HTTP transport service
  * @author Christian Grothoff
  */

diff --git a/src/transport/plugin_transport_smtp.c b/src/transport/plugin_transport_smtp.c
index f7cc530e486ee892ce6aa774037255ee8ceec045..b93b16fb70f1768ab6583a734e650277a86de536 100644 (file)
--- a/src/transport/plugin_transport_smtp.c
+++ b/src/transport/plugin_transport_smtp.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file transports/smtp.c
+ * @file transport/plugin_transport_smtp.c
  * @brief Implementation of the SMTP transport service
  * @author Christian Grothoff
  * @author Renaldo Ferreira

diff --git a/src/transport/plugin_transport_udp.c b/src/transport/plugin_transport_udp.c
index ce8a2f89caa1e2dcb4c0bf48232aef9dda5a957e..84002599739073220e75e905480e4a3ce45fccb0 100644 (file)
--- a/src/transport/plugin_transport_udp.c
+++ b/src/transport/plugin_transport_udp.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file transports/udp.c
+ * @file transport/plugin_transport_udp.c
  * @brief Implementation of the UDP transport service
  * @author Christian Grothoff
  */

diff --git a/src/upnp/upnp_init.c b/src/upnp/upnp_init.c
index b0eb77c32894a69faeccfdd4bdb038764e9c9053..19167342b1b80f161ff60c545c1baf140a5bd394 100644 (file)
--- a/src/upnp/upnp_init.c
+++ b/src/upnp/upnp_init.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file src/transports/upnp/init.c
+ * @file transport/upnp_init.c
  * @brief API for UPnP access
  * @author Christian Grothoff
  */

diff --git a/src/upnp/upnp_ip.c b/src/upnp/upnp_ip.c
index 3716fc67192df1e6e1b74b64cca80f7f827b45e5..cb102cba5d17f87c2a4b1f498eba205fadbf448a 100644 (file)
--- a/src/upnp/upnp_ip.c
+++ b/src/upnp/upnp_ip.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file transports/upnp/ip.c
+ * @file transport/upnp_ip.c
  * @brief code to determine the IP of the local machine
  *
  * @author Christian Grothoff

diff --git a/src/upnp/upnp_ip.h b/src/upnp/upnp_ip.h
index adc06bbd530e0b5e98abb0183defcdbc9a3c5ce2..62cb05f5eb34ba1d8f012582c7baa61bdf546b99 100644 (file)
--- a/src/upnp/upnp_ip.h
+++ b/src/upnp/upnp_ip.h
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file transports/upnp/ip.h
+ * @file transport/upnp_ip.h
  * @brief
  *
  * @author Christian Grothoff

diff --git a/src/upnp/upnp_util.h b/src/upnp/upnp_util.h
index 89a8d71cfab1ce391a5b6be4929678e92a1e503d..32c790493511b7d75e1c539094b1830819ab0b79 100644 (file)
--- a/src/upnp/upnp_util.h
+++ b/src/upnp/upnp_util.h
@@ -1,5 +1,5 @@
 /**
- * @file util.h Utility Functions
+ * @file transport/upnp_util.h Utility Functions
  * @ingroup core
  *
  * gaim

diff --git a/src/upnp/upnp_xmlnode.c b/src/upnp/upnp_xmlnode.c
index b37528f006f5aae1b1cf1efe3557c6fa7cca245c..aeea157e13b7a8f5de638cd1ae74ac5ac10b321d 100644 (file)
--- a/src/upnp/upnp_xmlnode.c
+++ b/src/upnp/upnp_xmlnode.c
@@ -1,5 +1,5 @@
 /**
- * @file xmlnode.c XML DOM functions
+ * @file transport/upnp_xmlnode.c XML DOM functions
  *
  * gaim
  *

diff --git a/src/upnp/upnp_xmlnode.h b/src/upnp/upnp_xmlnode.h
index 199975e37e9e07d0f4ad07a501b94840ab201a1d..191ef14d2c9f9750f5b264f9431fb2b282491966 100644 (file)
--- a/src/upnp/upnp_xmlnode.h
+++ b/src/upnp/upnp_xmlnode.h
@@ -1,5 +1,5 @@
 /**
- * @file xmlnode.h XML DOM functions
+ * @file transport/upnp_xmlnode.h XML DOM functions
  * @ingroup core
  *
  * gaim

diff --git a/src/util/common_allocation.c b/src/util/common_allocation.c
index 71ebb09059e4f7ab37a20055bf7c706d6df949c1..7a79eef6d9ff60b5caf8ed0eb897c20c6643199e 100644 (file)
--- a/src/util/common_allocation.c
+++ b/src/util/common_allocation.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file util/memory/common_allocation.c
+ * @file util/common_allocation.c
  * @brief wrapper around malloc/free
  * @author Christian Grothoff
  */

diff --git a/src/util/network.c b/src/util/network.c
index 7e4743a1079e8dd449eaa6a57cd5536716782fe2..e112d90932241884d8a54d77cf5b3a7ed3835a91 100644 (file)
--- a/src/util/network.c
+++ b/src/util/network.c
@@ -19,7 +19,7 @@
 */\r
 \r
 /**\r
- * @file util/sock.c\r
+ * @file util/network.c\r
  * @brief basic, low-level networking interface\r
  * @author Nils Durner\r
  */\r
@@ -821,4 +821,4 @@ GNUNET_NETWORK_socket_select (struct GNUNET_NETWORK_FDSet *rfds,
 #endif\r
 }\r
 \r
-/* end of network_socket.c */\r
+/* end of network.c */\r

diff --git a/src/util/os_load.c b/src/util/os_load.c
index 21e74eb49d0c7aca097823de07806f01dc5101ca..a5a197ebefea4949eb22bbd842d1eb2a46359747 100644 (file)
--- a/src/util/os_load.c
+++ b/src/util/os_load.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file util/os_load_cpu.c
+ * @file util/os_load.c
  * @brief calls to determine current CPU load
  * @author Tzvetan Horozov
  * @author Christian Grothoff
@@ -650,4 +650,4 @@ void __attribute__ ((destructor)) GNUNET_cpustats_ltdl_fini ()
 }
 
 
-/* end of os_load_cpu.c */
+/* end of os_load.c */

diff --git a/src/util/os_priority.c b/src/util/os_priority.c
index 4e820b8d5cfda1e8efb95d06e35228edb407e762..46e2deb5c7dd98f3d2075f708914701cd8d96f26 100644 (file)
--- a/src/util/os_priority.c
+++ b/src/util/os_priority.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file util/os/priority.c
+ * @file util/os_priority.c
  * @brief Methods to set process priority
  * @author Nils Durner
  */

diff --git a/src/util/scheduler.c b/src/util/scheduler.c
index d1d4e19709cccf7e5d0fa171a46774a2e3ddd19c..12b7c4cf223754a51907f90a5d13d00082fbd024 100644 (file)
--- a/src/util/scheduler.c
+++ b/src/util/scheduler.c
@@ -19,7 +19,7 @@
  */
 
 /**
- * @file util/scheduler/scheduler.c
+ * @file util/scheduler.c
  * @brief schedule computations using continuation passing style
  * @author Christian Grothoff
  */

diff --git a/src/util/win.cc b/src/util/win.cc
index 8e71744d0492382affe5cb975790d6eefd4ef22d..8a168d23832edcb947ea1b108c36e8453ac635d8 100644 (file)
--- a/src/util/win.cc
+++ b/src/util/win.cc
@@ -19,10 +19,10 @@
 */\r
 \r
 /**\r
- * @file util/win/win.cc\r
+ * @file util/win.cc\r
  * @brief Helper functions for MS Windows in C++\r
  * @author Nils Durner\r
- **/\r
+ */\r
 \r
 #ifndef _WIN_CC\r
 #define _WIN_CC\r

diff --git a/src/util/winproc.c b/src/util/winproc.c
index 469e1fb416c0be8e63b2bb6d35d6f5eb650f346c..862222c05ec76cb00ed78699b5addb7ffc1e7210 100644 (file)
--- a/src/util/winproc.c
+++ b/src/util/winproc.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file util/win/winproc.c
+ * @file util/winproc.c
  * @brief Functions for MS Windows
  * @author Nils Durner
  */