doc update [ci skip]

diff --git a/lib/cert.c b/lib/cert.c
index 58087a07856aabf79046ab874fa95d1381885f73..bcd0d2d9da224cb184a333014661e53f7f6f0f4f 100644 (file)
--- 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 21f4b42a34f36b52ae41707333390a7b63afcbc9..2b90936c110f6fbb215e192650c0aac419e16074 100644 (file)
--- 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.