summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2020-01-18 13:23:10 +0100
committerChristian Grothoff <christian@grothoff.org>2020-01-18 13:23:17 +0100
commit9317d6d69da2046d1a0cfbe1ea4b377924cc1c90 (patch)
tree5a64d0b187df3077077ca1a1c19b2a9db6483ea1 /src
parentdac255329f4f385d3ccfb544e259d2fae76325df (diff)
downloadexchange-9317d6d69da2046d1a0cfbe1ea4b377924cc1c90.tar.gz
exchange-9317d6d69da2046d1a0cfbe1ea4b377924cc1c90.tar.bz2
exchange-9317d6d69da2046d1a0cfbe1ea4b377924cc1c90.zip
doxygen work
Diffstat (limited to 'src')
-rw-r--r--src/exchangedb/plugin_exchangedb_postgres.c7
-rw-r--r--src/include/taler_bank_service.h6
-rw-r--r--src/include/taler_exchangedb_plugin.h3
-rw-r--r--src/include/taler_json_lib.h2
-rw-r--r--src/include/taler_mhd_lib.h2
-rw-r--r--src/include/taler_testing_lib.h5
-rw-r--r--src/json/json_wire.c2
-rw-r--r--src/lib/exchange_api_deposit.c4
-rw-r--r--src/lib/testing_api_trait_number.c7
-rw-r--r--src/lib/testing_api_trait_process.c3
-rw-r--r--src/lib/testing_api_trait_reserve_priv.c2
-rw-r--r--src/lib/testing_api_trait_reserve_pub.c2
-rw-r--r--src/lib/testing_api_trait_string.c11
-rw-r--r--src/lib/testing_api_trait_time.c2
-rw-r--r--src/lib/testing_api_trait_wtid.c2
-rw-r--r--src/mhd/mhd_config.c2
-rw-r--r--src/util/amount.c8
-rw-r--r--src/util/crypto_wire.c6
18 files changed, 31 insertions, 45 deletions
diff --git a/src/exchangedb/plugin_exchangedb_postgres.c b/src/exchangedb/plugin_exchangedb_postgres.c
index 955ced58..449c2373 100644
--- a/src/exchangedb/plugin_exchangedb_postgres.c
+++ b/src/exchangedb/plugin_exchangedb_postgres.c
@@ -3320,7 +3320,7 @@ get_refunds_cb (void *cls,
* @param session database handle to use
* @param coin_pub coin to get refunds for
* @param merchant_pub merchant to get refunds for
- * @param h_contract_pub contract (hash) to get refunds for
+ * @param h_contract contract (hash) to get refunds for
* @param cb function to call for each refund found
* @param cb_cls closure for @a cb
* @return query result status
@@ -3489,8 +3489,7 @@ postgres_insert_melt (void *cls,
* @param cls the @e cls of this struct with the plugin-specific state
* @param session database connection
* @param rc identify commitment and thus refresh operation
- * @param num_rrcs_newcoins number of coins to generate, size of the
- * @a rrcs array
+ * @param num_rrcs number of coins to generate, size of the @a rrcs array
* @param rrcs information about the new coins
* @param num_tprivs number of entries in @a tprivs, should be #TALER_CNC_KAPPA - 1
* @param tprivs transfer private keys to store
@@ -6947,7 +6946,7 @@ postgres_get_reserve_by_h_blind (void *cls,
* @param cls closure
* @param session a session
* @param h_blind_ev hash of the blinded coin
- * @param[out] reserve_pub set to information about the reserve (on success only)
+ * @param[out] old_coin_pub set to information about the old coin (on success only)
* @return transaction status code
*/
static enum GNUNET_DB_QueryStatus
diff --git a/src/include/taler_bank_service.h b/src/include/taler_bank_service.h
index 6829cf71..510712b9 100644
--- a/src/include/taler_bank_service.h
+++ b/src/include/taler_bank_service.h
@@ -170,8 +170,8 @@ TALER_BANK_admin_add_incoming_cancel (struct
* @param exchange_base_url base URL of this exchange (included in subject
* to facilitate use of tracking API by merchant backend)
* @param wtid wire transfer identifier to use
- * @param buf[out] set to transaction data to persist, NULL on error
- * @param buf_size[out] set to number of bytes in @a buf, 0 on error
+ * @param[out] buf set to transaction data to persist, NULL on error
+ * @param[out] buf_size set to number of bytes in @a buf, 0 on error
*/
void
TALER_BANK_prepare_wire_transfer (const char *destination_account_payto_uri,
@@ -469,7 +469,7 @@ TALER_BANK_debit_history_cancel (struct TALER_BANK_DebitHistoryHandle *hh);
*
* @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
diff --git a/src/include/taler_exchangedb_plugin.h b/src/include/taler_exchangedb_plugin.h
index 80deec3a..451650d0 100644
--- a/src/include/taler_exchangedb_plugin.h
+++ b/src/include/taler_exchangedb_plugin.h
@@ -2126,8 +2126,7 @@ struct TALER_EXCHANGEDB_Plugin
* @param cls the @e cls of this struct with the plugin-specific state
* @param session database connection
* @param rc identify commitment and thus refresh operation
- * @param num_rrcs_newcoins number of coins to generate, size of the
- * @a rrcs array
+ * @param num_rrcs number of coins to generate, size of the @a rrcs array
* @param rrcs information about the new coins
* @param num_tprivs number of entries in @a tprivs, should be #TALER_CNC_KAPPA - 1
* @param tprivs transfer private keys to store
diff --git a/src/include/taler_json_lib.h b/src/include/taler_json_lib.h
index 16863803..9c6f3165 100644
--- a/src/include/taler_json_lib.h
+++ b/src/include/taler_json_lib.h
@@ -146,7 +146,7 @@ TALER_JSON_get_error_code2 (const void *data,
* hash is what is put into the contract.
*
* @param wire_s wire details to hash
- * @param hc[out] set to the hash
+ * @param[out] hc set to the hash
* @return #GNUNET_OK on success, #GNUNET_SYSERR if @a wire_s is malformed
*/
int
diff --git a/src/include/taler_mhd_lib.h b/src/include/taler_mhd_lib.h
index d9d1611a..6840509b 100644
--- a/src/include/taler_mhd_lib.h
+++ b/src/include/taler_mhd_lib.h
@@ -381,7 +381,7 @@ TALER_MHD_open_unix_path (const char *unix_path,
*
* @param cfg configuration to parse
* @param section configuration section to use
- * @param port[out] port to set, if TCP without BINDTO
+ * @param[out] port port to set, if TCP without BINDTO
* @return -1 and a port of zero on error, otherwise
* either -1 and a port, or a bound stream socket
*/
diff --git a/src/include/taler_testing_lib.h b/src/include/taler_testing_lib.h
index f279d6d0..b20f7c11 100644
--- a/src/include/taler_testing_lib.h
+++ b/src/include/taler_testing_lib.h
@@ -1897,7 +1897,6 @@ TALER_TESTING_get_trait_process (const struct TALER_TESTING_Command *cmd,
* @param index offered location index number, in case there are
* multiple on offer.
* @param processp process location to offer.
- *
* @return the trait.
*/
struct TALER_TESTING_Trait
@@ -1910,7 +1909,6 @@ TALER_TESTING_make_trait_process (unsigned int index,
*
* @param index index number to associate with offered coin priv.
* @param coin_priv coin private key to offer.
- *
* @return the trait.
*/
struct TALER_TESTING_Trait
@@ -1938,7 +1936,6 @@ TALER_TESTING_get_trait_coin_priv (const struct TALER_TESTING_Command *cmd,
*
* @param index index number to associate to the offered key.
* @param blinding_key blinding key to offer.
- *
* @return the trait.
*/
struct TALER_TESTING_Trait
@@ -1969,7 +1966,6 @@ TALER_TESTING_get_trait_blinding_key (const struct TALER_TESTING_Command *cmd,
*
* @param index index number to associate to the offered denom pub.
* @param denom_pub denom pub to offer with this trait.
- *
* @return the trait.
*/
struct TALER_TESTING_Trait
@@ -2014,7 +2010,6 @@ TALER_TESTING_get_trait_denom_sig (const struct TALER_TESTING_Command *cmd,
* @param index index number to associate to the signature on
* offer.
* @param denom_sig the denom sig on offer.
- *
* @return the trait.
*/
struct TALER_TESTING_Trait
diff --git a/src/json/json_wire.c b/src/json/json_wire.c
index 4c5b7d64..229878ae 100644
--- a/src/json/json_wire.c
+++ b/src/json/json_wire.c
@@ -361,7 +361,7 @@ validate_payto_iban (const char *account_url)
* hash is what is put into the contract.
*
* @param wire_s wire details to hash
- * @param hc[out] set to the hash
+ * @param[out] hc set to the hash
* @return #GNUNET_OK on success, #GNUNET_SYSERR if @a wire_s is malformed
*/
int
diff --git a/src/lib/exchange_api_deposit.c b/src/lib/exchange_api_deposit.c
index 9a86bdf3..1337e2da 100644
--- a/src/lib/exchange_api_deposit.c
+++ b/src/lib/exchange_api_deposit.c
@@ -181,8 +181,8 @@ auditor_cb (void *cls,
*
* @param dh deposit handle
* @param json json reply with the signature
- * @param exchange_sig[out] set to the exchange's signature
- * @param exchange_pub[out] set to the exchange's public key
+ * @param[out] exchange_sig set to the exchange's signature
+ * @param[out] exchange_pub set to the exchange's public key
* @return #GNUNET_OK if the signature is valid, #GNUNET_SYSERR if not
*/
static int
diff --git a/src/lib/testing_api_trait_number.c b/src/lib/testing_api_trait_number.c
index 3765f0cf..c644b8e3 100644
--- a/src/lib/testing_api_trait_number.c
+++ b/src/lib/testing_api_trait_number.c
@@ -38,7 +38,7 @@
*
* @param cmd command to extract the number from.
* @param index the number's index number.
- * @param n[out] set to the number coming from @a cmd.
+ * @param[out] n set to the number coming from @a cmd.
* @return #GNUNET_OK on success.
*/
int
@@ -78,8 +78,7 @@ TALER_TESTING_make_trait_uint (unsigned int index,
*
* @param cmd command to extract the number from.
* @param index the number's index number.
- * @param n[out] set to the number coming from @a cmd.
- *
+ * @param[out] n set to the number coming from @a cmd.
* @return #GNUNET_OK on success.
*/
int
@@ -117,7 +116,7 @@ TALER_TESTING_make_trait_uint64 (unsigned int index,
* Obtain a bank transaction row value from @a cmd.
*
* @param cmd command to extract the number from.
- * @param row[out] set to the number coming from @a cmd.
+ * @param[out] row set to the number coming from @a cmd.
* @return #GNUNET_OK on success.
*/
int
diff --git a/src/lib/testing_api_trait_process.c b/src/lib/testing_api_trait_process.c
index 64888f35..26b2f0e0 100644
--- a/src/lib/testing_api_trait_process.c
+++ b/src/lib/testing_api_trait_process.c
@@ -39,9 +39,8 @@
* @param cmd command to extract trait from.
* @param index which process to pick if @a cmd
* has multiple on offer.
- * @param coin_priv[out] set to the address of the pointer to the
+ * @param[out] processp set to the address of the pointer to the
* process.
- *
* @return #GNUNET_OK on success.
*/
int
diff --git a/src/lib/testing_api_trait_reserve_priv.c b/src/lib/testing_api_trait_reserve_priv.c
index 1bc8d194..3d79b356 100644
--- a/src/lib/testing_api_trait_reserve_priv.c
+++ b/src/lib/testing_api_trait_reserve_priv.c
@@ -37,7 +37,7 @@
*
* @param cmd command to extract the reserve priv from.
* @param index reserve priv's index number.
- * @param reserve_priv[out] set to the reserve priv.
+ * @param[out] reserve_priv set to the reserve priv.
* @return #GNUNET_OK on success.
*/
int
diff --git a/src/lib/testing_api_trait_reserve_pub.c b/src/lib/testing_api_trait_reserve_pub.c
index 331384b2..997ceee7 100644
--- a/src/lib/testing_api_trait_reserve_pub.c
+++ b/src/lib/testing_api_trait_reserve_pub.c
@@ -37,7 +37,7 @@
*
* @param cmd command to extract the reserve pub from.
* @param index reserve pub's index number.
- * @param reserve_pub[out] set to the reserve pub.
+ * @param[out] reserve_pub set to the reserve pub.
* @return #GNUNET_OK on success.
*/
int
diff --git a/src/lib/testing_api_trait_string.c b/src/lib/testing_api_trait_string.c
index 90079796..80c9b420 100644
--- a/src/lib/testing_api_trait_string.c
+++ b/src/lib/testing_api_trait_string.c
@@ -56,7 +56,7 @@
* @param cmd command to extract the subject from.
* @param index index number associated with the transfer
* subject to offer.
- * @param s[out] where to write the offered
+ * @param[out] s where to write the offered
* string
* @return #GNUNET_OK on success.
*/
@@ -99,8 +99,7 @@ TALER_TESTING_make_trait_string (unsigned int index,
* @param cmd command to extract the url from.
* @param index which url is to be picked, in case
* multiple are offered.
- * @param url[out] where to write the url.
- *
+ * @param[out] url where to write the url.
* @return #GNUNET_OK on success.
*/
int
@@ -148,8 +147,7 @@ TALER_TESTING_make_trait_url (unsigned int index,
* @param cmd command to extract the order id from.
* @param index which order id is to be picked, in case
* multiple are offered.
- * @param order_id[out] where to write the order id.
- *
+ * @param[out] order_id where to write the order id.
* @return #GNUNET_OK on success.
*/
int
@@ -170,7 +168,6 @@ TALER_TESTING_get_trait_order_id (const struct TALER_TESTING_Command *cmd,
* @param index which order id is to be offered,
* in case multiple are offered.
* @param order_id the order id to offer.
- *
* @return the trait.
*/
struct TALER_TESTING_Trait
@@ -192,7 +189,7 @@ TALER_TESTING_make_trait_order_id (unsigned int index,
* @param cmd command to extract the url from.
* @param pt which url is to be picked, in case
* multiple are offered.
- * @param url[out] where to write the url.
+ * @param[out] url where to write the url.
* @return #GNUNET_OK on success.
*/
int
diff --git a/src/lib/testing_api_trait_time.c b/src/lib/testing_api_trait_time.c
index 415eafdf..6e6128a6 100644
--- a/src/lib/testing_api_trait_time.c
+++ b/src/lib/testing_api_trait_time.c
@@ -37,7 +37,7 @@
* @param cmd command to extract trait from
* @param index which time stamp to pick if
* @a cmd has multiple on offer.
- * @param time[out] set to the wanted WTID.
+ * @param[out] time set to the wanted WTID.
* @return #GNUNET_OK on success
*/
int
diff --git a/src/lib/testing_api_trait_wtid.c b/src/lib/testing_api_trait_wtid.c
index 54a66b54..65390b8c 100644
--- a/src/lib/testing_api_trait_wtid.c
+++ b/src/lib/testing_api_trait_wtid.c
@@ -37,7 +37,7 @@
* @param cmd command to extract trait from
* @param index which WTID to pick if @a cmd has multiple on
* offer
- * @param wtid[out] set to the wanted WTID.
+ * @param[out] wtid set to the wanted WTID.
* @return #GNUNET_OK on success
*/
int
diff --git a/src/mhd/mhd_config.c b/src/mhd/mhd_config.c
index d4b0e979..e4dbc44c 100644
--- a/src/mhd/mhd_config.c
+++ b/src/mhd/mhd_config.c
@@ -296,7 +296,7 @@ TALER_MHD_open_unix_path (const char *unix_path,
*
* @param cfg configuration to parse
* @param section configuration section to use
- * @param port[out] port to set, if TCP without BINDTO
+ * @param[out] port port to set, if TCP without BINDTO
* @return -1 and a port of zero on error, otherwise
* either -1 and a port, or a bound stream socket
*/
diff --git a/src/util/amount.c b/src/util/amount.c
index 1f00b1d6..c432caee 100644
--- a/src/util/amount.c
+++ b/src/util/amount.c
@@ -539,20 +539,18 @@ TALER_amount_normalize (struct TALER_Amount *amount)
/**
- * Convert the fraction of @a amount to a string
- * in decimals.
+ * Convert the fraction of @a amount to a string in decimals.
*
* @param amount value to convert
- * @param tail[out] where to write the reesult
+ * @param[out] tail where to write the reesult
*/
static void
amount_to_tail (const struct TALER_Amount *amount,
char tail[TALER_AMOUNT_FRAC_LEN + 1])
{
uint32_t n = amount->fraction;
- unsigned int i;
- for (i = 0; (i < TALER_AMOUNT_FRAC_LEN) && (0 != n); i++)
+ for (unsigned int i = 0; (i < TALER_AMOUNT_FRAC_LEN) && (0 != n); i++)
{
tail[i] = '0' + (n / (TALER_AMOUNT_FRAC_BASE / 10));
n = (n * 10) % (TALER_AMOUNT_FRAC_BASE);
diff --git a/src/util/crypto_wire.c b/src/util/crypto_wire.c
index de7e5b99..e3a5b9fb 100644
--- a/src/util/crypto_wire.c
+++ b/src/util/crypto_wire.c
@@ -78,7 +78,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,
@@ -105,7 +105,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,
@@ -162,7 +162,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 merchant_priv private key to sign with
- * @param merchant_sig[out] where to write the signature
+ * @param[out] merchant_sig where to write the signature
*/
void
TALER_merchant_wire_signature_make (const char *payto_url,