Updated Windows documentation.

This notes that Developer Mode is required for non-admin symlinks,
removes reference to the close JIRA epic, and adds information on how
to build with Ninja on Windows.

Review: https://reviews.apache.org/r/65957


Project: http://git-wip-us.apache.org/repos/asf/mesos/repo
Commit: http://git-wip-us.apache.org/repos/asf/mesos/commit/9036951b
Tree: http://git-wip-us.apache.org/repos/asf/mesos/tree/9036951b
Diff: http://git-wip-us.apache.org/repos/asf/mesos/diff/9036951b

Branch: refs/heads/master
Commit: 9036951b33e131991c9837c4fc5f8379c5edf676
Parents: e94922f
Author: Andrew Schwartzmeyer <and...@schwartzmeyer.com>
Authored: Wed Mar 7 11:17:30 2018 -0800
Committer: Andrew Schwartzmeyer <and...@schwartzmeyer.com>
Committed: Wed Mar 7 16:25:20 2018 -0800

----------------------------------------------------------------------
 docs/windows.md | 35 +++++++++++++++++++++++++++++------
 1 file changed, 29 insertions(+), 6 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/mesos/blob/9036951b/docs/windows.md
----------------------------------------------------------------------
diff --git a/docs/windows.md b/docs/windows.md
index cf2c7c2..046c569 100644
--- a/docs/windows.md
+++ b/docs/windows.md
@@ -14,7 +14,7 @@ Mesos 1.0.0 introduced experimental support for Windows.
 ### System Requirements
 
 1. Install the latest [Visual Studio 
2017](https://www.visualstudio.com/downloads/):
-   The "Community" edition is sufficient (and free).
+   The "Community" edition is sufficient (and free of charge).
    During installation, choose the "Desktop development with C++" workload.
 
 2. Install [CMake 3.8.0](https://cmake.org/download/) or later.
@@ -62,7 +62,7 @@ Following are the instructions for Windows 10.
 
 The current implementation is known to have the following limitations:
 
-* Only the agent should be run on Windows.  The Mesos master can be
+* Only the agent should be run on Windows. The Mesos master can be
   launched, but only for testing as the master does not support
   high-availability setups on Windows.
 
@@ -74,15 +74,38 @@ The current implementation is known to have the following 
limitations:
   It is likely that this will increase, due to evolving Windows container
   support and developer features which ease porting.
 
+* The ability to [create symlinks][] as a non-admin user requires
+  Developer Mode to be enabled. Otherwise the agent will need to be
+  run under an administrator.
+
 [server]: 
https://docs.microsoft.com/en-us/windows-server/get-started/get-started-with-1709
+[create symlinks]: 
https://blogs.windows.com/buildingapps/2016/12/02/symlinks-windows-10/
 
 
-## Status
+## Build Configuration Examples
 
-For more information regarding the status of Windows support in Mesos,
-please refer to the [JIRA 
epic](https://issues.apache.org/jira/browse/MESOS-3094).
+### Building with Ninja
+
+Instead of using MSBuild, it is also possible to build Mesos on
+Windows using [Ninja](https://ninja-build.org/), which can result in
+significantly faster builds. To use Ninja, you need to download it and
+ensure `ninja.exe` is in your `PATH`.
+
+* Download the [Windows binary](https://github.com/ninja-build/ninja/releases).
+* Unzip it and place `ninja.exe` in your `PATH`.
+* Open an "x64 Native Tools Command Prompt for VS 2017" to set your
+  environment.
+* In that command prompt, type `powershell` to use a better shell.
+* Similar to above, configure CMake with
+  `cmake .. -G Ninja -DENABLE_LIBEVENT=1`.
+* Now you can use `ninja` to build the various targets.
+* You may want to use `ninja -v` to make it verbose, as it's otherwise
+  very quiet.
+
+Note that with Ninja it is imperative to open the correct developer
+command prompt so that the 64-bit build tools are used, as Ninja does
+not otherwise know how to find them.
 
-## Build Configuration Examples
 
 ### Building with Java
 

Reply via email to