[taler-merchant] 01/08: Doxygen fixes

[gnunet]

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

ms pushed a commit to branch master
in repository merchant.

commit 8718ecbfcfd6111561118fbf5d293eed37bd838a
Author: MS <ms@taler.net>
AuthorDate: Thu Oct 15 11:53:01 2020 +0200

    Doxygen fixes
---
 src/testing/testing_api_cmd_refund_order.c         | 12 ----
 src/testing/testing_api_cmd_tip_authorize.c        | 73 ----------------------
 src/testing/testing_api_cmd_tip_pickup.c           | 38 -----------
 src/testing/testing_api_cmd_wallet_get_order.c     | 12 ----
 src/testing/testing_api_cmd_wallet_get_tip.c       | 19 ------
 .../testing_api_cmd_wallet_post_orders_refund.c    | 14 -----
 6 files changed, 168 deletions(-)

diff --git a/src/testing/testing_api_cmd_refund_order.c 
b/src/testing/testing_api_cmd_refund_order.c
index aa32836..933ca52 100644
--- a/src/testing/testing_api_cmd_refund_order.c
+++ b/src/testing/testing_api_cmd_refund_order.c
@@ -227,18 +227,6 @@ refund_increase_cleanup (void *cls,
 }
 
 
-/**
- * Define a "refund order" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the backend serving the
- *        "refund increase" request.
- * @param reason refund justification, human-readable.
- * @param order_id order id of the contract to refund.
- * @param refund_amount amount to be refund-increased.
- * @param http_code expected HTTP response code.
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_order_refund (const char *label,
                                          const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_tip_authorize.c 
b/src/testing/testing_api_cmd_tip_authorize.c
index 5aa16e9..b6dd271 100644
--- a/src/testing/testing_api_cmd_tip_authorize.c
+++ b/src/testing/testing_api_cmd_tip_authorize.c
@@ -279,22 +279,6 @@ tip_authorize_cleanup (void *cls,
 }
 
 
-/**
- * Create a /tip-authorize CMD, specifying the Taler error code
- * that is expected to be returned by the backend.
- *
- * @param label this command label
- * @param merchant_url the base URL of the merchant that will
- *        serve the /tip-authorize request.
- * @param exchange_url the base URL of the exchange that owns
- *        the reserve from which the tip is going to be gotten.
- * @param http_status the HTTP response code which is expected
- *        for this operation.
- * @param justification human-readable justification for this
- *        tip authorization.
- * @param amount the amount to authorize for tipping.
- * @param ec expected Taler-defined error code.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_tip_authorize_with_ec (const char *label,
                                          const char *merchant_url,
@@ -328,24 +312,6 @@ TALER_TESTING_cmd_tip_authorize_with_ec (const char *label,
 }
 
 
-/**
- * Create a /tip-authorize CMD, specifying the Taler error code
- * that is expected to be returned by the backend.
- *
- * @param label this command label
- * @param merchant_url the base URL of the merchant that will
- *        serve the /tip-authorize request.
- * @param exchange_url the base URL of the exchange that owns
- *        the reserve from which the tip is going to be gotten.
- * @param reserve_reference reference to a command that created
- *        a reserve.
- * @param http_status the HTTP response code which is expected
- *        for this operation.
- * @param justification human-readable justification for this
- *        tip authorization.
- * @param amount the amount to authorize for tipping.
- * @param ec expected Taler-defined error code.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_tip_authorize_from_reserve_with_ec (const char *label,
                                                       const char *merchant_url,
@@ -382,20 +348,6 @@ TALER_TESTING_cmd_tip_authorize_from_reserve_with_ec 
(const char *label,
 }
 
 
-/**
- * Create a /tip-authorize CMD.
- *
- * @param label this command label
- * @param merchant_url the base URL of the merchant that will
- *        serve the /tip-authorize request.
- * @param exchange_url the base URL of the exchange that owns
- *        the reserve from which the tip is going to be gotten.
- * @param http_status the HTTP response code which is expected
- *        for this operation.
- * @param justification human-readable justification for this
- *        tip authorization.
- * @param amount the amount to authorize for tipping.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_tip_authorize (const char *label,
                                  const char *merchant_url,
@@ -427,22 +379,6 @@ TALER_TESTING_cmd_tip_authorize (const char *label,
 }
 
 
-/**
- * Create a /tip-authorize CMD.
- *
- * @param label this command label
- * @param merchant_url the base URL of the merchant that will
- *        serve the /tip-authorize request.
- * @param exchange_url the base URL of the exchange that owns
- *        the reserve from which the tip is going to be gotten.
- * @param reserve_reference reference to a command that created
- *        a reserve.
- * @param http_status the HTTP response code which is expected
- *        for this operation.
- * @param justification human-readable justification for this
- *        tip authorization.
- * @param amount the amount to authorize for tipping.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_tip_authorize_from_reserve (const char *label,
                                               const char *merchant_url,
@@ -476,15 +412,6 @@ TALER_TESTING_cmd_tip_authorize_from_reserve (const char 
*label,
 }
 
 
-/**
- * This commands does not query the backend at all,
- * but just makes up a fake authorization id that will
- * be subsequently used by the "pick up" CMD in order
- * to test against such a case.
- *
- * @param label command label.
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_tip_authorize_fake (const char *label)
 {
diff --git a/src/testing/testing_api_cmd_tip_pickup.c 
b/src/testing/testing_api_cmd_tip_pickup.c
index 495f80f..49e5e96 100644
--- a/src/testing/testing_api_cmd_tip_pickup.c
+++ b/src/testing/testing_api_cmd_tip_pickup.c
@@ -326,16 +326,6 @@ tip_pickup_cleanup (void *cls,
 }
 
 
-/**
- * Offers information from the /tip-pickup CMD state to other
- * commands.
- *
- * @param cls closure
- * @param ret[out] result (could be anything)
- * @param trait name of the trait
- * @param index index number of the object to extract.
- * @return #GNUNET_OK on success
- */
 static int
 tip_pickup_traits (void *cls,
                    const void **ret,
@@ -376,18 +366,6 @@ tip_pickup_traits (void *cls,
 }
 
 
-/**
- * Define a /tip-pickup CMD.
- *
- * @param label the command label
- * @param merchant_url base URL of the backend which will serve
- *        the /tip-pickup request.
- * @param http_status expected HTTP response code.
- * @param authorize_reference reference to a /tip-autorize CMD
- *        that offers a tip id to pick up.
- * @param amounts array of string-defined amounts that specifies
- *        which denominations will be accepted for tipping.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_tip_pickup (const char *label,
                               const char *merchant_url,
@@ -416,22 +394,6 @@ TALER_TESTING_cmd_tip_pickup (const char *label,
 }
 
 
-/**
- * Define a /tip-pickup CMD, equipped with the expected error
- * code.
- *
- * @param label the command label
- * @param merchant_url base URL of the backend which will serve
- *        the /tip-pickup request.
- * @param http_status expected HTTP response code.
- * @param authorize_reference reference to a /tip-autorize CMD
- *        that offers a tip id to pick up.
- * @param amounts array of string-defined amounts that specifies
- *        which denominations will be accepted for tipping.
- * @param exchange connection handle to the exchange that will
- *        eventually serve the withdraw operation.
- * @param ec expected Taler error code.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_tip_pickup_with_ec (const char *label,
                                       const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_wallet_get_order.c 
b/src/testing/testing_api_cmd_wallet_get_order.c
index 56ff474..6a8a6e8 100644
--- a/src/testing/testing_api_cmd_wallet_get_order.c
+++ b/src/testing/testing_api_cmd_wallet_get_order.c
@@ -288,18 +288,6 @@ wallet_get_order_cleanup (void *cls,
 }
 
 
-/**
- * Define a GET /orders/$ORDER_ID CMD.
- *
- * @param label the command label
- * @param merchant_url base URL of the merchant which will
- *        serve the request.
- * @param order_reference reference to a command that created an order.
- * @param paid whether the order has been paid for or not.
- * @param refunded whether the order has been refunded.
- * @param refund_pending whether the order has refunds that haven't been 
obtained.
- * @param http_status expected HTTP response code for the request.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_wallet_get_order (const char *label,
                                     const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_wallet_get_tip.c 
b/src/testing/testing_api_cmd_wallet_get_tip.c
index 3518e57..e6d28ff 100644
--- a/src/testing/testing_api_cmd_wallet_get_tip.c
+++ b/src/testing/testing_api_cmd_wallet_get_tip.c
@@ -207,15 +207,6 @@ wallet_get_tip_cleanup (void *cls,
 }
 
 
-/**
- * Define a GET /tips/$TIP_ID CMD.
- *
- * @param label the command label
- * @param merchant_url base URL of the merchant which will
- *        serve the request.
- * @param tip_reference reference to a command that created a tip.
- * @param http_status expected HTTP response code for the request.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_wallet_get_tip (const char *label,
                                   const char *merchant_url,
@@ -241,16 +232,6 @@ TALER_TESTING_cmd_wallet_get_tip (const char *label,
 }
 
 
-/**
- * Define a GET /tips/$TIP_ID CMD.
- *
- * @param label the command label
- * @param merchant_url base URL of the merchant which will
- *        serve the request.
- * @param tip_reference reference to a command that created a tip.
- * @param amount_remaining the balance remaining after pickups.
- * @param http_status expected HTTP response code for the request.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_wallet_get_tip2 (const char *label,
                                    const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_wallet_post_orders_refund.c 
b/src/testing/testing_api_cmd_wallet_post_orders_refund.c
index 2c3e962..d50e273 100644
--- a/src/testing/testing_api_cmd_wallet_post_orders_refund.c
+++ b/src/testing/testing_api_cmd_wallet_post_orders_refund.c
@@ -262,20 +262,6 @@ obtain_refunds_cleanup (void *cls,
 }
 
 
-/**
- * Define a "refund order" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the backend serving the
- *        "refund increase" request.
- * @param order_ref order id of the contract to refund.
- * @param http_code expected HTTP response code.
- * @param ... NULL-terminated list of labels (const char *) of
- *        refunds (commands) we expect to be aggregated in the transfer
- *        (assuming @a http_code is #MHD_HTTP_OK). If @e refunded is false,
- *        this parameter is ignored.
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_wallet_order_refund (const char *label,
                                        const char *merchant_url,

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