Bring the DESCRIPTION a bit closer to reality, in particular stop

claiming that the "add" functions add anything.  Indicate that they
are mostly NOOPs nowadays, but without being overly specific.
Also, more explicitly discourage abusing OpenSSL_add_all_algorithms(3)
for loadiing a configuration file.
Guidance and OK tb@.

1 files changed, 31 insertions, 7 deletions

diff --git a/src/lib/libcrypto/man/OpenSSL_add_all_algorithms.3 b/src/lib/libcrypto/man/OpenSSL_add_all_algorithms.3
index 64f71590fe..68d8799bd4 100644
--- a/src/lib/libcrypto/man/OpenSSL_add_all_algorithms.3
+++ b/src/lib/libcrypto/man/OpenSSL_add_all_algorithms.3
@@ -1,7 +1,24 @@
-.\" $OpenBSD: OpenSSL_add_all_algorithms.3,v 1.18 2025/06/09 12:43:53 schwarze Exp $
+.\" $OpenBSD: OpenSSL_add_all_algorithms.3,v 1.19 2025/06/12 15:59:30 schwarze Exp $
 .\" full merge up to: OpenSSL b3696a55 Sep 2 09:35:50 2017 -0400
 .\"
-.\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
+.\" This file is a derived work.
+.\" The changes are covered by the following Copyright and license:
+.\"
+.\" Copyright (c) 2018, 2019, 2023, 2025 Ingo Schwarze <schwarze@openbsd.org>
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.\" The original file was written by Dr. Stephen Henson <steve@openssl.org>.
 .\" Copyright (c) 2000, 2003, 2013 The OpenSSL Project.  All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -48,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 9 2025 $
+.Dd $Mdocdate: June 12 2025 $
 .Dt OPENSSL_ADD_ALL_ALGORITHMS 3
 .Os
 .Sh NAME
@@ -80,6 +97,8 @@
 These functions are deprecated.
 It is never useful for any application program
 to call any of them explicitly.
+Most of them have no effect except that they may or may not call
+.Xr OPENSSL_init_crypto 3 .
 .Pp
 The library contains internal tables of digest algorithms and ciphers.
 It uses these tables to look up digests and ciphers via
@@ -91,7 +110,7 @@ In LibreSSL, these tables are static constants and do not require
 initialization.
 .Pp
 .Fn OpenSSL_add_all_algorithms
-adds all algorithms to the table (digests and ciphers).
+used to add all digests and ciphers to the tables.
 If an application is compiled with the preprocessor symbol
 .Dv OPENSSL_LOAD_CONF
 defined, it also calls
@@ -99,13 +118,18 @@ defined, it also calls
 with a
 .Dv NULL
 argument, loading the default configuration file.
+Relying on this behaviour is not recommended.
+If loading a configuration file is desired, call
+.Xr OPENSSL_config 3
+or
+.Xr CONF_modules_load_file 3
+directly.
 .Pp
 .Fn OpenSSL_add_all_digests
-adds all digest algorithms to the table.
+used to add all digest algorithms to the table.
 .Pp
 .Fn OpenSSL_add_all_ciphers
-adds all encryption algorithms to the table including password based
-encryption algorithms.
+used to add all encryption algorithms to the table.
 .Pp
 .Fn EVP_cleanup
 has no effect; it used to remove various kinds of application-supplied