clean up comments, renaming for clarity

This commit is contained in:
Christian Grothoff 2020-03-05 22:38:19 +01:00
parent 642992f9c3
commit 7dd52a0892
No known key found for this signature in database
GPG Key ID: 939E6BE1E29FC3CC
2 changed files with 36 additions and 36 deletions

View File

@ -4507,7 +4507,7 @@ struct WireTransferResultContext
/** /**
* Function to call on each result. * Function to call on each result.
*/ */
TALER_EXCHANGEDB_WireTransferDataCallback cb; TALER_EXCHANGEDB_AggregationDataCallback cb;
/** /**
* Closure for @e cb. * Closure for @e cb.
@ -4612,7 +4612,7 @@ postgres_lookup_wire_transfer (void *cls,
struct TALER_EXCHANGEDB_Session *session, struct TALER_EXCHANGEDB_Session *session,
const struct const struct
TALER_WireTransferIdentifierRawP *wtid, TALER_WireTransferIdentifierRawP *wtid,
TALER_EXCHANGEDB_WireTransferDataCallback cb, TALER_EXCHANGEDB_AggregationDataCallback cb,
void *cb_cls) void *cb_cls)
{ {
struct PostgresClosure *pg = cls; struct PostgresClosure *pg = cls;

View File

@ -574,7 +574,7 @@ struct TALER_EXCHANGEDB_Deposit
/** /**
* @brief Specification for a /deposit operation in the * @brief Specification for a deposit operation in the
* `struct TALER_EXCHANGEDB_TransactionList`. * `struct TALER_EXCHANGEDB_TransactionList`.
*/ */
struct TALER_EXCHANGEDB_DepositListEntry struct TALER_EXCHANGEDB_DepositListEntry
@ -659,7 +659,7 @@ struct TALER_EXCHANGEDB_DepositListEntry
/** /**
* @brief Specification for a /refund operation in a coin's transaction list. * @brief Specification for a refund operation in a coin's transaction list.
*/ */
struct TALER_EXCHANGEDB_RefundListEntry struct TALER_EXCHANGEDB_RefundListEntry
{ {
@ -701,7 +701,7 @@ struct TALER_EXCHANGEDB_RefundListEntry
/** /**
* @brief Specification for a /refund operation. The combination of * @brief Specification for a refund operation. The combination of
* the coin's public key, the merchant's public key and the * the coin's public key, the merchant's public key and the
* transaction ID must be unique. While a coin can (theoretically) be * transaction ID must be unique. While a coin can (theoretically) be
* deposited at the same merchant twice (with partial spending), the * deposited at the same merchant twice (with partial spending), the
@ -727,7 +727,7 @@ struct TALER_EXCHANGEDB_Refund
/** /**
* @brief Specification for coin in a /refresh/melt operation. * @brief Specification for coin in a melt operation.
*/ */
struct TALER_EXCHANGEDB_Refresh struct TALER_EXCHANGEDB_Refresh
{ {
@ -860,32 +860,32 @@ enum TALER_EXCHANGEDB_TransactionType
{ {
/** /**
* /deposit operation. * Deposit operation.
*/ */
TALER_EXCHANGEDB_TT_DEPOSIT = 0, TALER_EXCHANGEDB_TT_DEPOSIT = 0,
/** /**
* /refresh/melt operation. * Melt operation.
*/ */
TALER_EXCHANGEDB_TT_MELT = 1, TALER_EXCHANGEDB_TT_MELT = 1,
/** /**
* /refund operation. * Refund operation.
*/ */
TALER_EXCHANGEDB_TT_REFUND = 2, TALER_EXCHANGEDB_TT_REFUND = 2,
/** /**
* /recoup-refresh operation (on the old coin, adding to the old coin's value) * Recoup-refresh operation (on the old coin, adding to the old coin's value)
*/ */
TALER_EXCHANGEDB_TT_OLD_COIN_RECOUP = 3, TALER_EXCHANGEDB_TT_OLD_COIN_RECOUP = 3,
/** /**
* /recoup operation. * Recoup operation.
*/ */
TALER_EXCHANGEDB_TT_RECOUP = 4, TALER_EXCHANGEDB_TT_RECOUP = 4,
/** /**
* /recoup-refresh operation (on the new coin, eliminating its value) * Recoup-refresh operation (on the new coin, eliminating its value)
*/ */
TALER_EXCHANGEDB_TT_RECOUP_REFRESH = 5 TALER_EXCHANGEDB_TT_RECOUP_REFRESH = 5
@ -1305,27 +1305,27 @@ typedef void
* @param coin_fee applicable fee for this coin * @param coin_fee applicable fee for this coin
*/ */
typedef void typedef void
(*TALER_EXCHANGEDB_WireTransferDataCallback)(void *cls, (*TALER_EXCHANGEDB_AggregationDataCallback)(void *cls,
uint64_t rowid, uint64_t rowid,
const struct const struct
TALER_MerchantPublicKeyP * TALER_MerchantPublicKeyP *
merchant_pub, merchant_pub,
const struct const struct
GNUNET_HashCode *h_wire, GNUNET_HashCode *h_wire,
const json_t *account_details, const json_t *account_details,
struct GNUNET_TIME_Absolute struct GNUNET_TIME_Absolute
exec_time, exec_time,
const struct const struct
GNUNET_HashCode *h_contract_terms, GNUNET_HashCode *h_contract_terms,
const struct const struct
TALER_DenominationPublicKey * TALER_DenominationPublicKey *
denom_pub, denom_pub,
const struct const struct
TALER_CoinSpendPublicKeyP *coin_pub, TALER_CoinSpendPublicKeyP *coin_pub,
const struct const struct
TALER_Amount *coin_value, TALER_Amount *coin_value,
const struct const struct
TALER_Amount *coin_fee); TALER_Amount *coin_fee);
/** /**
@ -2120,7 +2120,7 @@ struct TALER_EXCHANGEDB_Plugin
/** /**
* Store in the database which coin(s) the wallet wanted to create * Store in the database which coin(s) the wallet wanted to create
* in a given refresh operation and all of the other information * in a given refresh operation and all of the other information
* we learned or created in the /refresh/reveal step. * we learned or created in the reveal step.
* *
* @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 session database connection * @param session database connection
@ -2186,7 +2186,7 @@ struct TALER_EXCHANGEDB_Plugin
/** /**
* Compile a list of all (historic) transactions performed * Compile a list of all (historic) transactions performed
* with the given coin (/refresh/melt and /deposit operations). * with the given coin (melt, refund, recoup and deposit operations).
* *
* @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 session database connection * @param session database connection
@ -2229,7 +2229,7 @@ struct TALER_EXCHANGEDB_Plugin
(*lookup_wire_transfer)(void *cls, (*lookup_wire_transfer)(void *cls,
struct TALER_EXCHANGEDB_Session *session, struct TALER_EXCHANGEDB_Session *session,
const struct TALER_WireTransferIdentifierRawP *wtid, const struct TALER_WireTransferIdentifierRawP *wtid,
TALER_EXCHANGEDB_WireTransferDataCallback cb, TALER_EXCHANGEDB_AggregationDataCallback cb,
void *cb_cls); void *cb_cls);