doxygen fixes

9 files changed, 1 insertions, 60 deletions

diff --git a/src/backend/taler-merchant-httpd_post-orders-ID-abort.c b/src/backend/taler-merchant-httpd_post-orders-ID-abort.c
index ad191020..58c38b76 100644
--- a/src/backend/taler-merchant-httpd_post-orders-ID-abort.c
+++ b/src/backend/taler-merchant-httpd_post-orders-ID-abort.c
@@ -853,6 +853,7 @@ begin_transaction (struct AbortContext *ac)
  *
  * @param connection HTTP connection we are receiving abortment on
  * @param hc context we use to handle the abortment
+ * @param ac state of the /abort call
  * @return #GNUNET_OK on success,
  *         #GNUNET_NO on failure (response was queued with MHD)
  *         #GNUNET_SYSERR on hard error (MHD connection must be dropped)
diff --git a/src/backend/taler-merchant-httpd_post-orders-ID-pay.c b/src/backend/taler-merchant-httpd_post-orders-ID-pay.c
index e9264b3e..f33aa9da 100644
--- a/src/backend/taler-merchant-httpd_post-orders-ID-pay.c
+++ b/src/backend/taler-merchant-httpd_post-orders-ID-pay.c
@@ -1280,13 +1280,6 @@ check_payment_sufficient (struct PayContext *pc)
   return true;
 }
 
-
-/**
- * Begin of the DB transaction for a payment.  If required (from
- * soft/serialization errors), the transaction can be restarted here.
- *
- * @param[in,out] pc payment context to transact
- */
 static void
 begin_transaction (struct PayContext *pc)
 {
@@ -1831,14 +1824,6 @@ handle_pay_timeout (void *cls)
 }
 
 
-/**
- * Process a payment for a claimed order.
- *
- * @param rh context of the handler
- * @param connection the MHD connection to handle
- * @param[in,out] hc context with further information about the request
- * @return MHD result code
- */
 MHD_RESULT
 TMH_post_orders_ID_pay (const struct TMH_RequestHandler *rh,
                         struct MHD_Connection *connection,
diff --git a/src/backend/taler-merchant-httpd_post-orders-ID-refund.c b/src/backend/taler-merchant-httpd_post-orders-ID-refund.c
index 6c862e49..cc12dc03 100644
--- a/src/backend/taler-merchant-httpd_post-orders-ID-refund.c
+++ b/src/backend/taler-merchant-httpd_post-orders-ID-refund.c
@@ -456,7 +456,6 @@ exchange_found_cb (void *cls,
  * @param exchange_url URL of the exchange that issued @a coin_pub
  * @param rtransaction_id identificator of the refund
  * @param reason human-readable explanation of the refund
- * @param timestamp when was the refund made
  * @param refund_amount refund amount which is being taken from @a coin_pub
  * @param pending true if the this refund was not yet processed by the wallet/exchange
  */
diff --git a/src/backend/taler-merchant-httpd_private-get-orders-ID.c b/src/backend/taler-merchant-httpd_private-get-orders-ID.c
index dbac2295..49bd63cf 100644
--- a/src/backend/taler-merchant-httpd_private-get-orders-ID.c
+++ b/src/backend/taler-merchant-httpd_private-get-orders-ID.c
@@ -620,7 +620,6 @@ gorc_cleanup (void *cls)
  * @param exchange_url URL of the exchange that issued @a coin_pub
  * @param rtransaction_id identificator of the refund
  * @param reason human-readable explanation of the refund
- * @param timestamp when was the refund made
  * @param refund_amount refund amount which is being taken from @a coin_pub
  * @param pending true if the this refund was not yet processed by the wallet/exchange
  */
@@ -730,15 +729,6 @@ process_transfer_details (void *cls,
 }
 
 
-/**
- * Manages a GET /private/orders/ID call, checking the status of a payment and
- * refunds and, if necessary, constructing the URL for a payment redirect URL.
- *
- * @param rh context of the handler
- * @param connection the MHD connection to handle
- * @param[in,out] hc context with further information about the request
- * @return MHD result code
- */
 MHD_RESULT
 TMH_private_get_orders_ID (const struct TMH_RequestHandler *rh,
                            struct MHD_Connection *connection,
diff --git a/src/backend/taler-merchant-httpd_private-get-orders.c b/src/backend/taler-merchant-httpd_private-get-orders.c
index 3ee08112..8df4e69c 100644
--- a/src/backend/taler-merchant-httpd_private-get-orders.c
+++ b/src/backend/taler-merchant-httpd_private-get-orders.c
@@ -216,7 +216,6 @@ cleanup (void *ctx)
  * @param exchange_url URL of the exchange that issued @a coin_pub
  * @param rtransaction_id identificator of the refund
  * @param reason human-readable explanation of the refund
- * @param timestamp when was the refund made
  * @param refund_amount refund amount which is being taken from @a coin_pub
  * @param pending true if the this refund was not yet processed by the wallet/exchange
  */
diff --git a/src/backend/taler-merchant-httpd_private-get-tips-ID.c b/src/backend/taler-merchant-httpd_private-get-tips-ID.c
index 440871d9..f1a3254c 100644
--- a/src/backend/taler-merchant-httpd_private-get-tips-ID.c
+++ b/src/backend/taler-merchant-httpd_private-get-tips-ID.c
@@ -28,14 +28,6 @@
 #include "taler-merchant-httpd_exchanges.h"
 
 
-/**
- * Manages a GET /tips/$ID call, returning the status of a tip.
- *
- * @param rh context of the handler
- * @param connection the MHD connection to handle
- * @param[in,out] hc context with further information about the request
- * @return MHD result code
- */
 MHD_RESULT
 TMH_private_get_tips_ID (const struct TMH_RequestHandler *rh,
                          struct MHD_Connection *connection,
diff --git a/src/backend/taler-merchant-httpd_private-get-tips.c b/src/backend/taler-merchant-httpd_private-get-tips.c
index c012ad39..74b9751b 100644
--- a/src/backend/taler-merchant-httpd_private-get-tips.c
+++ b/src/backend/taler-merchant-httpd_private-get-tips.c
@@ -51,15 +51,6 @@ add_tip (void *cls,
                      TALER_JSON_from_amount (&amount))));
 }
 
-
-/**
- * Handle a GET "/tips/$ID" request.
- *
- * @param rh context of the handler
- * @param connection the MHD connection to handle
- * @param[in,out] hc context with further information about the request
- * @return MHD result code
- */
 MHD_RESULT
 TMH_private_get_tips (const struct TMH_RequestHandler *rh,
                       struct MHD_Connection *connection,
diff --git a/src/backend/taler-merchant-httpd_private-post-products.c b/src/backend/taler-merchant-httpd_private-post-products.c
index dd690baf..3a35b9e6 100644
--- a/src/backend/taler-merchant-httpd_private-post-products.c
+++ b/src/backend/taler-merchant-httpd_private-post-products.c
@@ -68,14 +68,6 @@ products_equal (const struct TALER_MERCHANTDB_ProductDetails *p1,
 }
 
 
-/**
- * Generate an instance, given its configuration.
- *
- * @param rh context of the handler
- * @param connection the MHD connection to handle
- * @param[in,out] hc context with further information about the request
- * @return MHD result code
- */
 MHD_RESULT
 TMH_private_post_products (const struct TMH_RequestHandler *rh,
                            struct MHD_Connection *connection,
diff --git a/src/backend/taler-merchant-httpd_private-post-reserves.c b/src/backend/taler-merchant-httpd_private-post-reserves.c
index 6734fa44..ce50b24e 100644
--- a/src/backend/taler-merchant-httpd_private-post-reserves.c
+++ b/src/backend/taler-merchant-httpd_private-post-reserves.c
@@ -219,14 +219,6 @@ handle_exchange (void *cls,
 }
 
 
-/**
- * Generate a reserve, given its keys and balance.
- *
- * @param rh context of the handler
- * @param connection the MHD connection to handle
- * @param[in,out] hc context with further information about the request
- * @return MHD result code
- */
 MHD_RESULT
 TMH_private_post_reserves (const struct TMH_RequestHandler *rh,
                            struct MHD_Connection *connection,