Revert "Update to 7.44.0"
[platform/upstream/curl.git] / winbuild / BUILD.WINDOWS.txt
index 7d68110..7d6b364 100644 (file)
@@ -1,19 +1,25 @@
 Building with Visual C++, prerequises\r
 =====================================\r
+\r
    This document describes how to compile, build and install curl and libcurl\r
    from sources using the Visual C++ build tool. To build with VC++, you will\r
    of course have to first install VC++. The minimum required version of\r
-   VC is 6 (part of Visual Studio 6). However using a more recent version like\r
-   2008 (vc9) is strongly recommended.\r
+   VC is 6 (part of Visual Studio 6). However using a more recent version is\r
+   strongly recommended.\r
 \r
    VC++ is also part of the Windows Platform SDK. You do not have to install\r
    the full Visual Studio or Visual C++ if all you want is to build curl.\r
 \r
-   The Platform SDK can be fetched here, freely:\r
+   The latest Platform SDK can be downloaded freely from:\r
 \r
     http://msdn.microsoft.com/en-us/windows/bb980924\r
 \r
-   If you wish to support zlib, openssl, ssh2, you will have to download\r
+   If you are building with VC6 then you will also need the February 2003\r
+   Edition of the Platform SDK which can be downloaded from:\r
+\r
+    http://www.microsoft.com/en-us/download/details.aspx?id=12261\r
+\r
+   If you wish to support zlib, openssl, c-ares, ssh2, you will have to download\r
    them separately and copy them to the deps directory as shown below:\r
    \r
    somedirectory\\r
@@ -45,24 +51,28 @@ Once you are in the console, go to the winbuild directory in the Curl
 sources:\r
     cd curl-src\winbuild\r
 \r
-Then you can call nmake /f makefile with the desired options (see below).\r
+Then you can call nmake /f Makefile.vc with the desired options (see below).\r
 The builds will be in the top src directory, builds\ directory, in \r
 a directory named using the options given to the nmake call.\r
 \r
-nmake /f makefile.vc mode=<static or dll> <options>\r
+nmake /f Makefile.vc mode=<static or dll> <options>\r
+\r
 where <options> is one or many of:\r
-  VC=<6,7,8,9,10>              - VC versions\r
+  VC=<6,7,8,9,10,11,12>        - VC versions\r
   WITH_DEVEL=<path>            - Paths for the development files (SSL, zlib, etc.)\r
-                                 Default to sibbling directory deps: ../deps\r
-                                 Libraries can be fetched at http://pecl2.php.net/downloads/php-windows-builds/\r
+                                 Defaults to sibbling directory deps: ../deps\r
+                                 Libraries can be fetched at http://windows.php.net/downloads/php-sdk/deps/\r
                                  Uncompress them into the deps folder.\r
   WITH_SSL=<dll or static>     - Enable OpenSSL support, DLL or static\r
-  WITH_ZLIB=<dll or static>    - Enable ZLib support, DLL or static\r
-  WITH_SSH2=<dll or static>    - Enable LIbSSH2 support, DLL or static\r
-  USE_SSSPI=<yes or no>        - Enable SSPI support, default to yes\r
-  USE_IPV6=<yes or no>         - Enable IPV6, default to yes\r
+  WITH_CARES=<dll or static>   - Enable c-ares support, DLL or static\r
+  WITH_ZLIB=<dll or static>    - Enable zlib support, DLL or static\r
+  WITH_SSH2=<dll or static>    - Enable libSSH2 support, DLL or static\r
+  ENABLE_SSPI=<yes or no>      - Enable SSPI support, defaults to yes\r
+  ENABLE_IPV6=<yes or no>      - Enable IPv6, defaults to yes\r
+  ENABLE_IDN=<yes or no>       - Enable use of Windows IDN APIs, defaults to yes\r
+                                 Requires Windows Vista or later, or installation from:\r
+                                 http://www.microsoft.com/downloads/details.aspx?FamilyID=AD6158D7-DDBA-416A-9109-07607425A815\r
+  ENABLE_WINSSL=<yes or no>    - Enable native Windows SSL support, defaults to yes\r
+  GEN_PDB=<yes or no>          - Generate Program Database (debug symbols for release build)\r
   DEBUG=<yes or no>            - Debug builds\r
-  USE_IDN=<yes or no>          - Wheter or not to use IDN Windows APIs. Requires Windows Vista or later.\r
-                                 or to install http://www.microsoft.com/downloads/details.aspx?FamilyID=AD6158D7-DDBA-416A-9109-07607425A815\r
-  GEN_PDB=<yes or no>          - Generate Program Database (debug symbols release build)\r
-\r
+  MACHINE=<x86 or x64>         - Target architecture (default is x86)\r