[taler-merchant] branch master updated: -misc doxygen fixes

[gnunet]

This is an automated email from the git hooks/post-receive script.

grothoff pushed a commit to branch master
in repository merchant.

The following commit(s) were added to refs/heads/master by this push:
     new 5f3116d3 -misc doxygen fixes
5f3116d3 is described below

commit 5f3116d324f4b475365b9a8729a69851419229c3
Author: Christian Grothoff <christian@grothoff.org>
AuthorDate: Tue Jan 17 16:28:47 2023 +0100

    -misc doxygen fixes
---
 contrib/merchant-backoffice                                   |  2 +-
 .../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 +-
 8 files changed, 20 insertions(+), 17 deletions(-)

diff --git a/contrib/merchant-backoffice b/contrib/merchant-backoffice
index 182cdfff..8a683531 160000
--- a/contrib/merchant-backoffice
+++ b/contrib/merchant-backoffice
@@ -1 +1 @@
-Subproject commit 182cdfffa1d4b6f2bb3543d30cfa7509e73bda03
+Subproject commit 8a6835316532d9e250bbdfe9ff55432a1acca62c
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,

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.