implementing #3987

1 files changed, 10 insertions, 10 deletions

diff --git a/src/include/taler_exchange_service.h b/src/include/taler_exchange_service.h
index c3ecba968..cb1bd12aa 100644
--- a/src/include/taler_exchange_service.h
+++ b/src/include/taler_exchange_service.h
@@ -208,19 +208,19 @@ struct TALER_EXCHANGE_DenomPublicKey
 struct TALER_EXCHANGE_AuditorInformation
 {
   /**
-   * Public key of the auditing institution.
+   * Public key of the auditing institution.  Wallets and merchants
+   * are expected to be configured with a set of public keys of
+   * auditors that they deem acceptable.  These public keys are
+   * the roots of the Taler PKI.
    */
   struct TALER_AuditorPublicKeyP auditor_pub;
 
   /**
-   * URL of the auditing institution.  The application must check that
-   * this is an acceptable auditor for its purpose and also verify
-   * that the @a auditor_pub matches the auditor's public key given at
-   * that website.  We expect that in practice software is going to
-   * often ship with an initial list of accepted auditors, just like
-   * browsers ship with a CA root store.
-   *
-   * This field may be NULL. (#3987).
+   * URL of the auditing institution.  Signed by the auditor's public
+   * key, this URL is a place where applications can direct users for
+   * additional information about the auditor.  In the future, there
+   * should also be an auditor API for automated submission about
+   * claims of misbehaving exchange providers.
    */
   const char *auditor_url;
 
@@ -230,7 +230,7 @@ struct TALER_EXCHANGE_AuditorInformation
   unsigned int num_denom_keys;
 
   /**
-   * Array of length @a denom_keys with the denomination
+   * Array of length @a num_denom_keys with the denomination
    * keys audited by this auditor.  Note that the array
    * elements point to the same locations as the entries
    * in the key's main `denom_keys` array.