-doxygen fixes

This commit is contained in:
Christian Grothoff 2015-07-05 13:35:47 +02:00
parent 01551b0d9d
commit a104914e4d
10 changed files with 18 additions and 12 deletions

View File

@ -532,10 +532,10 @@ TALER_MINT_withdraw_status (struct TALER_MINT_Handle *mint,
* Cancel a withdraw status request. This function cannot be used * Cancel a withdraw status request. This function cannot be used
* on a request handle if a response is already served for it. * on a request handle if a response is already served for it.
* *
* @param status the withdraw status request handle * @param wsh the withdraw status request handle
*/ */
void void
TALER_MINT_withdraw_status_cancel (struct TALER_MINT_WithdrawStatusHandle *status); TALER_MINT_withdraw_status_cancel (struct TALER_MINT_WithdrawStatusHandle *wsh);
/* ********************* /withdraw/sign *********************** */ /* ********************* /withdraw/sign *********************** */
@ -574,6 +574,7 @@ typedef void
* *
* @param mint the mint handle; the mint must be ready to operate * @param mint the mint handle; the mint must be ready to operate
* @param pk kind of coin to create * @param pk kind of coin to create
* @param reserve_priv private key of the reserve to withdraw from
* @param coin_priv where to store the coin's private key, * @param coin_priv where to store the coin's private key,
* caller must have committed this value to disk before the call (with @a pk) * caller must have committed this value to disk before the call (with @a pk)
* @param blinding_key where to store the coin's blinding key * @param blinding_key where to store the coin's blinding key
@ -660,7 +661,7 @@ TALER_MINT_admin_add_incoming (struct TALER_MINT_Handle *mint,
* Cancel an add incoming. This function cannot be used on a request * Cancel an add incoming. This function cannot be used on a request
* handle if a response is already served for it. * handle if a response is already served for it.
* *
* @param sign the admin add incoming request handle * @param aai the admin add incoming request handle
*/ */
void void
TALER_MINT_admin_add_incoming_cancel (struct TALER_MINT_AdminAddIncomingHandle *aai); TALER_MINT_admin_add_incoming_cancel (struct TALER_MINT_AdminAddIncomingHandle *aai);

View File

@ -651,12 +651,12 @@ struct TALER_MINTDB_Plugin
* Start a transaction. * Start a transaction.
* *
* @param cls the @e cls of this struct with the plugin-specific state * @param cls the @e cls of this struct with the plugin-specific state
* @param sesssion connection to use * @param session connection to use
* @return #GNUNET_OK on success * @return #GNUNET_OK on success
*/ */
int int
(*start) (void *cls, (*start) (void *cls,
struct TALER_MINTDB_Session *sesssion); struct TALER_MINTDB_Session *session);
/** /**

View File

@ -105,6 +105,7 @@ struct TALER_MINT_AdminAddIncomingHandle
* HTTP /admin/add/incoming request. * HTTP /admin/add/incoming request.
* *
* @param cls the `struct TALER_MINT_AdminAddIncomingHandle` * @param cls the `struct TALER_MINT_AdminAddIncomingHandle`
* @param eh the curl request handle
*/ */
static void static void
handle_admin_add_incoming_finished (void *cls, handle_admin_add_incoming_finished (void *cls,
@ -319,7 +320,7 @@ TALER_MINT_admin_add_incoming (struct TALER_MINT_Handle *mint,
* Cancel an add incoming. This function cannot be used on a request * Cancel an add incoming. This function cannot be used on a request
* handle if a response is already served for it. * handle if a response is already served for it.
* *
* @param sign the admin add incoming request handle * @param aai the admin add incoming request handle
*/ */
void void
TALER_MINT_admin_add_incoming_cancel (struct TALER_MINT_AdminAddIncomingHandle *aai) TALER_MINT_admin_add_incoming_cancel (struct TALER_MINT_AdminAddIncomingHandle *aai)

View File

@ -306,6 +306,7 @@ verify_deposit_signature_forbidden (const struct TALER_MINT_DepositHandle *dh,
* HTTP /deposit request. * HTTP /deposit request.
* *
* @param cls the `struct TALER_MINT_DepositHandle` * @param cls the `struct TALER_MINT_DepositHandle`
* @param eh the curl request handle
*/ */
static void static void
handle_deposit_finished (void *cls, handle_deposit_finished (void *cls,

View File

@ -400,7 +400,7 @@ MAJ_spec_absolute_time (const char *name,
* Specification for parsing an amount value. * Specification for parsing an amount value.
* *
* @param name name of the JSON field * @param name name of the JSON field
* @param at where to store the absolute time found under @a name * @param amount where to store the amount found under @a name
*/ */
struct MAJ_Specification struct MAJ_Specification
MAJ_spec_amount (const char *name, MAJ_spec_amount (const char *name,

View File

@ -228,7 +228,7 @@ MAJ_parse_free (struct MAJ_Specification *spec);
* Base32hex encoding). * Base32hex encoding).
* *
* @param name name of the JSON field * @param name name of the JSON field
* @param obj_ptr pointer where to write the data (a `void **`) * @param obj pointer where to write the data (a `void **`)
* @param size where to store the number of bytes allocated for @a obj (of type `size_t *` * @param size where to store the number of bytes allocated for @a obj (of type `size_t *`
*/ */
#define MAJ_spec_varsize(name,obj,size) { .cmd = MAJ_CMD_BINARY_VARIABLE, .field = name, .details.variable_data.dest_p = obj, .details.variable_data.dest_size_p = size } #define MAJ_spec_varsize(name,obj,size) { .cmd = MAJ_CMD_BINARY_VARIABLE, .field = name, .details.variable_data.dest_p = obj, .details.variable_data.dest_size_p = size }
@ -260,7 +260,7 @@ MAJ_spec_absolute_time (const char *name,
* Specification for parsing an amount value. * Specification for parsing an amount value.
* *
* @param name name of the JSON field * @param name name of the JSON field
* @param at where to store the absolute time found under @a name * @param amount where to store the amount under @a name
*/ */
struct MAJ_Specification struct MAJ_Specification
MAJ_spec_amount (const char *name, MAJ_spec_amount (const char *name,

View File

@ -287,6 +287,7 @@ parse_reserve_history (json_t *history,
* HTTP /withdraw/status request. * HTTP /withdraw/status request.
* *
* @param cls the `struct TALER_MINT_WithdrawStatusHandle` * @param cls the `struct TALER_MINT_WithdrawStatusHandle`
* @param eh curl handle of the request that finished
*/ */
static void static void
handle_withdraw_status_finished (void *cls, handle_withdraw_status_finished (void *cls,
@ -788,6 +789,7 @@ withdraw_sign_payment_required (struct TALER_MINT_WithdrawSignHandle *wsh,
* HTTP /withdraw/sign request. * HTTP /withdraw/sign request.
* *
* @param cls the `struct TALER_MINT_WithdrawSignHandle` * @param cls the `struct TALER_MINT_WithdrawSignHandle`
* @param eh curl handle of the request that finished
*/ */
static void static void
handle_withdraw_sign_finished (void *cls, handle_withdraw_sign_finished (void *cls,
@ -937,6 +939,7 @@ withdraw_sign_download_cb (char *bufptr,
* *
* @param mint the mint handle; the mint must be ready to operate * @param mint the mint handle; the mint must be ready to operate
* @param pk kind of coin to create * @param pk kind of coin to create
* @param reserve_priv private key of the reserve to withdraw from
* @param coin_priv where to store the coin's private key, * @param coin_priv where to store the coin's private key,
* caller must have committed this value to disk before the call (with @a pk) * caller must have committed this value to disk before the call (with @a pk)
* @param blinding_key where to store the coin's blinding key * @param blinding_key where to store the coin's blinding key

View File

@ -1051,7 +1051,7 @@ TMH_PARSE_amount_json (struct MHD_Connection *connection,
* Generate line in parser specification for JSON object value. * Generate line in parser specification for JSON object value.
* *
* @param field name of the field * @param field name of the field
* @param ptraddr address of pointer to JSON to initialize * @param jsonp address of pointer to JSON to initialize
* @return corresponding field spec * @return corresponding field spec
*/ */
struct TMH_PARSE_FieldSpecification struct TMH_PARSE_FieldSpecification

View File

@ -265,7 +265,7 @@ TMH_PARSE_release_data (struct TMH_PARSE_FieldSpecification *spec);
* Generate line in parser specification for JSON object value. * Generate line in parser specification for JSON object value.
* *
* @param field name of the field * @param field name of the field
* @param ptraddr address of pointer to JSON to initialize * @param jsonp address of pointer to JSON to initialize
* @return corresponding field spec * @return corresponding field spec
*/ */
struct TMH_PARSE_FieldSpecification struct TMH_PARSE_FieldSpecification

View File

@ -1096,7 +1096,7 @@ postgres_insert_denomination_info (void *cls,
* Fetch information about a denomination key. * Fetch information about a denomination key.
* *
* @param cls the @e cls of this struct with the plugin-specific state * @param cls the @e cls of this struct with the plugin-specific state
* @param sesssion connection to use * @param session connection to use
* @param denom_pub the public key used for signing coins of this denomination * @param denom_pub the public key used for signing coins of this denomination
* @param[out] issue set to issue information with value, fees and other info about the coin, can be NULL * @param[out] issue set to issue information with value, fees and other info about the coin, can be NULL
* @return #GNUNET_OK on success; #GNUNET_NO if no record was found, #GNUNET_SYSERR on failure * @return #GNUNET_OK on success; #GNUNET_NO if no record was found, #GNUNET_SYSERR on failure