Commit fa8e9c916b for openssl.org

commit fa8e9c916b9337b1d9c41037f11aa3149cff53e6
Author: Eugene Syromiatnikov <esyr@openssl.org>
Date:   Mon Aug 3 15:54:15 2026 +0200

    doc/man7/openssl_user_macros.pod.in: document OPENSSL_SUPPRESS_DEPRECATED

    Signed-off-by: Eugene Syromiatnikov <esyr@openssl.org>
    Reviewed-by: Milan Broz <mbroz@openssl.org>
    Reviewed-by: Nikola Pajkovsky <nikolap@openssl.org>
    Merge-date: Fri Oct  2 07:30:41 2026
    Merged-from: https://github.com/openssl/openssl/pull/32154

diff --git a/doc/man7/openssl_user_macros.pod.in b/doc/man7/openssl_user_macros.pod.in
index 381670300c..64804e2f20 100644
--- a/doc/man7/openssl_user_macros.pod.in
+++ b/doc/man7/openssl_user_macros.pod.in
@@ -5,7 +5,8 @@
 openssl_user_macros,
 OPENSSL_API_COMPAT,
 OPENSSL_ENGINE_STUBS,
-OPENSSL_NO_DEPRECATED
+OPENSSL_NO_DEPRECATED,
+OPENSSL_SUPPRESS_DEPRECATED
 - User defined macros

 =head1 DESCRIPTION
@@ -103,8 +104,20 @@ versions up to and including the version given by B<OPENSSL_API_COMPAT>
 (or the default value given above, when B<OPENSSL_API_COMPAT> isn't defined)
 will be hidden.

+=item B<OPENSSL_SUPPRESS_DEPRECATED>
+
+If this macro is defined, compiler warnings about usage of deprecated symbols
+are suppressed in the compilation unit.
+Consider using OSSL_BEGIN_ALLOW_DEPRECATED(3) and OSSL_END_ALLOW_DEPRECATED(3)
+for localised deprecation warning suppresion, however.
+
 =back

+=head1 SEE ALSO
+
+L<OSSL_BEGIN_ALLOW_DEPRECATED(3)>,
+L<OSSL_END_ALLOW_DEPRECATED(3)>
+
 =head1 COPYRIGHT

 Copyright 2018-2021 The OpenSSL Project Authors. All Rights Reserved.