From 5abe350a05db1c69e4e9418c0ca9b60f935028ee Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Sat, 18 Jan 2020 12:34:17 +0100 Subject: doxygen --- src/auditordb/plugin_auditordb_postgres.c | 4 ++++ src/bank-lib/bank_api_parse.c | 5 +++-- src/bank-lib/fakebank.c | 2 +- src/exchange/taler-exchange-httpd_db.h | 2 +- src/exchange/taler-exchange-httpd_refresh_reveal.c | 3 --- src/include/taler_crypto_lib.h | 8 ++++---- src/util/crypto_wire.c | 2 +- 7 files changed, 14 insertions(+), 12 deletions(-) diff --git a/src/auditordb/plugin_auditordb_postgres.c b/src/auditordb/plugin_auditordb_postgres.c index f231af279..16ca896de 100644 --- a/src/auditordb/plugin_auditordb_postgres.c +++ b/src/auditordb/plugin_auditordb_postgres.c @@ -1949,6 +1949,9 @@ postgres_insert_wire_auditor_account_progress (void *cls, * @param session connection to use * @param master_pub master key of the exchange * @param account_name name of the wire account we are auditing + * @param pp where is the auditor in processing + * @param in_wire_off how far are we in the incoming wire transaction history + * @param out_wire_off how far are we in the outgoing wire transaction history * @return transaction status code */ static enum GNUNET_DB_QueryStatus @@ -2782,6 +2785,7 @@ postgres_get_balance_summary (void *cls, * @param revenue_balance what was the total profit made from * deposit fees, melting fees, refresh fees * and coins that were never returned? + * @param loss_balance total losses suffered by the exchange at the time * @return transaction status code */ static enum GNUNET_DB_QueryStatus diff --git a/src/bank-lib/bank_api_parse.c b/src/bank-lib/bank_api_parse.c index eaee04ba3..33ba6022d 100644 --- a/src/bank-lib/bank_api_parse.c +++ b/src/bank-lib/bank_api_parse.c @@ -28,7 +28,7 @@ * * @param cfg configuration to parse * @param section the section with the configuration data - * @param auth[out] set to the configuration data found + * @param[out] auth set to the configuration data found * @return #GNUNET_OK on success */ int @@ -126,7 +126,7 @@ TALER_BANK_auth_parse_cfg (const struct GNUNET_CONFIGURATION_Handle *cfg, * Free memory inside of @a auth (but not auth itself). * Dual to #TALER_BANK_auth_parse_cfg(). * - * @param auth authentication data to free + * @param[in] auth authentication data to free */ void TALER_BANK_auth_free (struct TALER_BANK_AuthenticationData *auth) @@ -149,6 +149,7 @@ TALER_BANK_auth_free (struct TALER_BANK_AuthenticationData *auth) break; } GNUNET_free (auth->wire_gateway_url); + auth->wire_gateway_rul = NULL; } diff --git a/src/bank-lib/fakebank.c b/src/bank-lib/fakebank.c index bb639ea48..ea0f23ac8 100644 --- a/src/bank-lib/fakebank.c +++ b/src/bank-lib/fakebank.c @@ -230,7 +230,7 @@ check_log (struct TALER_FAKEBANK_Handle *h) * @param h bank instance * @param want_amount transfer amount desired * @param want_debit account that should have been debited - * @param want_debit account that should have been credited + * @param want_credit account that should have been credited * @param exchange_base_url expected base URL of the exchange, * i.e. "https://example.com/"; may include a port * @param[out] wtid set to the wire transfer identifier diff --git a/src/exchange/taler-exchange-httpd_db.h b/src/exchange/taler-exchange-httpd_db.h index e6d38d7fe..148358568 100644 --- a/src/exchange/taler-exchange-httpd_db.h +++ b/src/exchange/taler-exchange-httpd_db.h @@ -94,7 +94,7 @@ typedef enum GNUNET_DB_QueryStatus * * @param connection MHD connection to run @a cb for * @param name name of the transaction (for debugging) - * @param[out] set to MHD response code, if transaction failed + * @param[out] mhd_ret set to MHD response code, if transaction failed * @param cb callback implementing transaction logic * @param cb_cls closure for @a cb, must be read-only! * @return #GNUNET_OK on success, #GNUNET_SYSERR on failure diff --git a/src/exchange/taler-exchange-httpd_refresh_reveal.c b/src/exchange/taler-exchange-httpd_refresh_reveal.c index 2035bd9f8..9b13c2376 100644 --- a/src/exchange/taler-exchange-httpd_refresh_reveal.c +++ b/src/exchange/taler-exchange-httpd_refresh_reveal.c @@ -181,7 +181,6 @@ struct RevealContext * again. * * @param cls closure with a `struct RevealContext` - * @param rowid unique serial ID for the row in our database * @param num_newcoins size of the @a rrcs array * @param rrcs array of @a num_newcoins information about coins to be created * @param num_tprivs number of entries in @a tprivs, should be #TALER_CNC_KAPPA - 1 @@ -523,7 +522,6 @@ refresh_reveal_persist (void *cls, * @param key_state the key state * @param connection the MHD connection to handle * @param rctx context for the operation, partially built at this time - * @param transfer_pub transfer public key * @param link_sigs_json link signatures in JSON format * @param new_denoms_h_json requests for fresh coins to be created * @param coin_evs envelopes of gamma-selected coins to be signed @@ -795,7 +793,6 @@ cleanup: * * @param connection the MHD connection to handle * @param rctx context for the operation, partially built at this time - * @param transfer_pub transfer public key * @param tp_json private transfer keys in JSON format * @param link_sigs_json link signatures in JSON format * @param new_denoms_h_json requests for fresh coins to be created diff --git a/src/include/taler_crypto_lib.h b/src/include/taler_crypto_lib.h index 3e8bac650..eedeec211 100644 --- a/src/include/taler_crypto_lib.h +++ b/src/include/taler_crypto_lib.h @@ -742,7 +742,7 @@ TALER_refresh_get_commitment (struct TALER_RefreshCommitmentP *rc, * hash is what is put into the contract. * * @param payto_url bank account - * @param hc[out] set to the hash + * @param[out] hc set to the hash */ void TALER_exchange_wire_signature_hash (const char *payto_url, @@ -770,7 +770,7 @@ TALER_exchange_wire_signature_check (const char *payto_url, * * @param payto_url account specification * @param master_priv private key to sign with - * @param master_sig[out] where to write the signature + * @param[out] master_sig where to write the signature */ void TALER_exchange_wire_signature_make (const char *payto_url, @@ -785,7 +785,7 @@ TALER_exchange_wire_signature_make (const char *payto_url, * * @param payto_url bank account * @param salt salt used to eliminate brute-force inversion - * @param hc[out] set to the hash + * @param[out] hc set to the hash */ void TALER_merchant_wire_signature_hash (const char *payto_url, @@ -817,7 +817,7 @@ TALER_merchant_wire_signature_check (const char *payto_url, * @param payto_url account specification * @param salt the salt used to salt the @a payto_url when hashing * @param merch_priv private key to sign with - * @param merch_sig[out] where to write the signature + * @param[out] merch_sig where to write the signature */ void TALER_merchant_wire_signature_make (const char *payto_url, diff --git a/src/util/crypto_wire.c b/src/util/crypto_wire.c index e799812e4..de7e5b99c 100644 --- a/src/util/crypto_wire.c +++ b/src/util/crypto_wire.c @@ -28,7 +28,7 @@ * hash is what is put into the contract. * * @param payto_url bank account - * @param hc[out] set to the hash + * @param[out] hc set to the hash */ void TALER_exchange_wire_signature_hash (const char *payto_url, -- cgit v1.2.3