From 5f3116d324f4b475365b9a8729a69851419229c3 Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Tue, 17 Jan 2023 16:28:47 +0100 Subject: -misc doxygen fixes --- .../taler-merchant-httpd_private-get-pending-webhooks.c | 7 ++++--- src/backend/taler-merchant-httpd_private-get-webhooks.c | 1 + src/include/taler_merchant_service.h | 2 +- src/include/taler_merchantdb_plugin.h | 11 ++++++----- src/lib/merchant_api_common.h | 2 +- src/lib/merchant_api_get_templates.c | 10 +++++----- src/testing/testing_api_cmd_post_using_templates.c | 2 +- 7 files changed, 19 insertions(+), 16 deletions(-) (limited to 'src') diff --git a/src/backend/taler-merchant-httpd_private-get-pending-webhooks.c b/src/backend/taler-merchant-httpd_private-get-pending-webhooks.c index 690b0c14..d5160476 100644 --- a/src/backend/taler-merchant-httpd_private-get-pending-webhooks.c +++ b/src/backend/taler-merchant-httpd_private-get-pending-webhooks.c @@ -26,8 +26,9 @@ * * @param cls a `json_t *` JSON array to build * @param webhook_serial reference of the webhook + * @param next_attempt when will this hook be attempted next */ -static voidX +static void add_pending_webhook (void *cls, uint64_t *webhook_serial, struct GNUNET_TIME_Absolute *next_attempt) @@ -42,7 +43,7 @@ add_pending_webhook (void *cls, webhook_serial), GNUNET_JSON_pack_string ("next_attempt", next_attempt) - ))); + ))); } @@ -75,4 +76,4 @@ TMH_private_get_pending_webhooks (const struct TMH_RequestHandler *rh, } -/* end of taler-merchant-httpd_private-get-webhooks.c */ +/* end of taler-merchant-httpd_private-get-pending-webhooks.c */ diff --git a/src/backend/taler-merchant-httpd_private-get-webhooks.c b/src/backend/taler-merchant-httpd_private-get-webhooks.c index 2436c197..251cd95e 100644 --- a/src/backend/taler-merchant-httpd_private-get-webhooks.c +++ b/src/backend/taler-merchant-httpd_private-get-webhooks.c @@ -27,6 +27,7 @@ * * @param cls a `json_t *` JSON array to build * @param webhook_id ID of the webhook + * @param event_type what type of event is the hook for */ static void add_webhook (void *cls, diff --git a/src/include/taler_merchant_service.h b/src/include/taler_merchant_service.h index 9b38c2bf..e413a7c6 100644 --- a/src/include/taler_merchant_service.h +++ b/src/include/taler_merchant_service.h @@ -4647,7 +4647,7 @@ struct TALER_MERCHANT_WebhookDeleteHandle * TALER_MERCHANT_webhook_delete ( struct GNUNET_CURL_Context *ctx, const char *backend_url, - const char *webhok_id, + const char *webhook_id, TALER_MERCHANT_WebhookDeleteCallback cb, void *cb_cls); diff --git a/src/include/taler_merchantdb_plugin.h b/src/include/taler_merchantdb_plugin.h index 764bdab6..707cf2d9 100644 --- a/src/include/taler_merchantdb_plugin.h +++ b/src/include/taler_merchantdb_plugin.h @@ -383,16 +383,17 @@ struct TALER_MERCHANTDB_WebhookDetails }; + /** * Typically called by `lookup_webhook_by_event`. * * @param cls a `json_t *` JSON array to build * @param webhook_serial reference to the configured webhook template. - * @param next_attempt is the time we should make the next request to the webhook. - * @param url to make request to - * @param http_method use for the webhook - * @param header of the webhook - * @param body of the webhook + * @param event_type which type of event triggers this type of webhook + * @param url the HTTP URL to make the webhook request to + * @param http_method HTTP method use for the webhook + * @param header_template template for the header of the webhook + * @param body_template template for the body of the webhook */ typedef void (*TALER_MERCHANTDB_WebhookDetailCallback)(void *cls, diff --git a/src/lib/merchant_api_common.h b/src/lib/merchant_api_common.h index 0ffe953d..19a92149 100644 --- a/src/lib/merchant_api_common.h +++ b/src/lib/merchant_api_common.h @@ -32,7 +32,7 @@ * @param cb callback * @param cb_cls closure for @a cb * @param response_code HTTP response code, 0 on error - * @param response response body, NULL if not JSON + * @param json response body, NULL if not JSON */ void TALER_MERCHANT_handle_order_creation_response_ ( diff --git a/src/lib/merchant_api_get_templates.c b/src/lib/merchant_api_get_templates.c index cff408e4..030d80cb 100644 --- a/src/lib/merchant_api_get_templates.c +++ b/src/lib/merchant_api_get_templates.c @@ -68,12 +68,12 @@ struct TALER_MERCHANT_TemplatesGetHandle * Parse template information from @a ia. * * @param ia JSON array (or NULL!) with template data - * @param wgh operation handle + * @param tgh operation handle * @return #GNUNET_OK on success */ static int parse_templates (const json_t *ia, - struct TALER_MERCHANT_TemplatesGetHandle *tgh) + struct TALER_MERCHANT_TemplatesGetHandle *tgh) { unsigned int ies_len = json_array_size (ia); struct TALER_MERCHANT_TemplateEntry ies[ies_len]; @@ -128,8 +128,8 @@ parse_templates (const json_t *ia, */ static void handle_get_templates_finished (void *cls, - long response_code, - const void *response) + long response_code, + const void *response) { struct TALER_MERCHANT_TemplatesGetHandle *tgh = cls; const json_t *json = response; @@ -166,7 +166,7 @@ handle_get_templates_finished (void *cls, if ( (! json_is_array (templates)) || (GNUNET_OK == parse_templates (templates, - tgh)) ) + tgh)) ) { GNUNET_JSON_parse_free (spec); TALER_MERCHANT_templates_get_cancel (tgh); diff --git a/src/testing/testing_api_cmd_post_using_templates.c b/src/testing/testing_api_cmd_post_using_templates.c index 1d6db0eb..137c7df1 100644 --- a/src/testing/testing_api_cmd_post_using_templates.c +++ b/src/testing/testing_api_cmd_post_using_templates.c @@ -75,7 +75,7 @@ struct PostUsingTemplatesState * Callback for a POST /using-templates operation. * * @param cls closure for this function - * @param hr response being processed + * @param por response being processed */ static void post_using_templates_cb (void *cls, -- cgit v1.2.3