From: Norbert Pocs <norbertpocs0@gmail.com>
Date: Fri, 25 Apr 2025 17:06:44 +0000 (+0200)
Subject: doc/man3: Document missing macro function history
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=70d7194bf5ce3e556a9dde4f9024eb08de64d592;p=thirdparty%2Fopenssl.git

doc/man3: Document missing macro function history

By updating the `util/find-doc-nits` new missing history sections were
discovered. This commit adds the missing.

Signed-off-by: Norbert Pocs <norbertpocs0@gmail.com>

Reviewed-by: Paul Dale <ppzgs1@gmail.com>
Reviewed-by: Tomas Mraz <tomas@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/27488)
---

diff --git a/doc/man3/BIO_f_prefix.pod b/doc/man3/BIO_f_prefix.pod
index 8c7953f4720..62821e5dec6 100644
--- a/doc/man3/BIO_f_prefix.pod
+++ b/doc/man3/BIO_f_prefix.pod
@@ -58,6 +58,10 @@ BIO_get_indent() returns the current indentation, or a negative value for failur
 
 L<bio(7)>
 
+=head1 HISTORY
+
+BIO_get_indent(), BIO_set_indent(), BIO_set_prefix() were added in OpenSSL 3.0.
+
 =head1 COPYRIGHT
 
 Copyright 2019 The OpenSSL Project Authors. All Rights Reserved.
diff --git a/doc/man3/BIO_s_connect.pod b/doc/man3/BIO_s_connect.pod
index 0699e133898..9b3fbdd0567 100644
--- a/doc/man3/BIO_s_connect.pod
+++ b/doc/man3/BIO_s_connect.pod
@@ -223,7 +223,8 @@ BIO_set_conn_int_port(), BIO_get_conn_int_port(), BIO_set_conn_ip(), and BIO_get
 were removed in OpenSSL 1.1.0.
 Use BIO_set_conn_address() and BIO_get_conn_address() instead.
 
-Connect BIOs support BIO_gets() since OpenSSL 3.2.
+Connect BIOs support BIO_gets(), BIO_get0_dgram_bio(), BIO_get_sock_type(),
+BIO_set_sock_type() were added in OpenSSL 3.2.
 
 =head1 COPYRIGHT
 
diff --git a/doc/man3/BIO_s_datagram.pod b/doc/man3/BIO_s_datagram.pod
index 87d6fb34e7a..a84b0cd0995 100644
--- a/doc/man3/BIO_s_datagram.pod
+++ b/doc/man3/BIO_s_datagram.pod
@@ -258,6 +258,10 @@ BIO_dgram_get_mtu_overhead() returns a value in bytes.
 
 L<BIO_sendmmsg(3)>, L<BIO_s_dgram_pair(3)>, L<DTLSv1_listen(3)>, L<bio(7)>
 
+=head1 HISTORY
+
+BIO_dgram_detect_peer_addr() was added in OpenSSL 3.2.
+
 =head1 COPYRIGHT
 
 Copyright 2022-2023 The OpenSSL Project Authors. All Rights Reserved.
diff --git a/doc/man3/BIO_s_dgram_pair.pod b/doc/man3/BIO_s_dgram_pair.pod
index a7da68b4b0d..4d7dc8d5ac0 100644
--- a/doc/man3/BIO_s_dgram_pair.pod
+++ b/doc/man3/BIO_s_dgram_pair.pod
@@ -224,7 +224,12 @@ L<BIO_s_bio(3)>, L<bio(7)>
 
 =head1 HISTORY
 
-BIO_s_dgram_pair(), BIO_new_bio_dgram_pair() were added in OpenSSL 3.2.
+BIO_s_dgram_pair(), BIO_new_bio_dgram_pair(),
+BIO_dgram_get_caps(), BIO_dgram_get_effective_caps(),
+BIO_dgram_get_no_trunc(), BIO_dgram_set_caps(),
+BIO_dgram_set_mtu(), BIO_dgram_set_no_trunc() were added in OpenSSL 3.2.
+
+BIO_dgram_set0_local_addr() was added in OpenSSL 3.5.
 
 =head1 COPYRIGHT
 
diff --git a/doc/man3/SSL_get_peer_signature_nid.pod b/doc/man3/SSL_get_peer_signature_nid.pod
index 5518a9cfc78..5051a05369a 100644
--- a/doc/man3/SSL_get_peer_signature_nid.pod
+++ b/doc/man3/SSL_get_peer_signature_nid.pod
@@ -59,6 +59,8 @@ L<ssl(7)>, L<SSL_get_peer_certificate(3)>,
 The SSL_get0_peer_signature_name() and SSL_get0_signature_name() functions were
 added in OpenSSL 3.5.
 
+SSL_get_signature_nid() was added in OpenSSL 1.1.1a.
+
 =head1 COPYRIGHT
 
 Copyright 2017-2025 The OpenSSL Project Authors. All Rights Reserved.
diff --git a/doc/man3/SSL_get_peer_tmp_key.pod b/doc/man3/SSL_get_peer_tmp_key.pod
index fdbc05de549..bafe7195f40 100644
--- a/doc/man3/SSL_get_peer_tmp_key.pod
+++ b/doc/man3/SSL_get_peer_tmp_key.pod
@@ -41,6 +41,10 @@ This function is implemented as a macro.
 
 L<ssl(7)>, L<EVP_PKEY_free(3)>
 
+=head1 HISTORY
+
+SSL_get_peer_tmp_key(), SSL_get_tmp_key() were added in OpenSSL 1.1.1a.
+
 =head1 COPYRIGHT
 
 Copyright 2017-2018 The OpenSSL Project Authors. All Rights Reserved.
diff --git a/doc/man3/SSL_want.pod b/doc/man3/SSL_want.pod
index 1eddeeba4d8..885922211a8 100644
--- a/doc/man3/SSL_want.pod
+++ b/doc/man3/SSL_want.pod
@@ -112,6 +112,8 @@ L<ssl(7)>, L<SSL_get_error(3)>
 The SSL_want_client_hello_cb() function and the SSL_CLIENT_HELLO_CB return value
 were added in OpenSSL 1.1.1.
 
+SSL_want_retry_verify() was added in OpenSSL 3.0.
+
 =head1 COPYRIGHT
 
 Copyright 2001-2023 The OpenSSL Project Authors. All Rights Reserved.
diff --git a/util/find-doc-nits b/util/find-doc-nits
index d19a364a771..213d8c679bf 100755
--- a/util/find-doc-nits
+++ b/util/find-doc-nits
@@ -1055,7 +1055,7 @@ sub checkmacros {
             }
 
             next if defined $macros_maybe_undocumented{$macro};
-            
+
             $macros_maybe_undocumented{$macro} = $f;
         }
         close(IN);