doxygen fixes

4 files changed, 17 insertions, 12 deletions

diff --git a/src/include/taler_crypto_lib.h b/src/include/taler_crypto_lib.h
index 8be0bad4a..ae7385058 100644
--- a/src/include/taler_crypto_lib.h
+++ b/src/include/taler_crypto_lib.h
@@ -880,7 +880,7 @@ TALER_CRYPTO_helper_denom_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 @param h_denom_pub .
  * Will cause the helper to tell all clients that the key is now unavailable,
  * and to create a replacement key.
  *
@@ -1004,8 +1004,8 @@ TALER_CRYPTO_helper_esign_sign_ (
  *
  * @param esh helper process connection
  * @param ps message to sign (MUST begin with a purpose)
- * @param[out] exchange_pub set to the public key used for the signature upon success
- * @param[out] exchange_sig set to the signature upon success
+ * @param[out] epub set to the public key used for the signature upon success
+ * @param[out] esig set to the signature upon success
  * @return the error code (or #TALER_EC_NONE on success)
  */
 #define TALER_CRYPTO_helper_esign_sign(esh,ps,epub,esig) (         \
@@ -1021,7 +1021,7 @@ TALER_CRYPTO_helper_esign_sign_ (
 
 
 /**
- * Ask the helper to revoke the public key @param exchange_pub.
+ * Ask the helper to revoke the public key @param exchange_pub .
  * Will cause the helper to tell all clients that the key is now unavailable,
  * and to create a replacement key.
  *
diff --git a/src/include/taler_exchange_service.h b/src/include/taler_exchange_service.h
index a8b78a2b3..512dfb35c 100644
--- a/src/include/taler_exchange_service.h
+++ b/src/include/taler_exchange_service.h
@@ -2201,6 +2201,7 @@ struct TALER_EXCHANGE_ManagementPostKeysHandle;
  *
  * @param ctx the context
  * @param url HTTP base URL for the exchange
+ * @param pkd signature data to POST
  * @param cb function to call with the exchange's result
  * @param cb_cls closure for @a cb
  * @return the request handle; NULL upon error
@@ -2217,7 +2218,7 @@ TALER_EXCHANGE_post_management_keys (
 /**
  * Cancel #TALER_EXCHANGE_post_management_keys() operation.
  *
- * @param gh handle of the operation to cancel
+ * @param ph handle of the operation to cancel
  */
 void
 TALER_EXCHANGE_post_management_keys_cancel (
@@ -2450,7 +2451,6 @@ struct TALER_EXCHANGE_ManagementWireEnableHandle;
  *
  * @param ctx the context
  * @param url HTTP base URL for the exchange
- * @param salt salt to use when hashing the account for the signature
  * @param payto_uri RFC 8905 URI of the exchange's bank account
  * @param validity_start when was this decided?
  * @param master_sig1 signature affirming the wire addition
@@ -2586,7 +2586,7 @@ TALER_EXCHANGE_management_set_wire_fees (
 /**
  * Cancel #TALER_EXCHANGE_management_enable_wire() operation.
  *
- * @param wh handle of the operation to cancel
+ * @param swfh handle of the operation to cancel
  */
 void
 TALER_EXCHANGE_management_set_wire_fees_cancel (
@@ -2639,7 +2639,7 @@ TALER_EXCHANGE_add_auditor_denomination (
 /**
  * Cancel #TALER_EXCHANGE_add_auditor_denomination() operation.
  *
- * @param gh handle of the operation to cancel
+ * @param ah handle of the operation to cancel
  */
 void
 TALER_EXCHANGE_add_auditor_denomination_cancel (
diff --git a/src/include/taler_exchangedb_plugin.h b/src/include/taler_exchangedb_plugin.h
index ae240b8d6..125cfe348 100644
--- a/src/include/taler_exchangedb_plugin.h
+++ b/src/include/taler_exchangedb_plugin.h
@@ -2977,7 +2977,7 @@ struct TALER_EXCHANGEDB_Plugin
    * @param cls closure
    * @param session a session
    * @param auditor_pub key to look up information for
-   * @param[out] set to the base URL of the auditor's REST API; memory to be
+   * @param[out] auditor_url set to the base URL of the auditor's REST API; memory to be
    *            released by the caller!
    * @param[out] enabled set if the auditor is currently in use
    * @return transaction status code
diff --git a/src/include/taler_testing_lib.h b/src/include/taler_testing_lib.h
index f27938262..3f028cadf 100644
--- a/src/include/taler_testing_lib.h
+++ b/src/include/taler_testing_lib.h
@@ -2143,7 +2143,7 @@ TALER_TESTING_cmd_offline_sign_keys (const char *label,
  * Revoke an exchange denomination key.
  *
  * @param label command label.
- * @param expected_http_status expected HTTP status from exchange
+ * @param expected_response_code expected HTTP status from exchange
  * @param bad_sig should we use a bogus signature?
  * @param denom_ref reference to a command that identifies
  *        a denomination key (i.e. because it was used to
@@ -2162,7 +2162,7 @@ TALER_TESTING_cmd_revoke_denom_key (
  * Revoke an exchange online signing key.
  *
  * @param label command label.
- * @param expected_http_status expected HTTP status from exchange
+ * @param expected_response_code expected HTTP status from exchange
  * @param bad_sig should we use a bogus signature?
  * @param signkey_ref reference to a command that identifies
  *        a signing key (i.e. because it was used to
@@ -2183,13 +2183,18 @@ TALER_TESTING_cmd_revoke_sign_key (
  * 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_key (const char *denom_ref);
+TALER_TESTING_cmd_auditor_add_denom_sig (const char *label,
+                                         unsigned int expected_http_status,
+                                         const char *denom_ref,
+                                         bool bad_sig);
 
 
 /* *** Generic trait logic for implementing traits ********* */