From 7bd0ef88ba5a0446db98919718bd95ff75aff602 Mon Sep 17 00:00:00 2001
From: schwarze <schwarze@openbsd.org>
Date: Tue, 14 Dec 2021 19:36:18 +0000
Subject: [PATCH] add roff(7) comments listing some M_ASN1_* aliases that are
 intentionally undocumented

---
 lib/libcrypto/man/ASN1_STRING_length.3   | 6 ++++--
 lib/libcrypto/man/ASN1_STRING_new.3      | 6 ++++--
 lib/libcrypto/man/ASN1_STRING_print_ex.3 | 5 +++--
 3 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/lib/libcrypto/man/ASN1_STRING_length.3 b/lib/libcrypto/man/ASN1_STRING_length.3
index e7e78677fbe..20834e081a2 100644
--- a/lib/libcrypto/man/ASN1_STRING_length.3
+++ b/lib/libcrypto/man/ASN1_STRING_length.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ASN1_STRING_length.3,v 1.28 2021/12/09 18:45:45 schwarze Exp $
+.\" $OpenBSD: ASN1_STRING_length.3,v 1.29 2021/12/14 19:36:18 schwarze Exp $
 .\" full merge up to: OpenSSL 24a535ea Sep 22 13:14:20 2020 +0100
 .\"
 .\" This file is a derived work.
@@ -66,7 +66,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: December 9 2021 $
+.Dd $Mdocdate: December 14 2021 $
 .Dt ASN1_STRING_LENGTH 3
 .Os
 .Sh NAME
@@ -84,6 +84,8 @@
 .Nm ASN1_STRING_copy ,
 .Nm ASN1_STRING_to_UTF8 ,
 .Nm ASN1_STRING_type
+.\" deprecated aliases, intentionally undocumented:
+.\" M_ASN1_STRING_data, M_ASN1_STRING_length
 .Nd ASN1_STRING utility functions
 .Sh SYNOPSIS
 .In openssl/asn1.h
diff --git a/lib/libcrypto/man/ASN1_STRING_new.3 b/lib/libcrypto/man/ASN1_STRING_new.3
index 619ab91e481..d9f5093f334 100644
--- a/lib/libcrypto/man/ASN1_STRING_new.3
+++ b/lib/libcrypto/man/ASN1_STRING_new.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: ASN1_STRING_new.3,v 1.23 2021/11/19 16:00:54 schwarze Exp $
+.\"	$OpenBSD: ASN1_STRING_new.3,v 1.24 2021/12/14 19:36:18 schwarze Exp $
 .\"	OpenSSL 99d63d46 Tue Mar 24 07:52:24 2015 -0400
 .\"
 .\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
@@ -15,7 +15,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: November 19 2021 $
+.Dd $Mdocdate: December 14 2021 $
 .Dt ASN1_STRING_NEW 3
 .Os
 .Sh NAME
@@ -58,6 +58,8 @@
 .Nm ASN1_UTCTIME_free ,
 .Nm ASN1_TIME_new ,
 .Nm ASN1_TIME_free
+.\" deprecated aliases, intentionally undocumented: M_ASN1_IA5STRING_new,
+.\" M_ASN1_ENUMERATED_free, M_ASN1_INTEGER_free, M_ASN1_OCTET_STRING_free
 .Nd allocate and free ASN1_STRING objects
 .Sh SYNOPSIS
 .In openssl/asn1.h
diff --git a/lib/libcrypto/man/ASN1_STRING_print_ex.3 b/lib/libcrypto/man/ASN1_STRING_print_ex.3
index 2d48a42c4d5..eb43b2fe5cb 100644
--- a/lib/libcrypto/man/ASN1_STRING_print_ex.3
+++ b/lib/libcrypto/man/ASN1_STRING_print_ex.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ASN1_STRING_print_ex.3,v 1.17 2021/07/11 19:03:45 schwarze Exp $
+.\" $OpenBSD: ASN1_STRING_print_ex.3,v 1.18 2021/12/14 19:36:18 schwarze Exp $
 .\" full merge up to: OpenSSL bb9ad09e Jun 6 00:43:05 2016 -0400
 .\" selective merge up to: OpenSSL 61f805c1 Jan 16 01:01:46 2018 +0800
 .\"
@@ -50,7 +50,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: July 11 2021 $
+.Dd $Mdocdate: December 14 2021 $
 .Dt ASN1_STRING_PRINT_EX 3
 .Os
 .Sh NAME
@@ -58,6 +58,7 @@
 .Nm ASN1_STRING_print_ex_fp ,
 .Nm ASN1_STRING_print ,
 .Nm ASN1_tag2str
+.\" M_ASN1_OCTET_STRING_print is a deprecated alias, intentionally undocumented
 .Nd ASN1_STRING output routines
 .Sh SYNOPSIS
 .In openssl/asn1.h
-- 
2.20.1