From: Nikos Mavrogiannopoulos <nmav@redhat.com>
Date: Tue, 17 May 2016 12:13:26 +0000 (+0200)
Subject: doc update [ci skip]
X-Git-Tag: gnutls_3_5_1~140
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e9d4f6812f466b7f0bf4ce8d43902804d8910842;p=thirdparty%2Fgnutls.git

doc update [ci skip]
---

diff --git a/lib/cert.c b/lib/cert.c
index 58087a0785..bcd0d2d9da 100644
--- a/lib/cert.c
+++ b/lib/cert.c
@@ -1,5 +1,6 @@
 /*
- * Copyright (C) 2001-2012 Free Software Foundation, Inc.
+ * Copyright (C) 2001-2016 Free Software Foundation, Inc.
+ * Copyright (C) 2015-2016 Red Hat, Inc.
  *
  * Author: Nikos Mavrogiannopoulos
  *
@@ -101,9 +102,13 @@ void gnutls_certificate_free_cas(gnutls_certificate_credentials_t sc)
  * @flags: Use zero or %GNUTLS_TL_GET_COPY
  *
  * This function will return the issuer of a given certificate.
+ * If the flag %GNUTLS_TL_GET_COPY is specified a copy of the issuer
+ * will be returned which must be freed using gnutls_x509_crt_deinit().
+ * In that case the provided @issuer must not be initialized.
+ *
  * As with gnutls_x509_trust_list_get_issuer() this function requires
- * the %GNUTLS_TL_GET_COPY flag in order to operate with PKCS #11 trust
- * lists. In that case the issuer must be freed using gnutls_x509_crt_deinit().
+ * the %GNUTLS_TL_GET_COPY flag in order to operate with PKCS#11 trust
+ * lists in a thread-safe way. 
  *
  * Returns: On success, %GNUTLS_E_SUCCESS (0) is returned, otherwise a
  *   negative error value.
diff --git a/lib/x509/verify-high.c b/lib/x509/verify-high.c
index 21f4b42a34..2b90936c11 100644
--- a/lib/x509/verify-high.c
+++ b/lib/x509/verify-high.c
@@ -1,6 +1,6 @@
 /*
- * Copyright (C) 2011-2012 Free Software Foundation, Inc.
- * Copyright (C) 2015 Red Hat, Inc.
+ * Copyright (C) 2011-2016 Free Software Foundation, Inc.
+ * Copyright (C) 2015-2016 Red Hat, Inc.
  *
  * Author: Nikos Mavrogiannopoulos
  *
@@ -934,8 +934,10 @@ int trust_list_get_issuer_by_dn(gnutls_x509_trust_list_t list,
  * This function will find the issuer of the given certificate.
  * If the flag %GNUTLS_TL_GET_COPY is specified a copy of the issuer
  * will be returned which must be freed using gnutls_x509_crt_deinit().
+ * In that case the provided @issuer must not be initialized.
+ *
  * Note that the flag %GNUTLS_TL_GET_COPY is required for this function
- * to work with PKCS #11 trust lists in a thread-safe way.
+ * to work with PKCS#11 trust lists in a thread-safe way.
  *
  * Returns: On success, %GNUTLS_E_SUCCESS (0) is returned, otherwise a
  *   negative error value.