From: schwarze <schwarze@openbsd.org>
Date: Fri, 2 Jul 2021 11:48:01 +0000 (+0000)
Subject: Add a roff comment saying that X509_certificate_type(3) is intentionally
X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=d6f825788e84a2ee5d67881546e875cf01961fe5;p=openbsd

Add a roff comment saying that X509_certificate_type(3) is intentionally
undocumented.  It is archaic and practically unused and unusable.
tb@ and jsing@ agree with marking it as undocumented.
Put the comment here because EVP_PKEY_base_id(3) is a viable alternative.
---

diff --git a/lib/libcrypto/man/EVP_PKEY_set1_RSA.3 b/lib/libcrypto/man/EVP_PKEY_set1_RSA.3
index 99faf8dabbf..2883c02d345 100644
--- a/lib/libcrypto/man/EVP_PKEY_set1_RSA.3
+++ b/lib/libcrypto/man/EVP_PKEY_set1_RSA.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: EVP_PKEY_set1_RSA.3,v 1.17 2020/06/24 19:55:54 schwarze Exp $
+.\" $OpenBSD: EVP_PKEY_set1_RSA.3,v 1.18 2021/07/02 11:48:01 schwarze Exp $
 .\" full merge up to: OpenSSL 99d63d46 Oct 26 13:56:48 2016 -0400
 .\"
 .\" This file is a derived work.
@@ -65,7 +65,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: June 24 2020 $
+.Dd $Mdocdate: July 2 2021 $
 .Dt EVP_PKEY_SET1_RSA 3
 .Os
 .Sh NAME
@@ -93,6 +93,9 @@
 .Nm EVP_PKEY_id ,
 .Nm EVP_PKEY_type ,
 .Nm EVP_PKEY_set_type
+.\" The function X509_certificate_type(3) is intentionally undocumented
+.\" and scheduled for deletion from the library.  BoringSSL already
+.\" deleted it and OpenSSL deprecates it in version 3.0.
 .Nd EVP_PKEY assignment functions
 .Sh SYNOPSIS
 .In openssl/evp.h