Doxygen fixes

16 files changed, 0 insertions, 238 deletions

diff --git a/src/testing/testing_api_cmd_abort_order.c b/src/testing/testing_api_cmd_abort_order.c
index 3e9ba56a..a72682b3 100644
--- a/src/testing/testing_api_cmd_abort_order.c
+++ b/src/testing/testing_api_cmd_abort_order.c
@@ -410,15 +410,6 @@ abort_traits (void *cls,
 }
 
 
-/**
- * Make an "abort" test command.
- *
- * @param label command label
- * @param merchant_url merchant base URL
- * @param pay_reference reference to the payment to abort
- * @param http_status expected HTTP response code
- * @return the command
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_order_abort (const char *label,
                                         const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_claim_order.c b/src/testing/testing_api_cmd_claim_order.c
index 50172101..9ef18e06 100644
--- a/src/testing/testing_api_cmd_claim_order.c
+++ b/src/testing/testing_api_cmd_claim_order.c
@@ -280,17 +280,6 @@ order_claim_traits (void *cls,
 }
 
 
-/**
- * Make a "order claim" command.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant backend
- *        serving the order claim request.
- * @param http_status expected HTTP response code.
- * @param order_reference reference to a POST order CMD, can be NULL if @a order_id given
- * @param order_id order id to lookup, can be NULL (then we use @a order_reference)
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_claim_order (
   const char *label,
diff --git a/src/testing/testing_api_cmd_config.c b/src/testing/testing_api_cmd_config.c
index 1ed88fef..6487be4e 100644
--- a/src/testing/testing_api_cmd_config.c
+++ b/src/testing/testing_api_cmd_config.c
@@ -129,15 +129,6 @@ config_run (void *cls,
 }
 
 
-/**
- * Define a "config" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant serving the
- *        "config" request.
- * @param http_code expected HTTP response code.
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_config (const char *label,
                           const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_delete_instance.c b/src/testing/testing_api_cmd_delete_instance.c
index 635ddf7d..013e63f8 100644
--- a/src/testing/testing_api_cmd_delete_instance.c
+++ b/src/testing/testing_api_cmd_delete_instance.c
@@ -156,16 +156,6 @@ delete_instance_cleanup (void *cls,
 }
 
 
-/**
- * Define a "DELETE instance" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant serving the
- *        DELETE /instances/$ID request.
- * @param instance_id the ID of the instance to query
- * @param http_status expected HTTP response code.
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_delete_instance (const char *label,
                                             const char *merchant_url,
@@ -191,16 +181,6 @@ TALER_TESTING_cmd_merchant_delete_instance (const char *label,
 }
 
 
-/**
- * Define a "PURGE instance" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant serving the
- *        PURGE /instances/$ID request.
- * @param instance_id the ID of the instance to query
- * @param http_status expected HTTP response code.
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_purge_instance (const char *label,
                                            const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_delete_order.c b/src/testing/testing_api_cmd_delete_order.c
index aa5cb32e..0ddf6cf2 100644
--- a/src/testing/testing_api_cmd_delete_order.c
+++ b/src/testing/testing_api_cmd_delete_order.c
@@ -144,16 +144,6 @@ delete_order_cleanup (void *cls,
 }
 
 
-/**
- * Define a "DELETE order" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant serving the
- *        DELETE /instances/$ID request.
- * @param order_id the ID of the instance to query
- * @param http_status expected HTTP response code.
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_delete_order (const char *label,
                                          const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_delete_product.c b/src/testing/testing_api_cmd_delete_product.c
index d85b27fd..193917b0 100644
--- a/src/testing/testing_api_cmd_delete_product.c
+++ b/src/testing/testing_api_cmd_delete_product.c
@@ -144,16 +144,6 @@ delete_product_cleanup (void *cls,
 }
 
 
-/**
- * Define a "DELETE product" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant serving the
- *        DELETE /products/$ID request.
- * @param product_id the ID of the product to query
- * @param http_status expected HTTP response code.
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_delete_product (const char *label,
                                            const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_delete_reserve.c b/src/testing/testing_api_cmd_delete_reserve.c
index 515ec17d..fc12f04c 100644
--- a/src/testing/testing_api_cmd_delete_reserve.c
+++ b/src/testing/testing_api_cmd_delete_reserve.c
@@ -171,16 +171,6 @@ delete_reserve_cleanup (void *cls,
 }
 
 
-/**
- * Define a "DELETE reserve" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant serving the
- *        DELETE /reserves/$RESERVE_PUB request.
- * @param reserve_reference command label of a command providing a reserve
- * @param http_status expected HTTP response code.
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_delete_reserve (const char *label,
                                            const char *merchant_url,
@@ -206,16 +196,6 @@ TALER_TESTING_cmd_merchant_delete_reserve (const char *label,
 }
 
 
-/**
- * Define a "PURGE reserve" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant serving the
- *        DELETE /reserves/$RESERVE_PUB request.
- * @param reserve_reference command label of a command providing a reserve
- * @param http_status expected HTTP response code.
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_purge_reserve (const char *label,
                                           const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_forget_order.c b/src/testing/testing_api_cmd_forget_order.c
index 259814e4..777be585 100644
--- a/src/testing/testing_api_cmd_forget_order.c
+++ b/src/testing/testing_api_cmd_forget_order.c
@@ -203,19 +203,6 @@ order_forget_traits (void *cls,
 }
 
 
-/**
- * Make a "order forget" command.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant backend
- *        serving the order claim request.
- * @param http_status expected HTTP response code.
- * @param order_reference reference to a POST order CMD, can be NULL if @a order_id given
- * @param order_id order id to forget for, can be NULL (then we use @a order_reference)
- * @param ... NULL-terminated list of paths (const char *) to forget in
- *        the contract terms.
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_forget_order (
   const char *label,
diff --git a/src/testing/testing_api_cmd_get_instance.c b/src/testing/testing_api_cmd_get_instance.c
index ccdbec9e..cb45b358 100644
--- a/src/testing/testing_api_cmd_get_instance.c
+++ b/src/testing/testing_api_cmd_get_instance.c
@@ -373,19 +373,6 @@ get_instance_cleanup (void *cls,
 }
 
 
-/**
- * Define a "GET instance" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant serving the
- *        GET /instances/$ID request.
- * @param instance_id the ID of the instance to query
- * @param http_status expected HTTP response code.
- * @param instance_reference reference to a "POST /instances" or "PATCH /instances/$ID" CMD
- *        that will provide what we expect the backend to return to us.
- *
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_get_instance (const char *label,
                                          const char *merchant_url,
@@ -414,22 +401,6 @@ TALER_TESTING_cmd_merchant_get_instance (const char *label,
 }
 
 
-/**
- * Define a "GET instance" CMD that compares accounts returned.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant serving the
- *        GET /instances/$ID request.
- * @param instance_id the ID of the instance to query
- * @param http_status expected HTTP response code.
- * @param instance_reference reference to a "POST /instances" or "PATCH /instances/$ID" CMD
- *        that will provide what we expect the backend to return to us
- * @param active_accounts the accounts the merchant is actively using.
- * @param active_accounts_length length of @e active_accounts.
- * @param inactive_accounts the accounts the merchant is no longer using.
- * @param inactive_accounts_length length of @e inactive_accounts.
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_get_instance2 (const char *label,
                                           const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_get_instances.c b/src/testing/testing_api_cmd_get_instances.c
index 25ceab47..3ad8c7ee 100644
--- a/src/testing/testing_api_cmd_get_instances.c
+++ b/src/testing/testing_api_cmd_get_instances.c
@@ -214,18 +214,6 @@ get_instances_cleanup (void *cls,
 }
 
 
-/**
- * Define a "GET /instances" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant serving the
- *        GET /instances request.
- * @param http_status expected HTTP response code.
- * @param ... NULL-terminated list of labels (const char *) of
- *        product (commands) we expect to be returned in the list
- *        (assuming @a http_code is #MHD_HTTP_OK)
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_get_instances (const char *label,
                                           const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_get_orders.c b/src/testing/testing_api_cmd_get_orders.c
index 50740baf..d61f9f5e 100644
--- a/src/testing/testing_api_cmd_get_orders.c
+++ b/src/testing/testing_api_cmd_get_orders.c
@@ -232,18 +232,6 @@ get_orders_cleanup (void *cls,
 }
 
 
-/**
- * Define a "GET /orders" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant serving the
- *        GET /orders request.
- * @param http_status expected HTTP response code.
- * @param ... NULL-terminated list of labels (const char *) of
- *        reserve (commands) we expect to be returned in the list
- *        (assuming @a http_code is #MHD_HTTP_OK)
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_get_orders (const char *label,
                                        const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_get_product.c b/src/testing/testing_api_cmd_get_product.c
index 9ccc7e46..e65a3793 100644
--- a/src/testing/testing_api_cmd_get_product.c
+++ b/src/testing/testing_api_cmd_get_product.c
@@ -331,18 +331,6 @@ get_product_cleanup (void *cls,
 }
 
 
-/**
- * Define a "GET product" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant serving the
- *        GET /products/$ID request.
- * @param product_id the ID of the product to query
- * @param http_status expected HTTP response code.
- * @param product_reference reference to a "POST /products" or "PATCH /products/$ID" CMD
- *        that will provide what we expect the backend to return to us
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_get_product (const char *label,
                                         const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_get_products.c b/src/testing/testing_api_cmd_get_products.c
index 11981e06..2df168ee 100644
--- a/src/testing/testing_api_cmd_get_products.c
+++ b/src/testing/testing_api_cmd_get_products.c
@@ -193,18 +193,6 @@ get_products_cleanup (void *cls,
 }
 
 
-/**
- * Define a "GET /products" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant serving the
- *        GET /products request.
- * @param http_status expected HTTP response code.
- * @param ... NULL-terminated list of labels (const char *) of
- *        product (commands) we expect to be returned in the list
- *        (assuming @a http_code is #MHD_HTTP_OK)
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_get_products (const char *label,
                                          const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_get_reserve.c b/src/testing/testing_api_cmd_get_reserve.c
index 5c83ee62..aa56c50c 100644
--- a/src/testing/testing_api_cmd_get_reserve.c
+++ b/src/testing/testing_api_cmd_get_reserve.c
@@ -262,16 +262,6 @@ get_reserve_cleanup (void *cls,
 }
 
 
-/**
- * Define a "GET reserve" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant serving the request.
- * @param http_status expected HTTP response code.
- * @param reserve_reference reference to a "POST /reserves" that provides the
- *        information we are expecting.
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_get_reserve (const char *label,
                                         const char *merchant_url,
@@ -298,19 +288,6 @@ TALER_TESTING_cmd_merchant_get_reserve (const char *label,
 }
 
 
-/**
- * Define a "GET reserve" CMD.
- *
- * @param label command label.
- * @param merchant_url base URL of the merchant serving the request.
- * @param http_status expected HTTP response code.
- * @param reserve_reference reference to a "POST /reserves" that provides the
- *        information we are expecting.
- * @param ... NULL-terminated list of labels (const char *) of
- *        tip (commands) we expect to be returned in the list
- *        (assuming @a http_code is #MHD_HTTP_OK)
- * @return the command.
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_get_reserve_with_tips (const char *label,
                                                   const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_get_reserves.c b/src/testing/testing_api_cmd_get_reserves.c
index d7d6f696..22e0e1cd 100644
--- a/src/testing/testing_api_cmd_get_reserves.c
+++ b/src/testing/testing_api_cmd_get_reserves.c
@@ -214,16 +214,6 @@ get_reserves_cleanup (void *cls,
 }
 
 
-/**
- * Define a "GET /reserves" CMD
- *
- * @param label command label.
- * @param merchant_url url to the merchant.
- * @param http_status expected HTTP response code.
- * @param ... NULL-terminated list of labels (const char *) of
- *        reserve (commands) we expect to be returned in the list
- *        (assuming @a http_code is #MHD_HTTP_OK)
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_merchant_get_reserves (const char *label,
                                          const char *merchant_url,
diff --git a/src/testing/testing_api_cmd_get_tips.c b/src/testing/testing_api_cmd_get_tips.c
index a0a97f85..7b481d04 100644
--- a/src/testing/testing_api_cmd_get_tips.c
+++ b/src/testing/testing_api_cmd_get_tips.c
@@ -226,18 +226,6 @@ get_tips_cleanup (void *cls,
 }
 
 
-/**
- * Define a get tips CMD.
- *
- * @param label the command label
- * @param merchant_url base URL of the merchant which will
- *        server the /tip-query request.
- * @param http_status expected HTTP response code for the
- *        /tip-query request.
- * @param ... NULL-terminated list of labels (const char *) of
- *        tip (commands) we expect to be returned in the list
- *        (assuming @a http_code is #MHD_HTTP_OK)
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_get_tips (const char *label,
                             const char *merchant_url,
@@ -277,20 +265,6 @@ TALER_TESTING_cmd_get_tips (const char *label,
 }
 
 
-/**
- * Define a get tips CMD.
- *
- * @param label the command label
- * @param merchant_url base URL of the merchant which will
- *        server the /tip-query request.
- * @param http_status expected HTTP response code for the
- *        /tip-query request.
- * @param offset row to start querying the database from.
- * @param limit how many rows to return (with direction).
- * @param ... NULL-terminated list of labels (const char *) of
- *        tip (commands) we expect to be returned in the list
- *        (assuming @a http_code is #MHD_HTTP_OK)
- */
 struct TALER_TESTING_Command
 TALER_TESTING_cmd_get_tips2 (const char *label,
                              const char *merchant_url,