-doxygen fixes

8 files changed, 26 insertions, 26 deletions

diff --git a/src/include/taler_amount_lib.h b/src/include/taler_amount_lib.h
index e64ff4d9..069da1d6 100644
--- a/src/include/taler_amount_lib.h
+++ b/src/include/taler_amount_lib.h
@@ -138,7 +138,7 @@ TALER_amount_hton (struct TALER_AmountNBO *res,
  * Convert amount from network to host representation.
  *
  * @param res where to store amount in host representation
- * @param d amount in network representation
+ * @param dn amount in network representation
  */
 void
 TALER_amount_ntoh (struct TALER_Amount *res,
diff --git a/src/include/taler_crypto_lib.h b/src/include/taler_crypto_lib.h
index 5b45661b..321c2b98 100644
--- a/src/include/taler_crypto_lib.h
+++ b/src/include/taler_crypto_lib.h
@@ -446,7 +446,7 @@ TALER_transfer_decrypt (const struct TALER_EncryptedLinkSecretP *secret_enc,
  *
  * @param secret shared secret for refresh link decryption
  * @param trans_sec transfer secret
- * @param secret_enc[out] encrypted secret
+ * @param[out] secret_enc encrypted secret
  * @return #GNUNET_OK on success
  */
 int
diff --git a/src/include/taler_json_lib.h b/src/include/taler_json_lib.h
index dbf2293d..9410d508 100644
--- a/src/include/taler_json_lib.h
+++ b/src/include/taler_json_lib.h
@@ -45,7 +45,7 @@ TALER_json_from_amount (const struct TALER_Amount *amount);
 /**
  * Convert absolute timestamp to a json string.
  *
- * @param the time stamp
+ * @param stamp the time stamp
  * @return a json string with the timestamp in @a stamp
  */
 json_t *
@@ -123,7 +123,7 @@ TALER_json_from_hash (const struct GNUNET_HashCode *hc);
  * Parse given JSON object to Amount
  *
  * @param json the json object representing Amount
- * @param r_amount where the amount has to be written
+ * @param[out] r_amount where the amount has to be written
  * @return #GNUNET_OK upon successful parsing; #GNUNET_SYSERR upon error
  */
 int
@@ -134,12 +134,12 @@ TALER_json_to_amount (json_t *json,
  * Parse given JSON object to absolute time.
  *
  * @param json the json object representing absolute time in seconds
- * @param r_abs where the time has to be written
+ * @param[out] abs where the time has to be written
  * @return #GNUNET_OK upon successful parsing; #GNUNET_SYSERR upon error
  */
 int
 TALER_json_to_abs (json_t *json,
-                   struct GNUNET_TIME_Absolute *r_abs);
+                   struct GNUNET_TIME_Absolute *abs);
 
 /**
  * Parse given JSON object to data
diff --git a/src/include/taler_mint_service.h b/src/include/taler_mint_service.h
index 774f40f5..cc1bbd4c 100644
--- a/src/include/taler_mint_service.h
+++ b/src/include/taler_mint_service.h
@@ -243,7 +243,7 @@ typedef void
  *
  * @param mint the mint handle
  * @param cb the callback to call when a reply for this request is available
- * @param cls closure for the above callback
+ * @param cb_cls closure for the above callback
  * @param deposit_obj the deposit permission received from the customer along
  *         with the wireformat JSON object
  * @return a handle for this request; NULL if the JSON object could not be
@@ -253,7 +253,7 @@ typedef void
 struct TALER_MINT_DepositHandle *
 TALER_MINT_deposit_submit_json (struct TALER_MINT_Handle *mint,
                                 TALER_MINT_DepositResultCallback cb,
-                                void *cls,
+                                void *cb_cls,
                                 json_t *deposit_obj);
 
 
@@ -299,7 +299,7 @@ TALER_MINT_deposit_submit_json_ (struct TALER_MINT_Handle *mint,
  * Cancel a deposit permission request.  This function cannot be used on a
  * request handle if a response is already served for it.
  *
- * @param the deposit permission request handle
+ * @param deposit the deposit permission request handle
  */
 void
 TALER_MINT_deposit_submit_cancel (struct TALER_MINT_DepositHandle *deposit);
diff --git a/src/include/taler_mintdb_lib.h b/src/include/taler_mintdb_lib.h
index a5d3d8d9..76baa520 100644
--- a/src/include/taler_mintdb_lib.h
+++ b/src/include/taler_mintdb_lib.h
@@ -137,8 +137,8 @@ typedef int
  */
 int
 TALER_MINTDB_signing_keys_iterate (const char *mint_base_dir,
-                                          TALER_MINTDB_SigningKeyIterator it,
-                                          void *it_cls);
+                                   TALER_MINTDB_SigningKeyIterator it,
+                                   void *it_cls);
 
 
 /**
@@ -156,8 +156,8 @@ TALER_MINTDB_signing_keys_iterate (const char *mint_base_dir,
  */
 int
 TALER_MINTDB_denomination_keys_iterate (const char *mint_base_dir,
-                                               TALER_MINTDB_DenominationKeyIterator it,
-                                               void *it_cls);
+                                        TALER_MINTDB_DenominationKeyIterator it,
+                                        void *it_cls);
 
 
 /**
@@ -169,19 +169,19 @@ TALER_MINTDB_denomination_keys_iterate (const char *mint_base_dir,
  */
 int
 TALER_MINTDB_denomination_key_write (const char *filename,
-                                            const struct TALER_MINTDB_DenominationKeyIssueInformation *dki);
+                                     const struct TALER_MINTDB_DenominationKeyIssueInformation *dki);
 
 
 /**
  * Import a denomination key from the given file.
  *
  * @param filename the file to import the key from
- * @param[OUT] dki set to the imported denomination key
+ * @param[out] dki set to the imported denomination key
  * @return #GNUNET_OK upon success; #GNUNET_SYSERR upon failure
  */
 int
 TALER_MINTDB_denomination_key_read (const char *filename,
-                                           struct TALER_MINTDB_DenominationKeyIssueInformation *dki);
+                                    struct TALER_MINTDB_DenominationKeyIssueInformation *dki);
 
 
 /**
diff --git a/src/include/taler_mintdb_plugin.h b/src/include/taler_mintdb_plugin.h
index 956487b2..868fb438 100644
--- a/src/include/taler_mintdb_plugin.h
+++ b/src/include/taler_mintdb_plugin.h
@@ -14,7 +14,7 @@
   TALER; see the file COPYING.  If not, If not, see <http://www.gnu.org/licenses/>
 */
 /**
- * @file mint/taler_mintdb_plugin.h
+ * @file include/taler_mintdb_plugin.h
  * @brief Low-level (statement-level) database access for the mint
  * @author Florian Dold
  * @author Christian Grothoff
@@ -707,7 +707,7 @@ struct TALER_MINTDB_Plugin
    * @param cls the @e cls of this struct with the plugin-specific state
    * @param sesssion database handle to use
    * @param session_hash hash over the melt to use for the lookup
-   * @param refresh_session[OUT] where to store the result
+   * @param[out] refresh_session where to store the result
    * @return #GNUNET_YES on success,
    *         #GNUNET_NO if not found,
    *         #GNUNET_SYSERR on DB failure
@@ -801,7 +801,7 @@ struct TALER_MINTDB_Plugin
    * @param sesssion database connection
    * @param session_hash hash to identify refresh session
    * @param num_newcoins size of the @a denom_pubs array
-   * @param denom_pubs[OUT] where to write @a num_newcoins denomination keys
+   * @param[out] denom_pubs where to write @a num_newcoins denomination keys
    * @return #GNUNET_OK on success
    *         #GNUNET_SYSERR on internal error
    */
@@ -844,7 +844,7 @@ struct TALER_MINTDB_Plugin
    * @param session_hash hash to identify refresh session
    * @param i set index (1st dimension)
    * @param num_coins size of the @a commit_coins array
-   * @param commit_coin[OUT] array of coin commitments to return
+   * @param[out] commit_coin array of coin commitments to return
    * @return #GNUNET_OK on success
    *         #GNUNET_NO if not found
    *         #GNUNET_SYSERR on error
@@ -886,8 +886,8 @@ struct TALER_MINTDB_Plugin
    * @param sesssion database connection to use
    * @param session_hash hash to identify refresh session
    * @param i set index (1st dimension)
-   * @param num_links size of the @links array to return
-   * @param links[OUT] array link information to return
+   * @param num_links size of the @a links array to return
+   * @param[out] links array link information to return
    * @return #GNUNET_SYSERR on internal error,
    *         #GNUNET_NO if commitment was not found
    *         #GNUNET_OK on success
@@ -958,8 +958,8 @@ struct TALER_MINTDB_Plugin
    * @param cls the @e cls of this struct with the plugin-specific state
    * @param sesssion database connection
    * @param coin_pub public key of the coin
-   * @param transfer_pub[OUT] public transfer key
-   * @param shared_secret_enc[OUT] set to shared secret
+   * @param[out] transfer_pub public transfer key
+   * @param[out] shared_secret_enc set to shared secret
    * @return #GNUNET_OK on success,
    *         #GNUNET_NO on failure (not found)
    *         #GNUNET_SYSERR on internal failure (database issue)
diff --git a/src/include/taler_pq_lib.h b/src/include/taler_pq_lib.h
index 3cfd27f9..73d2b13b 100644
--- a/src/include/taler_pq_lib.h
+++ b/src/include/taler_pq_lib.h
@@ -14,7 +14,7 @@
   TALER; see the file COPYING.  If not, If not, see <http://www.gnu.org/licenses/>
 */
 /**
- * @file pq/taler_pq_lib.h
+ * @file include/taler_pq_lib.h
  * @brief helper functions for DB interactions
  * @author Sree Harsha Totakura <sreeharsha@totakura.in>
  * @author Florian Dold
diff --git a/src/include/taler_util.h b/src/include/taler_util.h
index b92f2217..7bba573d 100644
--- a/src/include/taler_util.h
+++ b/src/include/taler_util.h
@@ -89,7 +89,7 @@ TALER_config_load (const char *base_dir);
  *
  * @param section section of the configuration to access
  * @param option option of the configuration to access
- * @param denom[OUT] set to the amount found in configuration
+ * @param[out] denom set to the amount found in configuration
  * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
  */
 int