commit b4a0a1d0f5e564901bc492f2a5fda4335fb23035 parent a65bd1488f20f1cf42f955b10e7ce191c1976f1b Author: Florian Dold <dold@taler.net> Date: Mon, 7 Sep 2026 22:04:10 +0200 exchange docs: correct stale references and parameter descriptions Update renamed file and symbol references, document missing parameters, and correct invalid markup. Extend the external tag files for referenced GNUnet and libmicrohttpd symbols so strict Doxygen generation can finish. Diffstat:
15 files changed, 27 insertions(+), 15 deletions(-)
diff --git a/contrib/gnunet.tag b/contrib/gnunet.tag @@ -262,4 +262,8 @@ <arglist>)(void *cls, sqlite3_stmt *result, unsigned int column, size_t *dst_size, void *dst)</arglist> </member> </compound> + <compound kind="struct"> + <name>GNUNET_CRYPTO_EcdsaPrivateKey</name> + <filename>gnunet_crypto_lib.h</filename> + </compound> </tagfile> diff --git a/contrib/microhttpd.tag b/contrib/microhttpd.tag @@ -166,6 +166,12 @@ </member> <member kind="define"> <type>#define</type> + <name>MHD_HTTP_TOO_EARLY</name> + <anchorfile>microhttpd.h</anchorfile> + <arglist></arglist> + </member> + <member kind="define"> + <type>#define</type> <name>MHD_HTTP_INTERNAL_SERVER_ERROR</name> <anchorfile>microhttpd.h</anchorfile> <arglist></arglist> diff --git a/src/auditor/taler-helper-auditor-wire-credit.c b/src/auditor/taler-helper-auditor-wire-credit.c @@ -205,7 +205,7 @@ static TALER_ARL_DEF_AB (total_misattribution_in); /** * Total amount credited to exchange accounts, as claimed by the exchange. - * Includes #total_kycauth_revenue, so that this is the credit side of the + * Includes #TAC_total_kycauth_revenue, so that this is the credit side of the * balance the exchange's bank account is expected to have. */ static TALER_ARL_DEF_AB (total_wire_in); @@ -221,7 +221,7 @@ static TALER_ARL_DEF_AB (total_kycauth_in); * exchange in its `kycauths_in` table. KYCAUTH funds are not credited to * any reserve and are never paid back, so they are revenue of the exchange * operator, like wire fees and closing fees, and may be drained together - * with those. Counted towards #total_wire_in for that reason. + * with those. Counted towards #TAC_total_wire_in for that reason. */ static TALER_ARL_DEF_AB (total_kycauth_revenue); diff --git a/src/exchange/taler-exchange-httpd_get-aml-OFFICER_PUB-transfers.c b/src/exchange/taler-exchange-httpd_get-aml-OFFICER_PUB-transfers.c @@ -55,7 +55,7 @@ enum TransferType /** * Return transfer data. * - * @param cls closure + * @param[in,out] transfers array to append transfer data to * @param row_id current row in AML status table * @param payto_uri account involved with the wire transfer * @param execution_time when was the transfer made diff --git a/src/exchange/taler-exchange-httpd_get-keys.c b/src/exchange/taler-exchange-httpd_get-keys.c @@ -2035,8 +2035,9 @@ build_withdraw_auditors (const struct TEH_KeyStateHandle *ksh) /** * Add the headers we want to set for every /keys response. * - * @param cls the key state to use + * @param ksh the key state to use * @param[in,out] response the response to modify + * @param withdraw_filtered true when building the withdrawal-focused response */ static void setup_response_headers (struct TEH_KeyStateHandle *ksh, diff --git a/src/exchangedb/get_active_legitimization.c b/src/exchangedb/get_active_legitimization.c @@ -14,8 +14,8 @@ TALER; see the file COPYING. If not, see <http://www.gnu.org/licenses/> */ /** - * @file exchangedb/lookup_pending_legitimization.c - * @brief Implementation of the lookup_pending_legitimization function for Postgres + * @file exchangedb/get_active_legitimization.c + * @brief Implementation of the get_active_legitimization function for Postgres * @author Christian Grothoff */ #include "taler/taler_pq_lib.h" diff --git a/src/include/exchange-database/do_aggregate.h b/src/include/exchange-database/do_aggregate.h @@ -14,7 +14,7 @@ TALER; see the file COPYING. If not, see <http://www.gnu.org/licenses/> */ /** - * @file src/include/exchange-database/do_do_aggregate.h + * @file src/include/exchange-database/do_aggregate.h * @brief implementation of the do_aggregate function for Postgres * @author Christian Grothoff */ diff --git a/src/include/exchange-database/do_drain_kyc_alert.h b/src/include/exchange-database/do_drain_kyc_alert.h @@ -14,7 +14,7 @@ TALER; see the file COPYING. If not, see <http://www.gnu.org/licenses/> */ /** - * @file src/include/exchange-database/do_do_drain_kyc_alert.h + * @file src/include/exchange-database/do_drain_kyc_alert.h * @brief implementation of the do_drain_kyc_alert function for Postgres * @author Christian Grothoff */ diff --git a/src/include/exchange-database/do_expire_purse.h b/src/include/exchange-database/do_expire_purse.h @@ -14,7 +14,7 @@ TALER; see the file COPYING. If not, see <http://www.gnu.org/licenses/> */ /** - * @file src/include/exchange-database/do_do_expire_purse.h + * @file src/include/exchange-database/do_expire_purse.h * @brief implementation of the do_expire_purse function for Postgres * @author Christian Grothoff */ diff --git a/src/include/exchange-database/do_trigger_kyc_rule_for_account.h b/src/include/exchange-database/do_trigger_kyc_rule_for_account.h @@ -14,7 +14,7 @@ TALER; see the file COPYING. If not, see <http://www.gnu.org/licenses/> */ /** - * @file src/include/exchange-database/do_do_trigger_kyc_rule_for_account.h + * @file src/include/exchange-database/do_trigger_kyc_rule_for_account.h * @brief implementation of the do_trigger_kyc_rule_for_account function for Postgres * @author Christian Grothoff */ diff --git a/src/include/exchange-database/get_count_known_coins.h b/src/include/exchange-database/get_count_known_coins.h @@ -14,7 +14,7 @@ TALER; see the file COPYING. If not, see <http://www.gnu.org/licenses/> */ /** - * @file src/include/exchange-database/get_get_count_known_coins.h + * @file src/include/exchange-database/get_count_known_coins.h * @brief implementation of the get_count_known_coins function for Postgres * @author Christian Grothoff */ diff --git a/src/include/taler/exchange/post-management-wire.h b/src/include/taler/exchange/post-management-wire.h @@ -117,7 +117,7 @@ struct TALER_EXCHANGE_PostManagementWireOptionValue /** * Value if @e option is - * #TALER_EXCHANGE_POST_MANAGEMENT_WIRE_OPTION_PREPARED_TRANSFER_SERVICE. + * #TALER_EXCHANGE_POST_MANAGEMENT_WIRE_OPTION_PREPARED_TRANSFER_URL. * May be NULL. */ const char *prepared_transfer_url; diff --git a/src/include/taler/taler_bank_service.h b/src/include/taler/taler_bank_service.h @@ -1247,6 +1247,7 @@ typedef void * * @param ctx curl context for the event loop * @param base_url base URL for the registration API + * @param credit_account account to receive the wire transfer * @param credit_amount amount to be credited in the wire transfer * @param type transfer type, either reserve withdrawal or KYC authentication * @param account_pub account public key to associate with the registration diff --git a/src/lib/exchange_api_common.h b/src/lib/exchange_api_common.h @@ -138,7 +138,7 @@ TALER_EXCHANGE_check_coin_amount_conflict_ ( * @param ch_denom_pub hash of the conflicting denomination * @return #GNUNET_OK if @a ch_denom_pub differs from the * denomination hash given by the history of the coin, - * #GNUNET_NO if the proof is for the same @ch_denom_pub + * #GNUNET_NO if the proof is for the same @a ch_denom_pub * and thus invalid * #GNUNET_SYSERR if the proof failed to parse (also invalid) */ diff --git a/src/mhd/mhd_typst.c b/src/mhd/mhd_typst.c @@ -581,8 +581,8 @@ typst_done_cb (void *cls, /** * Check that @a id only consists of characters that are safe to - * interpolate into a Typst `#import` statement (alphanumerics and - * `.`, `-`, `_`). This prevents code/path injection via the form + * interpolate into a Typst import statement (alphanumerics, dots, + * hyphens and underscores). This prevents code/path injection via the form * name or version. * * @param id identifier to validate