Utilities/Release: Add docker specs to build and test Windows binaries

These will allow anyone to produce portable binaries like those
published on `cmake.org`.

Follow the pattern from commit facc240a45 (Utilities/Release: Add docker
specs to build and test Linux binaries, 2019-08-23, v3.16.0-rc1~184^2~2).
Parameterize the architecture to support both `x86_64` and `i386`.

1 files changed, 10 insertions, 2 deletions

diff --git a/Utilities/Release/README.rst b/Utilities/Release/README.rst
index 2a723c9b19..9993afab4d 100644
--- a/Utilities/Release/README.rst
+++ b/Utilities/Release/README.rst
@@ -13,6 +13,7 @@ The ``<os>/<arch>/`` directories contain Docker specifications that anyone
 may use to produce binaries for CMake on the following platforms:
 
 * ``linux/x86_64/``: Linux on ``x86_64`` architectures.
+* ``win/x86/``: Windows on ``x86_64`` and ``i386`` architectures.
 
 Each ``<os>/<arch>/`` directory contains the following:
 
@@ -29,8 +30,8 @@ Each ``<os>/<arch>/`` directory contains the following:
 * ``<os>/<arch>/Dockerfile``:
   Produce an image containing a portable CMake binary package.
   Build this image using the CMake source directory as the build context.
-  The resulting image will have an ``/out`` directory containing the package.
-  For example, on Linux ``x86_64``:
+  The resulting image will have an ``/out`` (or ``c:/out``) directory
+  containing the package.  For example, on Linux ``x86_64``:
 
   .. code-block:: console
 
@@ -40,6 +41,9 @@ Each ``<os>/<arch>/`` directory contains the following:
     $ docker cp cmake-build:/out .
     $ ls out/cmake-*-Linux-x86_64.*
 
+  On Windows, the ``win/x86`` specifications support both the ``x86_64``
+  and ``i386`` architectures selected via ``--build-arg ARCH=...``.
+
 * ``<os>/<arch>/test/Dockerfile``:
   Produces a base image with a test environment for packaged CMake binaries.
   For example, on Linux ``x86_64``, one may build the test base image:
@@ -65,6 +69,10 @@ Each ``<os>/<arch>/`` directory contains the following:
     $ docker run --network none cmake:test bash test-make.bash
     $ docker run --network none cmake:test bash test-ninja.bash
 
+  On Windows, the test scripts are called ``test-nmake.bat`` and
+  ``test-ninja.bat``.  In the ``x86`` architecture they accept one
+  argument specifying either ``x86_64`` or ``i386``.
+
 .. _`kitware/cmake Docker Hub Repository`: https://hub.docker.com/r/kitware/cmake
 
 Scripts for Kitware