commit 325ce2e1884e1e585d2ba3186317da952c53a4e5
parent a0300689d760ea068f954fcef19590f6ff97455b
Author: Christian Grothoff <christian@grothoff.org>
Date: Mon, 29 Jul 2024 18:39:42 +0200
doxygen fixes
Diffstat:
13 files changed, 37 insertions(+), 38 deletions(-)
diff --git a/contrib/gnunet.tag b/contrib/gnunet.tag
@@ -52,6 +52,12 @@
<anchorfile>gnunet_time_lib.h</anchorfile>
<arglist></arglist>
</member>
+ <member kind="define">
+ <type>#define</type>
+ <name>GNUNET_TIME_UNIT_ZERO_TS</name>
+ <anchorfile>gnunet_time_lib.h</anchorfile>
+ <arglist></arglist>
+ </member>
</compound>
<compound kind="file">
diff --git a/contrib/microhttpd.tag b/contrib/microhttpd.tag
@@ -18,6 +18,12 @@
</member>
<member kind="define">
<type>#define</type>
+ <name>MHD_POSTDATA_KIND</name>
+ <anchorfile>microhttpd.h</anchorfile>
+ <arglist></arglist>
+ </member>
+ <member kind="define">
+ <type>#define</type>
<name>MHD_HTTP_OK</name>
<anchorfile>microhttpd.h</anchorfile>
<arglist></arglist>
diff --git a/src/exchange/taler-exchange-httpd_aml-attributes-get.c b/src/exchange/taler-exchange-httpd_aml-attributes-get.c
@@ -43,7 +43,8 @@
* @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 attributes the collected attributes
+ * @param enc_attributes_size length of @a enc_attributes
+ * @param enc_attributes the encrypted collected attributes
*/
static void
detail_cb (
diff --git a/src/exchange/taler-exchange-httpd_kyc-upload.h b/src/exchange/taler-exchange-httpd_kyc-upload.h
@@ -44,7 +44,6 @@ TEH_kyc_upload_cleanup (void);
* @param[in,out] upload_data_size length of @a upload_data,
* to be update to reflect number of bytes remaining
* @param upload_data upload data of the POST, if any
- * @param args array of additional options (must be empty for this function)
* @return MHD result code
*/
MHD_RESULT
diff --git a/src/exchangedb/pg_insert_aml_decision.h b/src/exchangedb/pg_insert_aml_decision.h
@@ -32,12 +32,12 @@
*
* @param cls closure
* @param h_payto account for which the attribute data is stored
- * @param new_threshold new monthly threshold that would trigger an AML check
- * @param new_status AML decision status
* @param decision_time when was the decision made
+ * @param expiration_time when does the decision expire
+ * @param properties JSON object with properties to set for the account
+ * @param new_rules JSON array with new AML/KYC rules
+ * @param to_investigate true if AML staff should look more into this account
* @param justification human-readable text justifying the decision
- * @param kyc_requirements JSON array with KYC requirements
- * @param requirements_row row in the KYC table for this process, 0 for none
* @param decider_pub public key of the staff member
* @param decider_sig signature of the staff member
* @param[out] invalid_officer set to TRUE if @a decider_pub is not allowed to make decisions right now
diff --git a/src/include/taler_crypto_lib.h b/src/include/taler_crypto_lib.h
@@ -2611,7 +2611,7 @@ TALER_token_issue_sig_unblind (
* anything.
*
* @param account_priv private key of account owner
- * @param[out] officer_sig where to write the signature
+ * @param[out] account_sig where to write the signature
*/
void
TALER_account_kyc_auth_sign (
diff --git a/src/include/taler_mhd_lib.h b/src/include/taler_mhd_lib.h
@@ -527,7 +527,7 @@ TALER_MHD_parse_request_arg_timestamp (struct MHD_Connection *connection,
* @param connection the MHD connection
* @param name name of the query parameter to parse
* @param def default value to set if absent
- * @param[out] res set to the yes/no/all value
+ * @param[out] ret set to the yes/no/all value
*/
#define TALER_MHD_parse_request_yna(connection,name,def,ret) \
do { \
diff --git a/src/include/taler_testing_lib.h b/src/include/taler_testing_lib.h
@@ -2224,7 +2224,6 @@ TALER_TESTING_cmd_check_kyc_get (
* Create a request for detailed account KYC information.
*
* @param label command label.
- * @param payment_target_reference command with a payment target to query
* @param kyc_check_reference command with account access token trait to use
* @param expected_response_code expected HTTP status
* @return the command
diff --git a/src/kyclogic/kyclogic_api.c b/src/kyclogic/kyclogic_api.c
@@ -1338,7 +1338,7 @@ add_provider (const struct GNUNET_CONFIGURATION_Handle *cfg,
* @param[in,out] input the input to tokenize; clobbered
* @param sep separator between tokens to separate @a input on
* @param[out] p_strs where to put array of tokens
- * @param[out] num_p_strs set to length of @a p_strs array
+ * @param[out] num_strs set to length of @a p_strs array
*/
static void
add_tokens (char *input,
diff --git a/src/lib/exchange_api_get_aml_measures.c b/src/lib/exchange_api_get_aml_measures.c
@@ -213,8 +213,8 @@ j_to_a (const json_t *j,
* Parse AML programs.
*
* @param[in,out] lh context for allocations
- * @param jroots JSON object with program data
- * @param[out] roots where to write the result
+ * @param jprogs JSON object with program data
+ * @param[out] progs where to write the result
* @return #GNUNET_OK on success
*/
static enum GNUNET_GenericReturnValue
diff --git a/src/lib/exchange_api_lookup_aml_decisions.c b/src/lib/exchange_api_lookup_aml_decisions.c
@@ -83,7 +83,7 @@ struct TALER_EXCHANGE_LookupAmlDecisions
*
* @param[in,out] lh handle to use for allocations
* @param jlimits JSON array with AML rules
- * @param[out] decision_ar where to write the result
+ * @param[out] ds where to write the result
* @return #GNUNET_OK on success
*/
static enum GNUNET_GenericReturnValue
diff --git a/src/lib/exchange_api_lookup_kyc_attributes.c b/src/lib/exchange_api_lookup_kyc_attributes.c
@@ -68,8 +68,8 @@ struct TALER_EXCHANGE_LookupKycAttributes
* Parse AML decision summary array.
*
* @param[in,out] lh handle to use for allocations
- * @param attributes JSON array with AML decision summaries
- * @param[out] decision_ar where to write the result
+ * @param jdetails JSON array with AML decision summaries
+ * @param[out] detail_ar where to write the result
* @return #GNUNET_OK on success
*/
static enum GNUNET_GenericReturnValue
diff --git a/src/testing/testing_api_cmd_bank_admin_add_incoming.c b/src/testing/testing_api_cmd_bank_admin_add_incoming.c
@@ -150,9 +150,10 @@ struct AdminAddIncomingState
* @param is interpreter state.
*/
static void
-admin_add_incoming_run (void *cls,
- const struct TALER_TESTING_Command *cmd,
- struct TALER_TESTING_Interpreter *is);
+admin_add_incoming_run (
+ void *cls,
+ const struct TALER_TESTING_Command *cmd,
+ struct TALER_TESTING_Interpreter *is);
/**
@@ -284,17 +285,11 @@ confirmation_cb (void *cls,
}
-/**
- * Run the "bank transfer" CMD.
- *
- * @param cls closure.
- * @param cmd CMD being run.
- * @param is interpreter state.
- */
static void
-admin_add_incoming_run (void *cls,
- const struct TALER_TESTING_Command *cmd,
- struct TALER_TESTING_Interpreter *is)
+admin_add_incoming_run (
+ void *cls,
+ const struct TALER_TESTING_Command *cmd,
+ struct TALER_TESTING_Interpreter *is)
{
struct AdminAddIncomingState *fts = cls;
bool have_public = false;
@@ -383,8 +378,9 @@ admin_add_incoming_run (void *cls,
* @param cmd current CMD being cleaned up.
*/
static void
-admin_add_incoming_cleanup (void *cls,
- const struct TALER_TESTING_Command *cmd)
+admin_add_incoming_cleanup (
+ void *cls,
+ const struct TALER_TESTING_Command *cmd)
{
struct AdminAddIncomingState *fts = cls;
@@ -578,14 +574,6 @@ TALER_TESTING_cmd_admin_add_incoming_with_ref (
}
-/**
- * Modify a bank transfer command to enable retries when the
- * reserve is not yet full or we get other transient errors from the
- * bank.
- *
- * @param cmd a bank transfer command
- * @return the command with retries enabled
- */
struct TALER_TESTING_Command
TALER_TESTING_cmd_admin_add_incoming_retry (struct TALER_TESTING_Command cmd)
{
