From 7a1146f147da5446b4b8488cc60d4368aadfe66a Mon Sep 17 00:00:00 2001 From: Marcello Stanisci Date: Mon, 28 May 2018 17:23:05 +0200 Subject: Commenting the remaining "lib" traits. --- src/exchange-lib/testing_api_trait_denom_sig.c | 34 +++++++++++++++++--------- 1 file changed, 22 insertions(+), 12 deletions(-) (limited to 'src/exchange-lib/testing_api_trait_denom_sig.c') diff --git a/src/exchange-lib/testing_api_trait_denom_sig.c b/src/exchange-lib/testing_api_trait_denom_sig.c index e50a3ba8a..5d7d708e8 100644 --- a/src/exchange-lib/testing_api_trait_denom_sig.c +++ b/src/exchange-lib/testing_api_trait_denom_sig.c @@ -36,17 +36,17 @@ /** * Obtain a denomination signature from a @a cmd. * - * @param cmd command to extract trait from - * @param selector which signature to pick if @a cmd has multiple - * on offer - * @param denom_sig[out] set to the signature - * @return #GNUNET_OK on success + * @param cmd command to extract the denom sig from. + * @param index index number associated with the denom sig. + * @param denom_sig[out] set to the offered signature. + * + * @return #GNUNET_OK on success. */ int -TALER_TESTING_get_trait_denom_sig ( - const struct TALER_TESTING_Command *cmd, - unsigned int index, - struct TALER_DenominationSignature **denom_sig) +TALER_TESTING_get_trait_denom_sig + (const struct TALER_TESTING_Command *cmd, + unsigned int index, + struct TALER_DenominationSignature **denom_sig) { return cmd->traits (cmd->cls, (void **) denom_sig, @@ -55,10 +55,20 @@ TALER_TESTING_get_trait_denom_sig ( } + +/** + * Offer denom sig. + * + * @param index index number to associate to the signature on + * offer. + * @param denom_sig the denom sig on offer. + * + * @return the trait. + */ struct TALER_TESTING_Trait -TALER_TESTING_make_trait_denom_sig ( - unsigned int index, - const struct TALER_DenominationSignature *denom_sig) +TALER_TESTING_make_trait_denom_sig + (unsigned int index, + const struct TALER_DenominationSignature *denom_sig) { struct TALER_TESTING_Trait ret = { .index = index, -- cgit v1.2.3