Improve documentation of gnutls_x509_trust_list_iter_get_ca [ci skip]

The documentation is confusing because it implies that
gnutls_x509_trust_list_iter_deinit() should be called after using this
function, but in fact it is generally not necessary.

Also, there was a typo here ("usin").

Signed-off-by: Michael Catanzaro <mcatanzaro@igalia.com>

diff --git a/lib/x509/verify-high.c b/lib/x509/verify-high.c
index 7b375d61fb0cf7fbba8f047c6d9fa60f8756846b..18906ddc1a85555950b910f0d2a2cb5af0bc6a8d 100644 (file)
--- a/lib/x509/verify-high.c
+++ b/lib/x509/verify-high.c
@@ -397,8 +397,11 @@ advance_iter(gnutls_x509_trust_list_t list,
  * When past the last element is accessed %GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE
  * is returned and the iterator is reset.
  *
- * After use, the iterator must be deinitialized usin
- *  gnutls_x509_trust_list_iter_deinit().
+ * The iterator is deinitialized and reset to %NULL automatically by this
+ * function after iterating through all elements until
+ * %GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE is returned. If the iteration is
+ * aborted early, it must be manually deinitialized using
+ * gnutls_x509_trust_list_iter_deinit().
  *
  * Returns: On success, %GNUTLS_E_SUCCESS (0) is returned, otherwise a
  *   negative error value.