diff options
author | Christian Grothoff <christian@grothoff.org> | 2022-02-12 11:12:33 +0100 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2022-02-12 11:12:33 +0100 |
commit | bc14c215b3a29da0d8fbb9c3f7b577a3155c2943 (patch) | |
tree | 5d962ab9d2fbd6686a9b094e0ae1d7dee551cac0 /src/include | |
parent | 819b67426c95b68af800dae4b1dc700cfed822bd (diff) | |
download | exchange-bc14c215b3a29da0d8fbb9c3f7b577a3155c2943.tar.xz |
-doxygen fixes
Diffstat (limited to 'src/include')
-rw-r--r-- | src/include/taler_auditor_service.h | 2 | ||||
-rw-r--r-- | src/include/taler_crypto_lib.h | 15 | ||||
-rw-r--r-- | src/include/taler_exchange_service.h | 5 | ||||
-rw-r--r-- | src/include/taler_exchangedb_plugin.h | 1 | ||||
-rw-r--r-- | src/include/taler_mhd_lib.h | 2 | ||||
-rw-r--r-- | src/include/taler_pq_lib.h | 10 | ||||
-rw-r--r-- | src/include/taler_testing_lib.h | 27 |
7 files changed, 19 insertions, 43 deletions
diff --git a/src/include/taler_auditor_service.h b/src/include/taler_auditor_service.h index f71520345..1d252f9d2 100644 --- a/src/include/taler_auditor_service.h +++ b/src/include/taler_auditor_service.h @@ -259,7 +259,7 @@ TALER_AUDITOR_deposit_confirmation ( const struct TALER_MerchantWireHash *h_wire, const struct TALER_ExtensionContractHash *h_extensions, const struct TALER_PrivateContractHash *h_contract_terms, - struct GNUNET_TIME_Timestamp timestamp, + struct GNUNET_TIME_Timestamp exchange_timestamp, struct GNUNET_TIME_Timestamp wire_deadline, struct GNUNET_TIME_Timestamp refund_deadline, const struct TALER_Amount *amount_without_fee, diff --git a/src/include/taler_crypto_lib.h b/src/include/taler_crypto_lib.h index 62a958f76..dc721436b 100644 --- a/src/include/taler_crypto_lib.h +++ b/src/include/taler_crypto_lib.h @@ -1126,7 +1126,6 @@ TALER_denom_sign_blinded (struct TALER_BlindedDenominationSignature *denom_sig, * Unblind blinded signature. * * @param[out] denom_sig where to write the unblinded signature - * @param dk denomination public key * @param bdenom_sig the blinded signature * @param bks blinding secret to use * @param c_hash hash of the coin's public key for verification of the signature @@ -1242,8 +1241,8 @@ TALER_blinded_denom_sig_cmp ( /** * Compare two blinded planchets. * - * @param sig1 first blinded planchet - * @param sig2 second blinded planchet + * @param bp1 first blinded planchet + * @param bp2 second blinded planchet * @return 0 if the keys are equal, otherwise -1 or 1 */ int @@ -1299,7 +1298,7 @@ TALER_test_coin_valid (const struct TALER_CoinPublicInfo *coin_public_info, * Compute the hash of a blinded coin. * * @param blinded_planchet blinded planchet - * @param denom_pub denomination publick key + * @param denom_hash hash of the denomination publick key * @param[out] bch where to write the hash * @return #GNUNET_OK when successful, #GNUNET_SYSERR if an internal error occured */ @@ -1806,7 +1805,7 @@ TALER_CRYPTO_helper_rsa_sign ( /** - * Ask the helper to revoke the public key associated with @param h_denom_pub . + * Ask the helper to revoke the public key associated with @a h_denom_pub. * Will cause the helper to tell all clients that the key is now unavailable, * and to create a replacement key. * @@ -1926,7 +1925,7 @@ TALER_CRYPTO_helper_cs_sign ( /** - * Ask the helper to revoke the public key associated with @param h_cs . + * Ask the helper to revoke the public key associated with @a h_cs. * Will cause the helper to tell all clients that the key is now unavailable, * and to create a replacement key. * @@ -1947,8 +1946,8 @@ TALER_CRYPTO_helper_cs_revoke ( /** - * Ask the helper to derive R using the @param nonce and denomination key - * associated with @param h_cs. + * Ask the helper to derive R using the @a nonce and denomination key + * associated with @a h_cs. * * This operation will block until the R has been obtained. Should * this process receive a signal (that is not ignored) while the operation is diff --git a/src/include/taler_exchange_service.h b/src/include/taler_exchange_service.h index ca5f2ae8f..72990dc3d 100644 --- a/src/include/taler_exchange_service.h +++ b/src/include/taler_exchange_service.h @@ -1669,8 +1669,7 @@ typedef void * * This API is typically used by a wallet. Note that to ensure that * no money is lost in case of hardware failures, the provided - * argument should have been constructed using - * #TALER_EXCHANGE_refresh_prepare and committed to persistent storage + * argument @a rd should be committed to persistent storage * prior to calling this function. * * @param exchange the exchange handle; the exchange must be ready to operate @@ -2414,7 +2413,7 @@ struct TALER_EXCHANGE_KycProofResponse * Function called with the result of a KYC check. * * @param cls closure - * @param ks the account's KYC status details + * @param kpr the account's KYC status details */ typedef void (*TALER_EXCHANGE_KycProofCallback)( diff --git a/src/include/taler_exchangedb_plugin.h b/src/include/taler_exchangedb_plugin.h index 13ba74053..844de5853 100644 --- a/src/include/taler_exchangedb_plugin.h +++ b/src/include/taler_exchangedb_plugin.h @@ -1886,7 +1886,6 @@ typedef void * @param cls closure * @param rowid which row in the table is the information from (for diagnostics) * @param merchant_pub public key of the merchant (should be same for all callbacks with the same @e cls) - * @param h_wire hash of wire transfer details of the merchant (should be same for all callbacks with the same @e cls) * @param account_payto_uri which account did the transfer go to? * @param exec_time execution time of the wire transfer (should be same for all callbacks with the same @e cls) * @param h_contract_terms which proposal was this payment about diff --git a/src/include/taler_mhd_lib.h b/src/include/taler_mhd_lib.h index b0012a645..dc68df06b 100644 --- a/src/include/taler_mhd_lib.h +++ b/src/include/taler_mhd_lib.h @@ -547,7 +547,7 @@ struct TALER_MHD_Legal; /** * Load set of legal documents as specified in @a cfg in section @a section - * where the Etag is given under the @param tagoption and the directory under + * where the Etag is given under the @a tagoption and the directory under * the @a diroption. * * @param cfg configuration to use diff --git a/src/include/taler_pq_lib.h b/src/include/taler_pq_lib.h index 81f5c9872..fdc17ca55 100644 --- a/src/include/taler_pq_lib.h +++ b/src/include/taler_pq_lib.h @@ -58,7 +58,7 @@ TALER_PQ_query_param_amount (const struct TALER_Amount *x); * public key will be serialized into on variable-size * BLOB. * - * @param x pointer to the query parameter to pass + * @param denom_pub pointer to the query parameter to pass */ struct GNUNET_PQ_QueryParam TALER_PQ_query_param_denom_pub ( @@ -70,7 +70,7 @@ TALER_PQ_query_param_denom_pub ( * various attributes of the signature will be serialized into on * variable-size BLOB. * - * @param x pointer to the query parameter to pass + * @param denom_sig pointer to the query parameter to pass */ struct GNUNET_PQ_QueryParam TALER_PQ_query_param_denom_sig ( @@ -83,7 +83,7 @@ TALER_PQ_query_param_denom_sig ( * planchet will be serialized into on * variable-size BLOB. * - * @param x pointer to the query parameter to pass + * @param bp pointer to the query parameter to pass */ struct GNUNET_PQ_QueryParam TALER_PQ_query_param_blinded_planchet ( @@ -95,7 +95,7 @@ TALER_PQ_query_param_blinded_planchet ( * the various attributes of the signature will be serialized into on * variable-size BLOB. * - * @param x pointer to the query parameter to pass + * @param denom_sig pointer to the query parameter to pass */ struct GNUNET_PQ_QueryParam TALER_PQ_query_param_blinded_denom_sig ( @@ -107,7 +107,7 @@ TALER_PQ_query_param_blinded_denom_sig ( * withdraw. Internally, the various attributes of the @a alg_values will be * serialized into on variable-size BLOB. * - * @param x pointer to the query parameter to pass + * @param alg_values pointer to the query parameter to pass */ struct GNUNET_PQ_QueryParam TALER_PQ_query_param_exchange_withdraw_values ( diff --git a/src/include/taler_testing_lib.h b/src/include/taler_testing_lib.h index a0385a85e..271302ae2 100644 --- a/src/include/taler_testing_lib.h +++ b/src/include/taler_testing_lib.h @@ -1709,14 +1709,13 @@ TALER_TESTING_cmd_check_bank_empty (const char *label); * provide a coin to be refunded. * @param refund_transaction_id transaction id to use * in the request. - * * @return the command. */ struct TALER_TESTING_Command TALER_TESTING_cmd_refund_with_id (const char *label, unsigned int expected_response_code, const char *refund_amount, - const char *deposit_reference, + const char *coin_reference, uint64_t refund_transaction_id); @@ -1728,14 +1727,13 @@ TALER_TESTING_cmd_refund_with_id (const char *label, * @param refund_amount the amount to ask a refund for. * @param coin_reference reference to a command that can * provide a coin to be refunded. - * * @return the command. */ struct TALER_TESTING_Command TALER_TESTING_cmd_refund (const char *label, unsigned int expected_response_code, const char *refund_amount, - const char *deposit_reference); + const char *coin_reference); /** @@ -2084,6 +2082,7 @@ TALER_TESTING_cmd_auditor_add_denom_sig (const char *label, const char *denom_ref, bool bad_sig); + /** * Add statement about wire fees of the exchange. This is always * done for a few hours around the current time (for the test). @@ -2209,26 +2208,6 @@ TALER_TESTING_cmd_revoke_sign_key ( /** - * Have the auditor affirm that it is auditing the given - * denomination key and upload the auditor's signature to - * the exchange. - * - * @param label command label. - * @param expected_http_status expected HTTP status from exchange - * @param denom_ref reference to a command that identifies - * a denomination key (i.e. because it was used to - * withdraw a coin). - * @param bad_sig should we use a bogus signature? - * @return the command - */ -struct TALER_TESTING_Command -TALER_TESTING_cmd_auditor_add_denom_sig (const char *label, - unsigned int expected_http_status, - const char *denom_ref, - bool bad_sig); - - -/** * Create a request for a wallet's KYC UUID. * * @param label command label. |