INSTALL: Add a note about backward compatibility and "make variables"

Reviewed-by: Andy Polyakov <appro@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/5641)

diff --git a/INSTALL b/INSTALL
index 08758339a2b5c987ba26b2f7bb8151b7e8cc135d..e99b1f00b8e4b72c3e350f07582bb5a41b58b098 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -536,7 +536,7 @@
                    these flags interact with those variables.
 
   VAR=value
-                   Assignment if environment variable for Configure.  These
+                   Assignment of environment variable for Configure.  These
                    work just like normal environment variable assignments,
                    but are supported on all platforms and are confined to
                    the configuration scripts only.  These assignments override
@@ -587,6 +587,24 @@
 
                        ./config -DFOO CPPFLAGS=-DBAR -DCOOKIE
 
+                   Backward compatibility note:
+
+                   To be compatible with older configuration scripts, the
+                   environment variables are ignored if compiling / linking
+                   flags are given on the command line, except for these:
+
+                   AR, CC, CXX, CROSS_COMPILE, HASHBANGPERL, PERL, RANLIB, RC
+                   and WINDRES
+
+                   For example, the following command will not see -DBAR:
+
+                        CPPFLAGS=-DBAR ./config -DCOOKIE
+
+                   However, the following will see both set variables:
+
+                        CC=gcc CROSS_COMPILE=x86_64-w64-mingw32- \
+                        ./config -DCOOKIE
+
   reconf
   reconfigure
                    Reconfigure from earlier data.  This fetches the previous