From 7dbf41fda881ee2ecd817e62e8390d49eaefe15f Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Sun, 25 Aug 2024 10:57:24 +0200 Subject: doxygen fixes --- .../taler-auditor-httpd_historic-denomination-revenue-get.c | 5 ++++- src/auditor/taler-auditor-httpd_spa.h | 1 + src/auditor/taler-helper-auditor-transfer.c | 1 - src/auditor/taler-helper-auditor-wire-debit.c | 3 +-- src/auditordb/pg_get_balances.h | 7 +++---- src/auditordb/pg_select_historic_denom_revenue.h | 2 ++ src/auditordb/pg_select_historic_reserve_revenue.h | 2 ++ src/include/taler_exchangedb_plugin.h | 1 - 8 files changed, 13 insertions(+), 9 deletions(-) diff --git a/src/auditor/taler-auditor-httpd_historic-denomination-revenue-get.c b/src/auditor/taler-auditor-httpd_historic-denomination-revenue-get.c index 544b97398..8af956dba 100644 --- a/src/auditor/taler-auditor-httpd_historic-denomination-revenue-get.c +++ b/src/auditor/taler-auditor-httpd_historic-denomination-revenue-get.c @@ -32,7 +32,10 @@ * * @param[in,out] cls a `json_t *` array to extend * @param serial_id location of the @a dc in the database - * @param dc struct of inconsistencies + * @param denom_pub_hash public key hash of the denomination + * @param revenue_timestamp when was the revenue effective + * @param revenue_balance how much in profit did we make from this denomination + * @param loss_balance how much loss did we make from this denomination * @return #GNUNET_OK to continue to iterate, #GNUNET_SYSERR to stop iterating */ static enum GNUNET_GenericReturnValue diff --git a/src/auditor/taler-auditor-httpd_spa.h b/src/auditor/taler-auditor-httpd_spa.h index 5734c29fa..f8a6c98f2 100644 --- a/src/auditor/taler-auditor-httpd_spa.h +++ b/src/auditor/taler-auditor-httpd_spa.h @@ -34,6 +34,7 @@ * @param[in,out] connection_cls the connection's closure (can be updated) * @param upload_data upload data * @param[in,out] upload_data_size number of bytes (left) in @a upload_data + * @param args request URL broken up into tokens at '/' characters * @return MHD result code */ MHD_RESULT diff --git a/src/auditor/taler-helper-auditor-transfer.c b/src/auditor/taler-helper-auditor-transfer.c index fb2a6e344..95b185215 100644 --- a/src/auditor/taler-helper-auditor-transfer.c +++ b/src/auditor/taler-helper-auditor-transfer.c @@ -103,7 +103,6 @@ begin_transaction (void); * Commit the transaction, checkpointing our progress in the auditor DB. * * @param qs transaction status so far - * @return transaction status code */ static void commit_transaction (enum GNUNET_DB_QueryStatus qs) diff --git a/src/auditor/taler-helper-auditor-wire-debit.c b/src/auditor/taler-helper-auditor-wire-debit.c index eee944832..e9e31fdc7 100644 --- a/src/auditor/taler-helper-auditor-wire-debit.c +++ b/src/auditor/taler-helper-auditor-wire-debit.c @@ -520,7 +520,6 @@ begin_transaction (void); * Commit the transaction, checkpointing our progress in the auditor DB. * * @param qs transaction status so far - * @return transaction status code */ static void commit (enum GNUNET_DB_QueryStatus qs) @@ -762,7 +761,7 @@ check_rc_matches (void *cls, /** * Make diagnostic string for missing wire transfer. * - * @param[out] where to write the diagnostic + * @param[out] diag where to write the diagnostic string * @param wtid wire transfer ID to include */ static void diff --git a/src/auditordb/pg_get_balances.h b/src/auditordb/pg_get_balances.h index e4dc8911d..ff17847c1 100644 --- a/src/auditordb/pg_get_balances.h +++ b/src/auditordb/pg_get_balances.h @@ -24,10 +24,9 @@ * Get information about balances from the database. * * @param cls the @e cls of this struct with the plugin-specific state - * @param limit number of balances to return at most, - * negative value to descend from @a offset - * @param offset row/serial ID where to start the iteration (0 from - * the start, exclusive, i.e. serial_ids must start from 1) + * @param limit return at most this number of results, negative to descend from @a offset + * @param offset row from which to return @a limit results + * @param balance_key key to filter by, NULL to match all balance keys * @param cb function to call with results * @param cb_cls closure for @a cb * @return query result status diff --git a/src/auditordb/pg_select_historic_denom_revenue.h b/src/auditordb/pg_select_historic_denom_revenue.h index 621c7d38d..a3574ec61 100644 --- a/src/auditordb/pg_select_historic_denom_revenue.h +++ b/src/auditordb/pg_select_historic_denom_revenue.h @@ -30,6 +30,8 @@ * Obtain all of the historic denomination key revenue * * @param cls the @e cls of this struct with the plugin-specific state + * @param limit return at most this number of results, negative to descend from @a offset + * @param offset row from which to return @a limit results * @param cb function to call with the results * @param cb_cls closure for @a cb * @return transaction status code diff --git a/src/auditordb/pg_select_historic_reserve_revenue.h b/src/auditordb/pg_select_historic_reserve_revenue.h index e9190e35b..dfdd76e73 100644 --- a/src/auditordb/pg_select_historic_reserve_revenue.h +++ b/src/auditordb/pg_select_historic_reserve_revenue.h @@ -29,6 +29,8 @@ * Return information about an exchange's historic revenue from reserves. * * @param cls the @e cls of this struct with the plugin-specific state + * @param limit return at most this number of results, negative to descend from @a offset + * @param offset row from which to return @a limit results * @param cb function to call with results * @param cb_cls closure for @a cb * @return transaction status code diff --git a/src/include/taler_exchangedb_plugin.h b/src/include/taler_exchangedb_plugin.h index e08371da4..c8444e296 100644 --- a/src/include/taler_exchangedb_plugin.h +++ b/src/include/taler_exchangedb_plugin.h @@ -3614,7 +3614,6 @@ typedef void * * @param cls closure * @param row_id current row in kyc_attributes table - * @param provider_name which provider collected the data, NULL for user upload * @param collection_time when were the attributes collected * @param enc_attributes_size size of @a enc_attributes * @param enc_attributes the encrypted collected attributes -- cgit v1.2.3