Document the use of configdata.pm as a script

Reviewed-by: Rich Salz <rsalz@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/5185)

diff --git a/CHANGES b/CHANGES
index b3aa7416f4d063d72a47818b6bfd82d74cf48f42..f0807c6405f22a0b7a17c8eeae64cd92918f4b39 100644 (file)
--- a/CHANGES
+++ b/CHANGES
@@ -9,6 +9,11 @@
 
  Changes between 1.1.0f and 1.1.1 [xx XXX xxxx]
 
 
  Changes between 1.1.0f and 1.1.1 [xx XXX xxxx]
 

+  *) Changed Configure so it only says what it does and doesn't dump
+     so much data.  Instead, ./configdata.pm should be used as a script
+     to display all sorts of configuration data.
+     [Richard Levitte]
+

   *) Added processing of "make variables" to Configure.
      [Richard Levitte]
 
   *) Added processing of "make variables" to Configure.
      [Richard Levitte]
 

diff --git a/INSTALL b/INSTALL
index 006f72d1d2145d59c217cf37fdcb384b39c71347..f8702e44a36607201454aa781f0e08f93e3ded3d 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -625,6 +625,22 @@
                    precedence over environment variables that are defined
                    when reconfiguring.
 
                    precedence over environment variables that are defined
                    when reconfiguring.
 

+ Displaying configuration data
+ -----------------------------
+
+ The configuration script itself will say very little, and finishes by
+ creating "configdata.pm".  This perl module can be loaded by other scripts
+ to find all the configuration data, and it can also be used as a script to
+ display all sorts of configuration data in a human readable form.
+
+ For more information, please do:
+
+       $ ./configdata.pm --help                         # Unix
+
+       or
+
+       $ perl configdata.pm --help                      # Windows and VMS
+

  Installation in Detail
  ----------------------
 
  Installation in Detail
  ----------------------
 

diff --git a/NEWS b/NEWS
index 038a67317dbc6b548b0a1744ad483b637d13b837..0fb5314d80c88c7ac60a379d71fecfd12e5ffee5 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -7,6 +7,7 @@
 
   Major changes between OpenSSL 1.1.0f and OpenSSL 1.1.1 [under development]
 
 
   Major changes between OpenSSL 1.1.0f and OpenSSL 1.1.1 [under development]
 

+      o Move the display of configuration data to configdata.pm.

       o Allow GNU style "make variables" to be used with Configure.
       o Add a STORE module (OSSL_STORE)
       o Claim the namespaces OSSL and OPENSSL, represented as symbol prefixes
       o Allow GNU style "make variables" to be used with Configure.
       o Add a STORE module (OSSL_STORE)
       o Claim the namespaces OSSL and OPENSSL, represented as symbol prefixes

diff --git a/README b/README
index b6dfda72bb7a3bd28e17a790bb8bf17eabf51665..fb0334b7c62ad11e87e674b1485823969a49b1a4 100644 (file)
--- a/README
+++ b/README
@@ -68,8 +68,7 @@
  and create an issue on GitHub:
 
     - OpenSSL version: output of 'openssl version -a'
  and create an issue on GitHub:
 
     - OpenSSL version: output of 'openssl version -a'

-    - Any "Configure" options that you selected during compilation of the
-      library if applicable (see INSTALL)
+    - Configuration data: output of 'perl configdata.pm --dump'

     - OS Name, Version, Hardware platform
     - Compiler Details (name, version)
     - Application Details (name, version)
     - OS Name, Version, Hardware platform
     - Compiler Details (name, version)
     - Application Details (name, version)