Further improve the documentation of library initialization and configuration.

Among other improvements:
* Use a uniform wording at the top of the DECSRIPTION for obsolete pages.
* Better explain how to use a non-standard configuration file.
* Remove obsolete functions from SEE ALSO.
Triggered by some suggestions from tb@.
Tweaks and OK tb@.

1 files changed, 8 insertions, 4 deletions

diff --git a/src/lib/libcrypto/man/OPENSSL_load_builtin_modules.3 b/src/lib/libcrypto/man/OPENSSL_load_builtin_modules.3
index fd9e656bce..bcfb363ca4 100644
--- a/src/lib/libcrypto/man/OPENSSL_load_builtin_modules.3
+++ b/src/lib/libcrypto/man/OPENSSL_load_builtin_modules.3
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: OPENSSL_load_builtin_modules.3,v 1.5 2018/03/22 21:08:22 schwarze Exp $
+.\"     $OpenBSD: OPENSSL_load_builtin_modules.3,v 1.6 2019/06/14 13:41:31 schwarze Exp $
 .\"     OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
 .\"
 .\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
@@ -48,7 +48,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: March 22 2018 $
+.Dd $Mdocdate: June 14 2019 $
 .Dt OPENSSL_LOAD_BUILTIN_MODULES 3
 .Os
 .Sh NAME
@@ -83,19 +83,23 @@ is called then
 .Fn OPENSSL_load_builtin_modules
 is called automatically.
 .Pp
-Applications which use the configuration functions directly will need to
-call
+Applications which use configuration functions like
+.Xr CONF_modules_load_file 3
+directly need to call
 .Fn OPENSSL_load_builtin_modules
 themselves
 .Em before
 any other configuration code.
 .Pp
 Applications should call
+.Xr OPENSSL_config 3
+or
 .Fn OPENSSL_load_builtin_modules
 to load all configuration modules instead of adding modules selectively:
 otherwise functionality may be missing from the application when
 new modules are added.
 .Sh SEE ALSO
+.Xr CONF_modules_load_file 3 ,
 .Xr OPENSSL_config 3
 .Sh HISTORY
 These functions first appeared in OpenSSL 0.9.7