Add a roff comment saying that X509_certificate_type(3) is intentionally
authorschwarze <schwarze@openbsd.org>
Fri, 2 Jul 2021 11:48:01 +0000 (11:48 +0000)
committerschwarze <schwarze@openbsd.org>
Fri, 2 Jul 2021 11:48:01 +0000 (11:48 +0000)
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.

lib/libcrypto/man/EVP_PKEY_set1_RSA.3

index 99faf8d..2883c02 100644 (file)
@@ -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