Merge pull request #7248 from apple/hughbe-patch-1

Add documentation for generating a Visual Studio project on Windows

Author: hughbe

docs/Windows.md

@@ -136,6 +136,13 @@ popd
 cmake --build "%swift_source_dir%/build/Ninja-DebugAssert/swift-windows-amd64/ninja"
 ```
 
+- To create a VisualStudio project, you'll need to change the generator and, if you have a 64 bit processor, specify the generator platform. Note that you may get multiple build errors compiling the `swift` project due to an MSBuild limitation that file paths cannot exceed 260 characters. These can be ignored, as they occur after the build, writing the last build status to a file.
+```
+cmake -G "Visual Studio 14" "%swift_source_dir%/swift"^
+ -DCMAKE_GENERATOR_PLATFORM="x64"^
+ ...
+```
+
 ## Clang-cl
 
 Follow the instructions for MSVC, but add the following lines to each CMake configuration command. We need to use LLVM's `lld-link.exe` linker, as MSVC's `link.exe` crashes due to corrupt PDB files using `clang-cl`. `Clang-cl` 3.9.0 has been tested.
@@ -146,7 +153,6 @@ Follow the instructions for MSVC, but add the following lines to each CMake conf
  -DCMAKE_LINKER="<path-to-llvm-bin>/lld-link.exe"^
 ```
 
-
 ## Windows Subsystem for Linux (WSL)
 - Note that all compiled Swift binaries are only executable within Bash on Windows and are Ubuntu, not Windows, executables.
 - Make sure to run all commands from Bash, or the project won't compile.