doxygen fixes

15 files changed, 12 insertions, 18 deletions

diff --git a/src/core/core_api_iterate_peers.c b/src/core/core_api_iterate_peers.c
index 6a4e7858d..fb9c01fee 100644
--- 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 2a3e9e2ed..3d3fb4001 100644
--- 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 8c57b23b7..efbcda60d 100644
--- 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 5d8b4ab8a..d0d726609 100644
--- 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 6aa9b1d06..cdacd474b 100644
--- 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 832d53a68..8666dac10 100644
--- 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 5ff2b4863..5326e20cf 100644
--- 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 79103172f..83ecf6fb8 100644
--- 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 bdef3ac0b..7b6cb60b3 100644
--- 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 9f4bd735d..cd2d48739 100644
--- 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 e9a30145f..0bb19a9cf 100644
--- 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 a39893a86..8d6801ce7 100644
--- 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 9a6eab012..6110af96a 100644
--- 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 315a192ba..494f3d0ab 100644
--- 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 13b3f8552..8a6479929 100644
--- 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
  */