summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2017-07-11 11:37:13 (GMT)
committerKitware Robot <kwrobot@kitware.com>2017-07-11 11:37:42 (GMT)
commit970569a941a3259f5303a5090ed7bca7bb6e6d7e (patch)
tree51992b7663d4ba195e80301adb56127b13b61c13 /Help
parenta49b235db9036d5ec8c8535d2074c136eeb13254 (diff)
parent2644e4c9fcc747d750d6a522d2b4029b172902c3 (diff)
downloadCMake-970569a941a3259f5303a5090ed7bca7bb6e6d7e.zip
CMake-970569a941a3259f5303a5090ed7bca7bb6e6d7e.tar.gz
CMake-970569a941a3259f5303a5090ed7bca7bb6e6d7e.tar.bz2
Merge topic 'vs-2017-choose-via-environment'
2644e4c9 VS: Choose VS 2017 instance via environment variable Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1030
Diffstat (limited to 'Help')
-rw-r--r--Help/generator/Visual Studio 15 2017.rst12
1 files changed, 12 insertions, 0 deletions
diff --git a/Help/generator/Visual Studio 15 2017.rst b/Help/generator/Visual Studio 15 2017.rst
index a88f8bc..2ac0449 100644
--- a/Help/generator/Visual Studio 15 2017.rst
+++ b/Help/generator/Visual Studio 15 2017.rst
@@ -15,6 +15,18 @@ a target platform name optionally at the end of this generator name:
``Visual Studio 15 2017 ARM``
Specify target platform ``ARM``.
+Instance Selection
+^^^^^^^^^^^^^^^^^^
+
+VS 2017 supports multiple installations on the same machine.
+CMake queries the Visual Studio Installer to locate VS instances.
+If more than one instance is installed we do not define which one
+is chosen by default. If the ``VS150COMNTOOLS`` environment variable
+is set and points to the ``Common7/Tools`` directory within one of
+the instances, that instance will be used. The environment variable
+must remain consistently set whenever CMake is re-run within a given
+build tree.
+
Toolset Selection
^^^^^^^^^^^^^^^^^