doc: Add deprecation note to SSL_get_peer_certificate description

Fixes #22972

CLA: trivial

Reviewed-by: Matt Caswell <matt@openssl.org>
Reviewed-by: Paul Dale <paul.dale@oracle.com>
(Merged from https://github.com/openssl/openssl/pull/29764)

diff --git a/doc/man3/SSL_get_peer_certificate.pod b/doc/man3/SSL_get_peer_certificate.pod
index 1897a43ebe7a6f9e09027487adcc2a7e1c9ec0a2..9a24438c814ec9c15ad2c1765da0999f1482830a 100644 (file)
--- a/doc/man3/SSL_get_peer_certificate.pod
+++ b/doc/man3/SSL_get_peer_certificate.pod
@@ -21,6 +21,9 @@ version value, see L<openssl_user_macros(7)>:
 
 =head1 DESCRIPTION
 
+SSL_get_peer_certificate() is deprecated. Use SSL_get0_peer_certificate() or
+SSL_get1_peer_certificate() instead.
+
 These functions return a pointer to the X509 certificate the
 peer presented. If the peer did not present a certificate, NULL is returned.