doxygen fixes

diff --git a/src/core/core_api_iterate_peers.c b/src/core/core_api_iterate_peers.c
index 6a4e7858d284ee394ec83572ea060ed6ff2c5d11..fb9c01fee3bb36506339f374cafcbb429f0ad953 100644 (file)
--- a/src/core/core_api_iterate_peers.c
+++ b/src/core/core_api_iterate_peers.c
@@ -148,7 +148,6 @@ transmit_request(void *cls,
 /**
  * Obtain statistics and/or change preferences for the given peer.
  *
- * @param sched scheduler to use
  * @param cfg configuration to use
  * @param peer_cb function to call with the peer information
  * @param cb_cls closure for peer_cb

diff --git a/src/include/gnunet_block_plugin.h b/src/include/gnunet_block_plugin.h
index 2a3e9e2ed3cd64d92832f1675044d5a0c9092e96..3d3fb4001b46683c9158f907cb536c44ff1c15b3 100644 (file)
--- a/src/include/gnunet_block_plugin.h
+++ b/src/include/gnunet_block_plugin.h
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file block/gnunet_block_plugin.h
+ * @file include/gnunet_block_plugin.h
  * @brief API for block plugins.  Each block plugin must conform to 
  *        the API specified by this header.
  * @author Christian Grothoff

diff --git a/src/include/gnunet_core_service.h b/src/include/gnunet_core_service.h
index 8c57b23b7447140f17cedf158eb25ee072209838..efbcda60d27dbff4f5b43bc8b52fd4b1a27aceef 100644 (file)
--- a/src/include/gnunet_core_service.h
+++ b/src/include/gnunet_core_service.h
@@ -111,7 +111,7 @@ typedef int
   (*GNUNET_CORE_MessageCallback) (void *cls,
                                   const struct GNUNET_PeerIdentity *other,
                                   const struct GNUNET_MessageHeader *message,
-                                 const struct GNUNET_TRANSPORT_ATS_Information *atsi);
+                                  const struct GNUNET_TRANSPORT_ATS_Information *atsi);
 
 
 /**

diff --git a/src/include/gnunet_crypto_lib.h b/src/include/gnunet_crypto_lib.h
index 5d8b4ab8aef7e69f1a132ace3712572ed89029b9..d0d7266091f5b8a0bbf4a8409f6642d8deced904 100644 (file)
--- a/src/include/gnunet_crypto_lib.h
+++ b/src/include/gnunet_crypto_lib.h
@@ -612,8 +612,6 @@ GNUNET_CRYPTO_hmac_derive_key(struct GNUNET_CRYPTO_AuthKey *key,
  * @param xts_len length of xts
  * @param skm source key material
  * @param skm_len length of skm
- * @param ctx context info
- * @param ctx_len length of ctx
  * @return GNUNET_YES on success
  */
 int

diff --git a/src/include/gnunet_datacache_plugin.h b/src/include/gnunet_datacache_plugin.h
index 6aa9b1d06233df1af431f8275b55f6bcbeb53f4a..cdacd474bd8e3da25bd7ec7cd59d018a6e642a9c 100644 (file)
--- a/src/include/gnunet_datacache_plugin.h
+++ b/src/include/gnunet_datacache_plugin.h
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file datacache/gnunet_datacache_plugin.h
+ * @file include/gnunet_datacache_plugin.h
  * @brief API for database backends for the datacache
  * @author Christian Grothoff
  */

diff --git a/src/include/gnunet_datastore_plugin.h b/src/include/gnunet_datastore_plugin.h
index 832d53a68ad3703d5b2418625502fb9b0c37b0e6..8666dac1007d4cb6714feccf7bddcc0af8132cfc 100644 (file)
--- a/src/include/gnunet_datastore_plugin.h
+++ b/src/include/gnunet_datastore_plugin.h
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file datastore/gnunet_datastore_plugin.h
+ * @file include/gnunet_datastore_plugin.h
  * @brief API for the database backend plugins.
  * @author Christian Grothoff
  */

diff --git a/src/include/gnunet_os_lib.h b/src/include/gnunet_os_lib.h
index 5ff2b48633a96bf0c4ac42184cd8ddcf1698efe1..5326e20cf3e10134afa46c73cf71659536b6fc4a 100644 (file)
--- a/src/include/gnunet_os_lib.h
+++ b/src/include/gnunet_os_lib.h
@@ -188,7 +188,7 @@ struct GNUNET_OS_Process *GNUNET_OS_process_current (void);
 
 
 /**
- * Sends @sig to the process
+ * Sends sig to the process
  *
  * @param proc pointer to process structure
  * @param sig signal

diff --git a/src/include/gnunet_transport_plugin.h b/src/include/gnunet_transport_plugin.h
index 79103172f17f375f97681f892797d1bd70b34e3c..83ecf6fb8bb6f3c1e9f2cc8b1d4b7168aa56d808 100644 (file)
--- a/src/include/gnunet_transport_plugin.h
+++ b/src/include/gnunet_transport_plugin.h
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file transport/gnunet_transport_plugin.h
+ * @file include/gnunet_transport_plugin.h
  * @brief API for the transport services.  This header
  *        specifies the struct that is given to the plugin's entry
  *        method and the other struct that must be returned.

diff --git a/src/nat/bsdqueue.h b/src/nat/bsdqueue.h
index bdef3ac0b371747435df26b73e6568a6b5d48664..7b6cb60b3c7427f34b41a35c620af3727badde86 100644 (file)
--- a/src/nat/bsdqueue.h
+++ b/src/nat/bsdqueue.h
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file nat/bsd-queue.h
+ * @file nat/bsdqueue.h
  * @brief BSD implementation of simple lists
  *
  * @author Milan Bouchet-Valat

diff --git a/src/nat/upnp-minixml.c b/src/nat/upnp-minixml.c
index 9f4bd735d48b2f305e4f99da82420b135727339b..cd2d48739985f9f5b91951f1ec28a2eb69503de9 100644 (file)
--- a/src/nat/upnp-minixml.c
+++ b/src/nat/upnp-minixml.c
@@ -49,7 +49,7 @@
  */
 
 /**
- * @file nat/minixml.c
+ * @file nat/upnp-minixml.c
  * @brief Simple XML parser used by UPnP
  *
  * @author Milan Bouchet-Valat

diff --git a/src/transport/gnunet-service-transport.c b/src/transport/gnunet-service-transport.c
index e9a30145f5807fe2811197dfcc003ad1344c1e25..0bb19a9cf27a0cb9585f0e38cff0a56ba7d7e52a 100644 (file)
--- a/src/transport/gnunet-service-transport.c
+++ b/src/transport/gnunet-service-transport.c
@@ -4693,7 +4693,8 @@ handle_ping(void *cls, const struct GNUNET_MessageHeader *message,
  * @param peer (claimed) identity of the other peer
  * @param message the message, NULL if we only care about
  *                learning about the delay until we should receive again
- * @param distance in overlay hops; use 1 unless DV (or 0 if message == NULL)
+ * @param ats information for automatic transport selection
+ * @param ats_count number of elements in ats not including \0 terminator
  * @param session identifier used for this session (can be NULL)
  * @param sender_address binary address of the sender (if observed)
  * @param sender_address_len number of bytes in sender_address

diff --git a/src/transport/plugin_transport_http.c b/src/transport/plugin_transport_http.c
index a39893a8643c58ab215b6034ba336a43d99384e4..8d6801ce72fb5df1e2f8f4223c53978e3582edbc 100644 (file)
--- a/src/transport/plugin_transport_http.c
+++ b/src/transport/plugin_transport_http.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file transport/gnunet_transport_plugin.http.c
+ * @file transport/plugin_transport_http.c
  * @brief http transport service plugin
  * @author Matthias Wachs
  */

diff --git a/src/transport/plugin_transport_tcp.c b/src/transport/plugin_transport_tcp.c
index 9a6eab01293baa4d8222e6b01f426c87db8aae1a..6110af96af93b1d94ac594cb5e8a5ce275e65189 100644 (file)
--- a/src/transport/plugin_transport_tcp.c
+++ b/src/transport/plugin_transport_tcp.c
@@ -1150,7 +1150,7 @@ select_better_session (struct Session *s1,
  * gnunet-nat-client to send dummy ICMP responses.
  *
  * @param plugin the plugin for this transport
- * @param addr the address of the peer (IPv4-only)
+ * @param sa the address of the peer (IPv4-only)
  */
 static void
 run_gnunet_nat_client (struct Plugin *plugin, 

diff --git a/src/util/crypto_hkdf.c b/src/util/crypto_hkdf.c
index 315a192ba084d98d9f5efb59633c139efca0825e..494f3d0ab9efcda76f4fc560bfb3ccbecefde1de 100644 (file)
--- a/src/util/crypto_hkdf.c
+++ b/src/util/crypto_hkdf.c
@@ -286,8 +286,6 @@ hkdf_ok:
  * @param xts_len length of xts
  * @param skm source key material
  * @param skm_len length of skm
- * @param ctx context info
- * @param ctx_len length of ctx
  * @return GNUNET_YES on success
  */
 int

diff --git a/src/util/scheduler.c b/src/util/scheduler.c
index 13b3f85528391b5d9d658704d4ab4d89593cb1a8..8a647992904c632b1f5dd04bd29a909219ef298f 100644 (file)
--- a/src/util/scheduler.c
+++ b/src/util/scheduler.c
@@ -432,7 +432,6 @@ is_ready (struct Task *task,
 /**
  * Put a task that is ready for execution into the ready queue.
  *
- * @param handle the scheduler
  * @param task task ready for execution
  */
 static void
@@ -451,7 +450,6 @@ queue_ready_task (struct Task *task)
  * Check which tasks are ready and move them
  * to the respective ready queue.
  *
- * @param handle the scheduler
  * @param rs FDs ready for reading
  * @param ws FDs ready for writing
  */