From 8718ecbfcfd6111561118fbf5d293eed37bd838a Mon Sep 17 00:00:00 2001 From: MS Date: Thu, 15 Oct 2020 11:53:01 +0200 Subject: 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 aa328368..933ca524 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 5aa16e97..b6dd2712 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 495f80ff..49e5e969 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 56ff4746..6a8a6e88 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 3518e572..e6d28ff8 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 2c3e9626..d50e2731 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, -- cgit v1.2.3