Configure: accept Windows style compiler options

[openssl.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index 3104801896785e4fa490c7e4cc3d0902f926f3d3..c818ed72b1710d455ada2107aa32d34f2053a7ae 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -145,7 +145,10 @@
                    Don't build with support for deprecated APIs below the
                    specified version number. For example "--api=1.1.0" will
                    remove support for all APIS that were deprecated in OpenSSL
                    Don't build with support for deprecated APIs below the
                    specified version number. For example "--api=1.1.0" will
                    remove support for all APIS that were deprecated in OpenSSL

-                   version 1.1.0 or below.
+                   version 1.1.0 or below. This is a rather specialized option
+                   for developers. If you just intend to remove all deprecated
+                   APIs entirely (up to the current version), it is easier
+                   to add the 'no-deprecated' option instead (see below).

 
   --cross-compile-prefix=PREFIX
                    The PREFIX to include in front of commands for your
 
   --cross-compile-prefix=PREFIX
                    The PREFIX to include in front of commands for your


@@ -361,6 +364,9 @@
                    Don't build support for datagram based BIOs. Selecting this
                    option will also force the disabling of DTLS.
 
                    Don't build support for datagram based BIOs. Selecting this
                    option will also force the disabling of DTLS.
 

+  no-dso
+                   Don't build support for loading Dynamic Shared Objects.
+

   enable-devcryptoeng
                    Build the /dev/crypto engine.  It is automatically selected
                    on BSD implementations, in which case it can be disabled with
   enable-devcryptoeng
                    Build the /dev/crypto engine.  It is automatically selected
                    on BSD implementations, in which case it can be disabled with


@@ -635,10 +641,19 @@
                    Take note of the VAR=value documentation below and how
                    these flags interact with those variables.
 
                    Take note of the VAR=value documentation below and how
                    these flags interact with those variables.
 

-  -xxx, +xxx
+  -xxx, +xxx, /xxx

                    Additional options that are not otherwise recognised are
                    Additional options that are not otherwise recognised are

-                   passed through as they are to the compiler as well.  Again,
-                   consult your compiler documentation.
+                   passed through as they are to the compiler as well.
+                   Unix-style options beginning with a '-' or '+' and
+                   Windows-style options beginning with a '/' are recognized.
+                   Again, consult your compiler documentation.
+
+                   If the option contains arguments separated by spaces,
+                   then the URL-style notation %20 can be used for the space
+                   character in order to avoid having to quote the option.
+                   For example, -opt%20arg gets expanded to -opt arg.
+                   In fact, any ASCII character can be encoded as %xx using its
+                   hexadecimal encoding.

 
                    Take note of the VAR=value documentation below and how
                    these flags interact with those variables.
 
                    Take note of the VAR=value documentation below and how
                    these flags interact with those variables.


@@ -908,11 +923,17 @@
      malfunction with Perl).  You may want increased verbosity, that
      can be accomplished like this:
 
      malfunction with Perl).  You may want increased verbosity, that
      can be accomplished like this:
 

-       $ make VERBOSE=1 test                            # Unix
+     Verbosity on failure only (make macro VERBOSE_FAILURE or VF):
+
+       $ make VF=1 test                                 # Unix
+       $ mms /macro=(VF=1) test                         ! OpenVMS
+       $ nmake VF=1 test                                # Windows

 
 

-       $ mms /macro=(VERBOSE=1) test                    ! OpenVMS
+     Full verbosity (make macro VERBOSE or V):

 
 

-       $ nmake VERBOSE=1 test                           # Windows
+       $ make V=1 test                                  # Unix
+       $ mms /macro=(V=1) test                          ! OpenVMS
+       $ nmake V=1 test                                 # Windows

 
      If you want to run just one or a few specific tests, you can use
      the make variable TESTS to specify them, like this:
 
      If you want to run just one or a few specific tests, you can use
      the make variable TESTS to specify them, like this:


@@ -923,7 +944,7 @@
 
      And of course, you can combine (Unix example shown):
 
 
      And of course, you can combine (Unix example shown):
 

-       $ make VERBOSE=1 TESTS='test_rsa test_dsa' test
+       $ make VF=1 TESTS='test_rsa test_dsa' test

 
      You can find the list of available tests like this:
 
 
      You can find the list of available tests like this: