From 04103ff0273e613aadaf262ab58fa88ad467d61f Mon Sep 17 00:00:00 2001 From: schwarze <> Date: Sun, 8 Jun 2025 22:37:23 +0000 Subject: remove some "intentionally undocumented" comments regarding stuff that no longer exists, and add .Lb; OK tb@ --- src/lib/libcrypto/man/ASN1_STRING_TABLE_get.3 | 8 +++----- src/lib/libcrypto/man/ASN1_STRING_length.3 | 7 +++---- src/lib/libcrypto/man/ASN1_STRING_new.3 | 7 +++---- src/lib/libcrypto/man/ASN1_STRING_print_ex.3 | 6 +++--- src/lib/libcrypto/man/BN_add.3 | 8 +++----- src/lib/libcrypto/man/DSA_generate_parameters_ex.3 | 7 +++---- src/lib/libcrypto/man/OBJ_create.3 | 6 +++--- src/lib/libcrypto/man/X509_STORE_CTX_set_flags.3 | 7 +++---- src/lib/libcrypto/man/X509_cmp.3 | 8 +++----- 9 files changed, 27 insertions(+), 37 deletions(-) (limited to 'src') diff --git a/src/lib/libcrypto/man/ASN1_STRING_TABLE_get.3 b/src/lib/libcrypto/man/ASN1_STRING_TABLE_get.3 index 2bf8831c12..4149b73d34 100644 --- a/src/lib/libcrypto/man/ASN1_STRING_TABLE_get.3 +++ b/src/lib/libcrypto/man/ASN1_STRING_TABLE_get.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ASN1_STRING_TABLE_get.3,v 1.4 2023/12/21 21:23:37 tb Exp $ +.\" $OpenBSD: ASN1_STRING_TABLE_get.3,v 1.5 2025/06/08 22:37:23 schwarze Exp $ .\" checked up to: .\" OpenSSL ASN1_STRING_TABLE_add.pod 7b608d08 Jul 27 01:18:50 2017 +0800 .\" @@ -16,17 +16,15 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: December 21 2023 $ +.Dd $Mdocdate: June 8 2025 $ .Dt ASN1_STRING_TABLE_GET 3 .Os .Sh NAME -.\" .Nm ASN1_STRING_TABLE_add0 and -.\" .Nm ASN1_STRING_TABLE_cleanup are intentionally undocumented -.\" because they will be removed in the next major bump .\" .Dv STABLE_FLAGS_MALLOC is intentionally undocumented because it is unused .Nm ASN1_STRING_TABLE_get .Nd retrieve an entry from the global ASN.1 string table .Sh SYNOPSIS +.Lb libcrypto .In openssl/asn1.h .Ft ASN1_STRING_TABLE * .Fo ASN1_STRING_TABLE_get diff --git a/src/lib/libcrypto/man/ASN1_STRING_length.3 b/src/lib/libcrypto/man/ASN1_STRING_length.3 index 0c397607a9..922ae89ac6 100644 --- a/src/lib/libcrypto/man/ASN1_STRING_length.3 +++ b/src/lib/libcrypto/man/ASN1_STRING_length.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ASN1_STRING_length.3,v 1.30 2024/12/27 15:30:17 schwarze Exp $ +.\" $OpenBSD: ASN1_STRING_length.3,v 1.31 2025/06/08 22:37:23 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 27 2024 $ +.Dd $Mdocdate: June 8 2025 $ .Dt ASN1_STRING_LENGTH 3 .Os .Sh NAME @@ -84,10 +84,9 @@ .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 +.Lb libcrypto .In openssl/asn1.h .Ft int .Fo ASN1_STRING_cmp diff --git a/src/lib/libcrypto/man/ASN1_STRING_new.3 b/src/lib/libcrypto/man/ASN1_STRING_new.3 index 212bacd413..d653b70dda 100644 --- a/src/lib/libcrypto/man/ASN1_STRING_new.3 +++ b/src/lib/libcrypto/man/ASN1_STRING_new.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ASN1_STRING_new.3,v 1.27 2024/12/27 15:30:17 schwarze Exp $ +.\" $OpenBSD: ASN1_STRING_new.3,v 1.28 2025/06/08 22:37:23 schwarze Exp $ .\" OpenSSL 99d63d46 Tue Mar 24 07:52:24 2015 -0400 .\" .\" Copyright (c) 2017 Ingo Schwarze @@ -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: December 27 2024 $ +.Dd $Mdocdate: June 8 2025 $ .Dt ASN1_STRING_NEW 3 .Os .Sh NAME @@ -58,10 +58,9 @@ .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 +.Lb libcrypto .In openssl/asn1.h .Ft ASN1_STRING * .Fn ASN1_STRING_new void diff --git a/src/lib/libcrypto/man/ASN1_STRING_print_ex.3 b/src/lib/libcrypto/man/ASN1_STRING_print_ex.3 index eb43b2fe5c..8295b3e9dd 100644 --- a/src/lib/libcrypto/man/ASN1_STRING_print_ex.3 +++ b/src/lib/libcrypto/man/ASN1_STRING_print_ex.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ASN1_STRING_print_ex.3,v 1.18 2021/12/14 19:36:18 schwarze Exp $ +.\" $OpenBSD: ASN1_STRING_print_ex.3,v 1.19 2025/06/08 22:37:23 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: December 14 2021 $ +.Dd $Mdocdate: June 8 2025 $ .Dt ASN1_STRING_PRINT_EX 3 .Os .Sh NAME @@ -58,9 +58,9 @@ .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 +.Lb libcrypto .In openssl/asn1.h .Ft int .Fo ASN1_STRING_print_ex diff --git a/src/lib/libcrypto/man/BN_add.3 b/src/lib/libcrypto/man/BN_add.3 index e7de441b7a..32378f6940 100644 --- a/src/lib/libcrypto/man/BN_add.3 +++ b/src/lib/libcrypto/man/BN_add.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: BN_add.3,v 1.20 2023/04/27 09:47:03 tb Exp $ +.\" $OpenBSD: BN_add.3,v 1.21 2025/06/08 22:37:23 schwarze Exp $ .\" full merge up to: OpenSSL e9b77246 Jan 20 19:58:49 2017 +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: April 27 2023 $ +.Dd $Mdocdate: June 8 2025 $ .Dt BN_ADD 3 .Os .Sh NAME @@ -94,13 +94,11 @@ .\" The following are public, but intentionally undocumented for now: .\" .Nm BN_mod_exp_mont , r \(== a ^ p (mod m) .\" .Nm BN_mod_exp_mont_consttime , -.\" .Nm BN_mod_exp_mont_word , -.\" .Nm BN_mod_exp_simple , -.\" .Nm BN_mod_exp2_mont r \(== (a1 ^ p1) * (a2 ^ p2) (mod m) .\" Maybe they should be deleted from . .Nm BN_gcd .Nd arithmetic operations on BIGNUMs .Sh SYNOPSIS +.Lb libcrypto .In openssl/bn.h .Ft int .Fo BN_add diff --git a/src/lib/libcrypto/man/DSA_generate_parameters_ex.3 b/src/lib/libcrypto/man/DSA_generate_parameters_ex.3 index a318bf8298..fb610b8191 100644 --- a/src/lib/libcrypto/man/DSA_generate_parameters_ex.3 +++ b/src/lib/libcrypto/man/DSA_generate_parameters_ex.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: DSA_generate_parameters_ex.3,v 1.1 2023/12/29 19:15:15 tb Exp $ +.\" $OpenBSD: DSA_generate_parameters_ex.3,v 1.2 2025/06/08 22:37:23 schwarze Exp $ .\" OpenSSL 9b86974e Aug 7 22:14:47 2015 -0400 .\" .\" This file was written by Ulf Moeller , @@ -49,15 +49,14 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED .\" OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: December 29 2023 $ +.Dd $Mdocdate: June 8 2025 $ .Dt DSA_GENERATE_PARAMETERS_EX 3 .Os .Sh NAME -.\" .Nm DSA_generate_parameters is intentionally undocumented -.\" because it will be removed in the next major bump .Nm DSA_generate_parameters_ex .Nd generate DSA parameters .Sh SYNOPSIS +.Lb libcrypto .In openssl/dsa.h .Ft int .Fo DSA_generate_parameters_ex diff --git a/src/lib/libcrypto/man/OBJ_create.3 b/src/lib/libcrypto/man/OBJ_create.3 index fa5bde3dd3..75d51f4bb8 100644 --- a/src/lib/libcrypto/man/OBJ_create.3 +++ b/src/lib/libcrypto/man/OBJ_create.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: OBJ_create.3,v 1.10 2024/01/31 08:02:53 tb Exp $ +.\" $OpenBSD: OBJ_create.3,v 1.11 2025/06/08 22:37:23 schwarze Exp $ .\" full merge up to: .\" OpenSSL OBJ_nid2obj.pod 9b86974e Aug 17 15:21:33 2015 -0400 .\" selective merge up to: @@ -69,18 +69,18 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED .\" OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: January 31 2024 $ +.Dd $Mdocdate: June 8 2025 $ .Dt OBJ_CREATE 3 .Os .Sh NAME .Nm OBJ_new_nid , .Nm OBJ_add_object , .Nm OBJ_create , -.\" OBJ_create_and_add_object is a deprecated, unused alias for OBJ_create(3). .Nm OBJ_create_objects , .Nm OBJ_cleanup .Nd modify the table of ASN.1 object identifiers .Sh SYNOPSIS +.Lb libcrypto .In openssl/objects.h .Ft int .Fn OBJ_new_nid "int increment" diff --git a/src/lib/libcrypto/man/X509_STORE_CTX_set_flags.3 b/src/lib/libcrypto/man/X509_STORE_CTX_set_flags.3 index 04bb202bac..028d4da810 100644 --- a/src/lib/libcrypto/man/X509_STORE_CTX_set_flags.3 +++ b/src/lib/libcrypto/man/X509_STORE_CTX_set_flags.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: X509_STORE_CTX_set_flags.3,v 1.8 2024/08/29 20:21:10 tb Exp $ +.\" $OpenBSD: X509_STORE_CTX_set_flags.3,v 1.9 2025/06/08 22:37:23 schwarze Exp $ .\" full merge up to: OpenSSL aae41f8c Jun 25 09:47:15 2015 +0100 .\" selective merge up to: OpenSSL 24a535ea Sep 22 13:14:20 2020 +0100 .\" @@ -67,7 +67,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED .\" OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: August 29 2024 $ +.Dd $Mdocdate: June 8 2025 $ .Dt X509_STORE_CTX_SET_FLAGS 3 .Os .Sh NAME @@ -76,13 +76,12 @@ .Nm X509_STORE_CTX_set_depth , .Nm X509_STORE_CTX_set_trust , .Nm X509_STORE_CTX_set_purpose , -.\" .Nm X509_STORE_CTX_purpose_inherit is intentionally undocumented -.\" because it will be removed in the next major bump. .Nm X509_STORE_CTX_get0_param , .Nm X509_STORE_CTX_set0_param , .Nm X509_STORE_CTX_set_default .Nd X509_STORE_CTX parameter initialisation .Sh SYNOPSIS +.Lb libcrypto .In openssl/x509_vfy.h .Ft void .Fo X509_STORE_CTX_set_flags diff --git a/src/lib/libcrypto/man/X509_cmp.3 b/src/lib/libcrypto/man/X509_cmp.3 index b1cdec1773..e025f5c8c0 100644 --- a/src/lib/libcrypto/man/X509_cmp.3 +++ b/src/lib/libcrypto/man/X509_cmp.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: X509_cmp.3,v 1.4 2024/06/07 14:00:09 job Exp $ +.\" $OpenBSD: X509_cmp.3,v 1.5 2025/06/08 22:37:23 schwarze Exp $ .\" full merge up to: OpenSSL ea5d4b89 Jun 6 11:42:02 2019 +0800 .\" .\" 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 7 2024 $ +.Dd $Mdocdate: June 8 2025 $ .Dt X509_CMP 3 .Os .Sh NAME @@ -79,10 +79,8 @@ .Nm X509_CRL_cmp , .Nm X509_CRL_match .Nd compare X.509 certificates and related values -.\" The function name_cmp() is intentionally undocumented. -.\" It was a mistake to make it public in the first place, -.\" and it is no longer part of the public API in OpenSSL 1.1. .Sh SYNOPSIS +.Lb libcrypto .In openssl/x509.h .Ft int .Fo X509_cmp -- cgit v1.2.3-55-g6feb