-fix comments for doxygen

src/exchange/taler-exchange-httpd_age-withdraw_reveal.c

@@ -113,7 +113,7 @@ age_reveal_context_free (struct AgeRevealContext *actx)
  * @param j_coin_evs The blinded envelopes in JSON format for the coins that are not revealed and will be signed on success
  * @param j_disclosed_coin_secrets The n*(kappa-1) disclosed coins' private keys in JSON format, from which all other attributes (age restriction, blinding, nonce) will be derived from
  * @param[out] actx The context of the operation, only partially built at call time
- * @param[out] mhd_mret The result if a reply is queued for MHD
+ * @param[out] mhd_ret The result if a reply is queued for MHD
  * @return true on success, false on failure, with a reply already queued for MHD.
  */
 static enum GNUNET_GenericReturnValue
@@ -415,8 +415,8 @@ denomination_is_valid (
  * @param len The lengths of the array @a denoms_h
  * @param denoms_h array of hashes of denomination public keys
  * @param[out] dks On success, will be filled with the denomination keys.  Caller must deallocate.
- * @param amount_with_fee The commited amount including fees
- * @param[out] total_sum On success, will contain the total sum of all denominations
+ * @param amount_with_fee The committed amount including fees
+ * @param[out] total_amount On success, will contain the total sum of all denominations
  * @param[out] total_fee On success, will contain the total sum of all fees
  * @param[out] result In the error cases, a response will be queued with MHD and this will be the result.
  * @return GNUNET_OK if the denominations are valid and support age-restriction
@@ -491,7 +491,7 @@ are_denominations_valid (
     }
   }
 
-  /* Compare the commited amount against the totals */
+  /* Compare the committed amount against the totals */
   {
     struct TALER_Amount sum;
     TALER_amount_set_zero (TEH_currency, &sum);
@@ -539,7 +539,7 @@ are_denominations_valid (
  * @param num_coins Number of coins
  * @param coin_evs The Hashes of the undisclosed, blinded coins, @a num_coins many
  * @param denom_keys The array of denomination keys, @a num_coins. Needed to detect Clause-Schnorr-based denominations
- * @param discloded_coin_secrets The secrets of the disclosed coins, (TALER_CNC_KAPPA - 1)*num_coins many
+ * @param disclosed_coin_secrets The secrets of the disclosed coins, (TALER_CNC_KAPPA - 1)*num_coins many
  * @param[out] result On error, a HTTP-response will be queued and result set accordingly
  * @return GNUNET_OK on success, GNUNET_SYSERR otherwise
  */
@@ -790,7 +790,7 @@ TEH_handler_age_withdraw_reveal (
       break;
 
     /* Verify the computed h_commitment equals the committed one and that
-     * coins have a maximum age group corresponding max_age (age-mask dependend) */
+     * coins have a maximum age group corresponding max_age (age-mask dependent) */
     if (GNUNET_OK != verify_commitment_and_max_age (
           rc->connection,
           &actx.commitment.h_commitment,

src/exchange/taler-exchange-httpd_config.h

@@ -48,7 +48,7 @@
  * Manages a /config call.
  *
  * @param rc context of the handler
- * @param[in,out] args remaining arguments (ingored)
+ * @param[in,out] args remaining arguments (ignored)
  * @return MHD result code
  */
 MHD_RESULT

src/include/taler_crypto_lib.h

@@ -950,13 +950,13 @@ GNUNET_NETWORK_STRUCT_END
 
 
 /**
- * It is build pos confirmation to verify paiement.
+ * @brief Builds POS confirmation token to verify payment.
  *
  * @param pos_key encoded key for verification payment
  * @param pos_alg algorithm to compute the payment verification
  * @param total of the order paid
- * @parmam ts is the time given
- *
+ * @param ts is the time given
+ * @return POS token on success, NULL otherwise
  */
 char *
 TALER_build_pos_confirmation (const char *pos_key,
@@ -4851,7 +4851,7 @@ TALER_exchange_online_purse_status_verify (
  * Create age-withdraw confirmation signature.
  *
  * @param scb function to call to create the signature
- * @param awch age-withdraw commitment that identifies the n*kappa blinded coins
+ * @param h_commitment age-withdraw commitment that identifies the n*kappa blinded coins
  * @param noreveal_index gamma cut-and-choose value chosen by the exchange
  * @param[out] pub where to write the exchange public key
  * @param[out] sig where to write the exchange signature
@@ -5946,7 +5946,7 @@ GNUNET_CRYPTO_EcdsaPublicKey
 TALER_age_commitment_base_public_key;
 
 /**
- * @brief Similiar to TALER_age_restriction_commit, but takes the coin's
+ * @brief Similar to TALER_age_restriction_commit, but takes the coin's
  * private key as seed input and calculates the public keys in the slots larger
  * than the given age as derived from TALER_age_commitment_base_public_key.
  *

src/include/taler_exchangedb_plugin.h

@@ -1053,7 +1053,7 @@ struct TALER_EXCHANGEDB_CollectableBlindcoin
 
 /**
  * @brief Information we keep for an age-withdraw commitment
- * to reproduce the /age-withdraw operation if neede, and to have proof
+ * to reproduce the /age-withdraw operation if needed, and to have proof
  * that a reserve was drained by this amount.
  */
 struct TALER_EXCHANGEDB_AgeWithdrawCommitment
@@ -1097,7 +1097,7 @@ struct TALER_EXCHANGEDB_AgeWithdrawCommitment
   struct TALER_ExchangeSignatureP sig;
 
   /**
-   * Timestamp of the request beeing made
+   * Timestamp of the request being made
    */
   struct GNUNET_TIME_Timestamp timestamp;
 };

src/util/crypto_confirmation.c

@@ -163,6 +163,14 @@ base32decode (const char *val,
 }
 
 
+/**
+ * @brief Builds POS confirmation to verify payment.
+ *
+ * @param h_key opaque key for the totp operation
+ * @param h_key_len size of h_key in bytes
+ * @param ts current time
+ * @return Token on success, NULL of failure
+ */
 static char *
 executive_totp (void *h_key,
                 size_t h_key_len,
@@ -201,14 +209,6 @@ executive_totp (void *h_key,
 }
 
 
-/**
- * It is build pos confirmation to verify payment.
- *
- * @param pos_key base32 (RFC 3548, not Crockford!) encoded key for verification payment
- * @param pos_alg algorithm to compute the payment verification
- * @param total of the order paid
- * @param ts is the current time given
- */
 char *
 TALER_build_pos_confirmation (const char *pos_key,
                               enum TALER_MerchantConfirmationAlgorithm pos_alg,
@@ -217,7 +217,7 @@ TALER_build_pos_confirmation (const char *pos_key,
 {
   size_t pos_key_length = strlen (pos_key);
   void *key; /* pos_key in binary */
-  size_t key_len; /* lengh of the key */
+  size_t key_len; /* length of the key */
   char *ret;
   int dret;