From af9252228fabc0b9bea2964fe395ec824c7abffa Mon Sep 17 00:00:00 2001 From: Christian Fuchs Date: Mon, 14 Oct 2013 14:21:41 +0000 Subject: [PATCH] more doxygen compliance, should no longer generate warnings, except for one wired warning which is not in the sourcecode, will talk to christian grothoff about that --- src/include/gnunet_scalarproduct_service.h | 12 ++++++++---- src/scalarproduct/scalarproduct_api.c | 12 ++++++++---- 2 files changed, 16 insertions(+), 8 deletions(-) diff --git a/src/include/gnunet_scalarproduct_service.h b/src/include/gnunet_scalarproduct_service.h index 88b0a6586..1146db1e4 100644 --- a/src/include/gnunet_scalarproduct_service.h +++ b/src/include/gnunet_scalarproduct_service.h @@ -86,9 +86,11 @@ typedef void (*GNUNET_SCALARPRODUCT_DatumProcessor) (void *cls, * @param mask_bytes number of bytes in the mask * @param cont Callback function * @param cont_cls Closure for the callback function + * + * @return a new handle for this computation */ struct GNUNET_SCALARPRODUCT_ComputationHandle * -GNUNET_SCALARPRODUCT_request (const struct GNUNET_CONFIGURATION_Handle *cfg, +GNUNET_SCALARPRODUCT_request (const struct GNUNET_CONFIGURATION_Handle * cfg, const struct GNUNET_HashCode * key, const struct GNUNET_PeerIdentity *peer, const int32_t * elements, @@ -96,7 +98,7 @@ GNUNET_SCALARPRODUCT_request (const struct GNUNET_CONFIGURATION_Handle *cfg, const unsigned char * mask, uint32_t mask_bytes, GNUNET_SCALARPRODUCT_DatumProcessor cont, - void *cont_cls); + void * cont_cls); /** * Used by Bob's client to cooperate with Alice, @@ -107,14 +109,16 @@ GNUNET_SCALARPRODUCT_request (const struct GNUNET_CONFIGURATION_Handle *cfg, * @param element_count Number of elements in the vector * @param cont Callback function * @param cont_cls Closure for the callback function + * + * @return a new handle for this computation */ struct GNUNET_SCALARPRODUCT_ComputationHandle * -GNUNET_SCALARPRODUCT_response (const struct GNUNET_CONFIGURATION_Handle *cfg, +GNUNET_SCALARPRODUCT_response (const struct GNUNET_CONFIGURATION_Handle * cfg, const struct GNUNET_HashCode * key, const int32_t * elements, uint32_t element_count, GNUNET_SCALARPRODUCT_ContinuationWithStatus cont, - void *cont_cls); + void * cont_cls); /** * Cancel an ongoing computation or revoke our collaboration offer. * Closes the connection to the service diff --git a/src/scalarproduct/scalarproduct_api.c b/src/scalarproduct/scalarproduct_api.c index 96b176080..ad5fc1a54 100644 --- a/src/scalarproduct/scalarproduct_api.c +++ b/src/scalarproduct/scalarproduct_api.c @@ -318,14 +318,16 @@ transmit_request (void *cls, size_t size, * @param element_count Number of elements in the vector * @param cont Callback function * @param cont_cls Closure for the callback function + * + * @return a new handle for this computation */ struct GNUNET_SCALARPRODUCT_ComputationHandle * -GNUNET_SCALARPRODUCT_response (const struct GNUNET_CONFIGURATION_Handle *cfg, +GNUNET_SCALARPRODUCT_response (const struct GNUNET_CONFIGURATION_Handle * cfg, const struct GNUNET_HashCode * key, const int32_t * elements, uint32_t element_count, GNUNET_SCALARPRODUCT_ContinuationWithStatus cont, - void *cont_cls) + void * cont_cls) { struct GNUNET_SCALARPRODUCT_ComputationHandle *h; struct GNUNET_SCALARPRODUCT_client_request *msg; @@ -406,9 +408,11 @@ GNUNET_SCALARPRODUCT_response (const struct GNUNET_CONFIGURATION_Handle *cfg, * @param mask_bytes number of bytes in the mask * @param cont Callback function * @param cont_cls Closure for the callback function + * + * @return a new handle for this computation */ struct GNUNET_SCALARPRODUCT_ComputationHandle * -GNUNET_SCALARPRODUCT_request (const struct GNUNET_CONFIGURATION_Handle *cfg, +GNUNET_SCALARPRODUCT_request (const struct GNUNET_CONFIGURATION_Handle * cfg, const struct GNUNET_HashCode * key, const struct GNUNET_PeerIdentity *peer, const int32_t * elements, @@ -416,7 +420,7 @@ GNUNET_SCALARPRODUCT_request (const struct GNUNET_CONFIGURATION_Handle *cfg, const unsigned char * mask, uint32_t mask_bytes, GNUNET_SCALARPRODUCT_DatumProcessor cont, - void *cont_cls) + void * cont_cls) { struct GNUNET_SCALARPRODUCT_ComputationHandle *h; struct GNUNET_SCALARPRODUCT_client_request *msg; -- 2.25.1