From 838f6b7f1de097f503b619dfc04766578882360d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=96zg=C3=BCr=20Kesim?= Date: Mon, 13 Mar 2023 09:17:44 +0100 Subject: [PATCH] -fix comments for doxygen --- src/include/taler_crypto_lib.h | 4 ++-- src/util/crypto_confirmation.c | 17 ++++++++--------- 2 files changed, 10 insertions(+), 11 deletions(-) diff --git a/src/include/taler_crypto_lib.h b/src/include/taler_crypto_lib.h index 1e3972b5a..4f52d78fa 100644 --- a/src/include/taler_crypto_lib.h +++ b/src/include/taler_crypto_lib.h @@ -950,13 +950,13 @@ GNUNET_NETWORK_STRUCT_END /** - * @brief It is build pos confirmation to verify payment. + * @brief Builds POS confirmation token to verify payment. * * @param pos_key encoded key for verification payment * @param pos_alg algorithm to compute the payment verification * @param total of the order paid * @param ts is the time given - * + * @return POS token on success, NULL otherwise */ char * TALER_build_pos_confirmation (const char *pos_key, diff --git a/src/util/crypto_confirmation.c b/src/util/crypto_confirmation.c index 63d597fd3..c5a674501 100644 --- a/src/util/crypto_confirmation.c +++ b/src/util/crypto_confirmation.c @@ -163,6 +163,14 @@ base32decode (const char *val, } +/** + * @brief Builds POS confirmation to verify payment. + * + * @param h_key opaque key for the totp operation + * @param h_key_len size of h_key in bytes + * @param ts current time + * @return Token on success, NULL of failure + */ static char * executive_totp (void *h_key, size_t h_key_len, @@ -201,15 +209,6 @@ executive_totp (void *h_key, } -/** - * @brief Builds POS confirmation to verify payment. - * - * @param pos_key base32 (RFC 3548, not Crockford!) encoded key for verification payment - * @param pos_alg algorithm to compute the payment verification - * @param total of the order paid - * @param ts is the current time given - * @return Token on success, NULL of failure - */ char * TALER_build_pos_confirmation (const char *pos_key, enum TALER_MerchantConfirmationAlgorithm pos_alg,