doxygen

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,