-doxygen

11 files changed, 14 insertions, 28 deletions

diff --git a/doc/doxygen/taler.doxy b/doc/doxygen/taler.doxy
index 7d06be3c..80e1acbd 100644
--- a/doc/doxygen/taler.doxy
+++ b/doc/doxygen/taler.doxy
@@ -273,7 +273,6 @@ EXTERNAL_GROUPS        = YES
 #---------------------------------------------------------------------------
 # Configuration options related to the dot tool
 #---------------------------------------------------------------------------
-CLASS_DIAGRAMS         = YES
 HIDE_UNDOC_RELATIONS   = YES
 HAVE_DOT               = YES
 CLASS_GRAPH            = NO
diff --git a/src/backend/taler-merchant-httpd.c b/src/backend/taler-merchant-httpd.c
index 68a81947..c016b5aa 100644
--- a/src/backend/taler-merchant-httpd.c
+++ b/src/backend/taler-merchant-httpd.c
@@ -1845,7 +1845,7 @@ url_handler (void *cls,
  * Callback invoked with information about a bank account.
  *
  * @param cls closure with a `struct TMH_MerchantInstance *`
- * @param ad details about the account
+ * @param acc details about the account
  */
 static void
 add_account_cb (void *cls,
diff --git a/src/backend/taler-merchant-httpd_private-get-otp-devices.c b/src/backend/taler-merchant-httpd_private-get-otp-devices.c
index df86842b..189b1e09 100644
--- a/src/backend/taler-merchant-httpd_private-get-otp-devices.c
+++ b/src/backend/taler-merchant-httpd_private-get-otp-devices.c
@@ -26,8 +26,8 @@
  * Add OTP device details to our JSON array.
  *
  * @param cls a `json_t *` JSON array to build
- * @param template_id ID of the template
- * @param template_description human-readable description for the template
+ * @param otp_id ID of the OTP device
+ * @param otp_description human-readable description for the OTP device
  */
 static void
 add_otp (void *cls,
diff --git a/src/backend/taler-merchant-httpd_private-patch-otp-devices-ID.c b/src/backend/taler-merchant-httpd_private-patch-otp-devices-ID.c
index f0fc8b0b..356b9b8a 100644
--- a/src/backend/taler-merchant-httpd_private-patch-otp-devices-ID.c
+++ b/src/backend/taler-merchant-httpd_private-patch-otp-devices-ID.c
@@ -28,14 +28,6 @@
 #include <taler/taler_json_lib.h>
 
 
-/**
- * PATCH OTP device of an existing instance.
- *
- * @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_patch_otp_devices_ID (const struct TMH_RequestHandler *rh,
                                   struct MHD_Connection *connection,
diff --git a/src/backenddb/pg_insert_deposit_to_transfer.c b/src/backenddb/pg_insert_deposit_to_transfer.c
index 4b5f0cc3..ddd9d254 100644
--- a/src/backenddb/pg_insert_deposit_to_transfer.c
+++ b/src/backenddb/pg_insert_deposit_to_transfer.c
@@ -14,7 +14,7 @@
    TALER; see the file COPYING.  If not, see <http://www.gnu.org/licenses/>
  */
 /**
- * @file backenddb/pg_postgres_insert_deposit_to_transfer.c
+ * @file backenddb/pg_insert_deposit_to_transfer.c
  * @brief Implementation of the insert_deposit_to_transfer function for Postgres
  * @author Christian Grothoff
  */
diff --git a/src/backenddb/pg_insert_pickup.h b/src/backenddb/pg_insert_pickup.h
index 73a0598d..d9e960c5 100644
--- a/src/backenddb/pg_insert_pickup.h
+++ b/src/backenddb/pg_insert_pickup.h
@@ -14,12 +14,12 @@
    TALER; see the file COPYING.  If not, see <http://www.gnu.org/licenses/>
  */
 /**
- * @file backenddb/pg_postgres_insert_pickup.h
- * @brief implementation of the postgres_insert_pickup function for Postgres
+ * @file backenddb/pg_insert_pickup.h
+ * @brief implementation of the insert_pickup function for Postgres
  * @author Christian Grothoff
  */
-#ifndef PG_POSTGRES_INSERT_PICKUP_H
-#define PG_POSTGRES_INSERT_PICKUP_H
+#ifndef PG_INSERT_PICKUP_H
+#define PG_INSERT_PICKUP_H
 
 #include <taler/taler_util.h>
 #include <taler/taler_json_lib.h>
diff --git a/src/backenddb/pg_insert_transfer.h b/src/backenddb/pg_insert_transfer.h
index b7bffa11..8385c330 100644
--- a/src/backenddb/pg_insert_transfer.h
+++ b/src/backenddb/pg_insert_transfer.h
@@ -14,12 +14,12 @@
    TALER; see the file COPYING.  If not, see <http://www.gnu.org/licenses/>
  */
 /**
- * @file backenddb/pg_postgres_insert_transfer.h
+ * @file backenddb/pg_insert_transfer.h
  * @brief implementation of the postgres_insert_transfer function for Postgres
  * @author Christian Grothoff
  */
-#ifndef PG_POSTGRES_INSERT_TRANSFER_H
-#define PG_POSTGRES_INSERT_TRANSFER_H
+#ifndef PG_INSERT_TRANSFER_H
+#define PG_INSERT_TRANSFER_H
 
 #include <taler/taler_util.h>
 #include <taler/taler_json_lib.h>
diff --git a/src/backenddb/pg_store_wire_fee_by_exchange.h b/src/backenddb/pg_store_wire_fee_by_exchange.h
index 53ff4c3d..5c7f408a 100644
--- a/src/backenddb/pg_store_wire_fee_by_exchange.h
+++ b/src/backenddb/pg_store_wire_fee_by_exchange.h
@@ -14,12 +14,12 @@
    TALER; see the file COPYING.  If not, see <http://www.gnu.org/licenses/>
  */
 /**
- * @file backenddb/pg_postgres_store_wire_fee_by_exchange.h
+ * @file backenddb/pg_store_wire_fee_by_exchange.h
  * @brief implementation of the postgres_store_wire_fee_by_exchange function for Postgres
  * @author Christian Grothoff
  */
-#ifndef PG_POSTGRES_STORE_WIRE_FEE_BY_EXCHANGE_H
-#define PG_POSTGRES_STORE_WIRE_FEE_BY_EXCHANGE_H
+#ifndef PG_STORE_WIRE_FEE_BY_EXCHANGE_H
+#define PG_STORE_WIRE_FEE_BY_EXCHANGE_H
 
 #include <taler/taler_util.h>
 #include <taler/taler_json_lib.h>
diff --git a/src/include/taler_merchant_service.h b/src/include/taler_merchant_service.h
index e92ea3b8..ef7a46ed 100644
--- a/src/include/taler_merchant_service.h
+++ b/src/include/taler_merchant_service.h
@@ -961,7 +961,6 @@ typedef void
  * @param payto_uri URI of the bank account as per RFC 8905
  * @param credit_facade_url credit facade for the account, can be NULL
  * @param credit_facade_credentials credentials for credit facade, can be NULL
- * @param account the bank accounts to add to the merchant instance
  * @param cb function to call with the response
  * @param cb_cls closure for @a config_cb
  * @return the instances handle; NULL upon error
diff --git a/src/include/taler_merchant_testing_lib.h b/src/include/taler_merchant_testing_lib.h
index ded1ac5a..0f2e1faa 100644
--- a/src/include/taler_merchant_testing_lib.h
+++ b/src/include/taler_merchant_testing_lib.h
@@ -218,8 +218,6 @@ TALER_TESTING_cmd_merchant_delete_account (
  * @param merchant_url base URL of the merchant serving the
  *        PATCH /instance request.
  * @param instance_id the ID of the instance to query
- * @param payto_uris_length length of the @a accounts array
- * @param payto_uris URIs of the bank accounts of the merchant instance
  * @param name name of the merchant instance
  * @param address physical address of the merchant instance
  * @param jurisdiction jurisdiction of the merchant instance
diff --git a/src/include/taler_merchantdb_plugin.h b/src/include/taler_merchantdb_plugin.h
index 14dedce5..5426d57d 100644
--- a/src/include/taler_merchantdb_plugin.h
+++ b/src/include/taler_merchantdb_plugin.h
@@ -210,8 +210,6 @@ struct TALER_MERCHANTDB_InstanceSettings
  * @param merchant_priv private key of the instance, NULL if not available
  * @param is general instance settings
  * @param ias instance authentication settings
- * @param accounts_length length of the @a accounts array
- * @param accounts list of accounts of the merchant
  */
 typedef void
 (*TALER_MERCHANTDB_InstanceCallback)(