CPP-859 - Remove vc_build.bat scripts and update building documentation (#334)

Author: mikefero

cpp-driver/bin/README.md

@@ -17,7 +17,7 @@ __NOTE__: The build procedures only need to be performed for driver development
 ## Compatibility
 
 * Architectures: 32-bit (x86) and 64-bit (x64)
-* Compilers: GCC 4.1.2+ Clang 3.4+, and MSVC 2010/2012/2013/2015/2017
+* Compilers: GCC 4.1.2+ Clang 3.4+, and MSVC 2010/2012/2013/2015/2017/2019
 
 ## Dependencies
 
@@ -94,9 +94,9 @@ your system._
 
 ```bash
 pushd /tmp
-wget http://dist.libuv.org/dist/v1.23.0/libuv-v1.23.0.tar.gz
-tar xzf libuv-v1.23.0.tar.gz
-pushd libuv-v1.23.0
+wget http://dist.libuv.org/dist/v1.33.0/libuv-v1.33.0.tar.gz
+tar xzf libuv-v1.33.0.tar.gz
+pushd libuv-v1.33.0
 sh autogen.sh
 ./configure
 make install
@@ -136,9 +136,9 @@ brew link --force openssl
 
 ```bash
 pushd /tmp
-wget --no-check-certificate https://www.openssl.org/source/openssl-1.0.2o.tar.gz
-tar xzf openssl-1.0.2o.tar.gz
-pushd openssl-1.0.2o
+wget --no-check-certificate https://www.openssl.org/source/openssl-1.0.2s.tar.gz
+tar xzf openssl-1.0.2s.tar.gz
+pushd openssl-1.0.2s
 CFLAGS=-fpic ./config shared
 make
 make install
@@ -182,13 +182,9 @@ cmake -DCASS_BUILD_INTEGRATION_TESTS=On ..
 cmake -DCASS_BUILD_UNIT_TESTS=On ..
 ```
 
-
 ## Windows
 
-We provide a self-contained [batch script] for building the C/C++ driver and
-all of its dependencies. In order to run it, you have to install the build
-dependencies and clone the repository with the DataStax C/C++ driver for
-DataStax Enterprise.
+The driver is known to build with Visual Studio 2010, 2012, 2013, 2015, 2017, and 2019.
 
 ### Obtaining build dependencies
 
@@ -198,76 +194,57 @@ DataStax Enterprise.
 * Download and install [CMake]
   * Make sure to select the option "Add CMake to the system PATH for all users"
     or "Add CMake to the system PATH for current user"
-* Download and install [Git]
-  * Make sure to select the option "Use Git from Windows Command Prompt" or
-    manually add the git executable to the system PATH.
-* Download and install [ActiveState Perl]
+* Download and install [Strawberry Perl] or [ActiveState Perl]
   * Make sure to select the option "Add Perl to PATH environment variable"
-* Download and install [Python v2.7.x][python-27]
-  * Make sure to select/install the feature "Add python.exe to Path"
-* Download and install [Boost][Boost] (Optional: Tests only)
-  * Visual Studio 2010: [32-bit][boost-msvc-100-32-bit]/[64-bit][boost-msvc-100-64-bit]
-  * Visual Studio 2012: [32-bit][boost-msvc-110-32-bit]/[64-bit][boost-msvc-110-64-bit]
-  * Visual Studio 2013: [32-bit][boost-msvc-120-32-bit]/[64-bit][boost-msvc-120-64-bit]
-  * Visual Studio 2015: [32-bit][boost-msvc-140-32-bit]/[64-bit][boost-msvc-140-64-bit]
-  * Visual Studio 2017: [32-bit][boost-msvc-141-32-bit]/[64-bit][boost-msvc-141-64-bit]
 
 ### Building the driver
 
-The [batch script] detects installed versions of Visual Studio to simplify the
-build process on Windows and select the correct version of Visual Studio when
-compiling the driver.
-
-First you will need to open a "Command Prompt" to execute the batch script.
-Running the batch script without any arguments will build the driver for C/C++
-driver for the current system architecture (e.g. x64).
-
-To perform advanced build configuration, execute the batch script with the
-`--HELP` argument to display the options available.
-
-```dos
-Usage: VC_BUILD.BAT [OPTION...]
-
-    --DEBUG                           Enable debug build
-    --RELEASE                         Enable release build (default)
-    --DISABLE-CLEAN                   Disable clean build
-    --DEPENDENCIES-ONLY               Build dependencies only
-    --OPENSSL-VERSION                 OpenSSL version 1.0, 1.1 (default: 1.0)
-    --TARGET-COMPILER [version]       141, 140, 120, 110, or 100
-    --DISABLE-OPENSSL                 Disable OpenSSL support
-    --ENABLE-EXAMPLES                 Enable example builds
-    --ENABLE-PACKAGES [version]       Enable package generation (*)
-    --ENABLE-ZLIB                     Enable zlib
-    --GENERATE-SOLUTION               Generate Visual Studio solution (**)
-    --INSTALL-DIR [install-dir]       Override installation directory
-    --SHARED                          Build shared library (default)
-    --STATIC                          Build static library
-    --ENABLE-SHARED-OPENSSL           Force shared OpenSSL library
-    --X86                             Target 32-bit build (***)
-    --X64                             Target 64-bit build (***)
-    --USE-BOOST-ATOMIC                Use Boost atomic
-
-    Testing Arguments
-
-    --ENABLE-TESTS
-         [boost-root-dir]             Enable integration and unit tests build
-    --ENABLE-INTEGRATION-TESTS
-         [boost-root-dir]             Enable integration tests build
-    --ENABLE-UNIT-TESTS
-         [boost-root-dir]             Enable unit tests build
-    --ENABLE-LIBSSH2                  Enable libssh2 (remote server testing)
-
-    --HELP                            Display this message
-
-*   Packages are only generated using detected installations of Visual Studio
-    NOTE: OpenSSL v1.0.x is used for all package builds
-**  Dependencies are built before generation of Visual Studio solution
-*** Default target architecture is determined based on system architecture
+First you will need to open a "Command Prompt" to execute the CMake commands.
+
+#### Building the C/C++ driver
+
+Supported generators are:
+* Visual Studio 10 2010
+* Visual Studio 11 2012
+* Visual Studio 12 2013
+* Visual Studio 14 2015
+* Visual Studio 15 2017
+* Visual Studio 16 2019
+
+```bash
+mkdir build
+pushd build
+cmake -G "Visual Studio 16 2019" -A x64 ..
+cmake --build .
+popd
+```
+
+__Note__: To build 32-bit binaries/libraries use `-A Win32`.
+
+#### Building examples (optional)
+
+Examples are not built by default and need to be enabled. Update your [CMake]
+line to build examples.
+
+```bash
+cmake -G "Visual Studio 16 2019" -A x64 -DCASS_BUILD_EXAMPLES=On ..
 ```
 
-__Note__: When overriding installation directory using `--INSTALL-DIR`, the
-          driver dependencies will also be copied (e.g.
-          C:\myproject\dependencies\libs)
+#### Building tests (optional)
+
+Tests (integration and unit) are not built by default and need to be enabled.
+
+##### Integration tests
+
+```bash
+cmake -G "Visual Studio 16 2019" -A x64 -DCASS_BUILD_INTEGRATION_TESTS=On ..
+```
+
+##### Unit tests
+
+```bash
+cmake -G "Visual Studio 16 2019" -A x64 -DCASS_BUILD_UNIT_TESTS=On ..
+```
 
 [download server]: http://downloads.datastax.com
 [cpp-driver-centos6]: http://downloads.datastax.com/cpp-driver/centos/6/cassandra
@@ -281,23 +258,10 @@ __Note__: When overriding installation directory using `--INSTALL-DIR`, the
 [libuv-ubuntu14-04]: http://downloads.datastax.com/cpp-driver/ubuntu/14.04/dependencies/libuv
 [libuv-ubuntu16-04]: http://downloads.datastax.com/cpp-driver/ubuntu/16.04/dependencies/libuv
 [libuv-ubuntu18-04]: http://downloads.datastax.com/cpp-driver/ubuntu/18.04/dependencies/libuv
-[batch script]: ../../vc_build.bat
 [Homebrew]: https://brew.sh
 [Bison]: http://gnuwin32.sourceforge.net/downlinks/bison.php
 [CMake]: http://www.cmake.org/download
-[Git]: http://git-scm.com/download/win
+[Strawberry Perl]: http://strawberryperl.com
 [ActiveState Perl]: https://www.perl.org/get.html#win32
-[python-27]: https://www.python.org/downloads
 [libuv]: http://libuv.org
 [OpenSSL]: https://www.openssl.org
-[Boost]: http://www.boost.org
-[boost-msvc-100-32-bit]: http://sourceforge.net/projects/boost/files/boost-binaries/1.68.0/boost_1_68_0-msvc-10.0-32.exe/download
-[boost-msvc-100-64-bit]: http://sourceforge.net/projects/boost/files/boost-binaries/1.68.0/boost_1_68_0-msvc-10.0-64.exe/download
-[boost-msvc-110-32-bit]: http://sourceforge.net/projects/boost/files/boost-binaries/1.68.0/boost_1_68_0-msvc-11.0-32.exe/download
-[boost-msvc-110-64-bit]: http://sourceforge.net/projects/boost/files/boost-binaries/1.68.0/boost_1_68_0-msvc-11.0-64.exe/download
-[boost-msvc-120-32-bit]: http://sourceforge.net/projects/boost/files/boost-binaries/1.68.0/boost_1_68_0-msvc-12.0-32.exe/download
-[boost-msvc-120-64-bit]: http://sourceforge.net/projects/boost/files/boost-binaries/1.68.0/boost_1_68_0-msvc-12.0-64.exe/download
-[boost-msvc-140-32-bit]: http://sourceforge.net/projects/boost/files/boost-binaries/1.68.0/boost_1_68_0-msvc-14.0-32.exe/download
-[boost-msvc-140-64-bit]: http://sourceforge.net/projects/boost/files/boost-binaries/1.68.0/boost_1_68_0-msvc-14.0-64.exe/download
-[boost-msvc-141-32-bit]: http://sourceforge.net/projects/boost/files/boost-binaries/1.68.0/boost_1_68_0-msvc-14.1-32.exe/download
-[boost-msvc-141-64-bit]: http://sourceforge.net/projects/boost/files/boost-binaries/1.64.0/boost_1_64_0-msvc-14.1-64.exe/download