From: Matthias Wachs Date: Tue, 21 Dec 2010 16:20:25 +0000 (+0000) Subject: doxygen fixes X-Git-Tag: initial-import-from-subversion-38251~19453 X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=0db3f24b8b16076547f051bc6ec96c24bd7d05bf;p=oweals%2Fgnunet.git doxygen fixes --- 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 */