summaryrefslogtreecommitdiffstats
path: root/Help/variable/CMAKE_VS_PLATFORM_TOOLSET_VERSION.rst
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2021-03-12 13:01:54 (GMT)
committerBrad King <brad.king@kitware.com>2021-03-12 13:36:45 (GMT)
commit30c835428fffbf91191ebb1150d7fec00803523c (patch)
tree7ef8665102eaae79f7a8a67850f387caa27bf515 /Help/variable/CMAKE_VS_PLATFORM_TOOLSET_VERSION.rst
parent58a50a3a0aa814c0fb00720cb8fc9edb2cf72344 (diff)
downloadCMake-30c835428fffbf91191ebb1150d7fec00803523c.zip
CMake-30c835428fffbf91191ebb1150d7fec00803523c.tar.gz
CMake-30c835428fffbf91191ebb1150d7fec00803523c.tar.bz2
VS: Accept and translate '-T version=' values with three components
The VS 16.8 and VS 16.9 toolset versions differ only in their third component. The `vcvarsall` option `-vcvars_ver=` accepts a three component version, so accept this format for VS toolset selection too. Issue: #21922
Diffstat (limited to 'Help/variable/CMAKE_VS_PLATFORM_TOOLSET_VERSION.rst')
-rw-r--r--Help/variable/CMAKE_VS_PLATFORM_TOOLSET_VERSION.rst12
1 files changed, 12 insertions, 0 deletions
diff --git a/Help/variable/CMAKE_VS_PLATFORM_TOOLSET_VERSION.rst b/Help/variable/CMAKE_VS_PLATFORM_TOOLSET_VERSION.rst
index b058278..c4369ee 100644
--- a/Help/variable/CMAKE_VS_PLATFORM_TOOLSET_VERSION.rst
+++ b/Help/variable/CMAKE_VS_PLATFORM_TOOLSET_VERSION.rst
@@ -19,3 +19,15 @@ its ``Microsoft.VCToolsVersion.*.props`` file names.
VS 16.9's toolset may also be specified as ``14.28.16.9`` because
VS 16.10 uses the file name ``Microsoft.VCToolsVersion.14.28.16.9.props``.
+
+Three-Component MSVC Toolset Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. versionadded:: 3.19.7
+
+The ``version=`` field may be given a three-component toolset version
+such as ``14.28.29910``, and CMake will convert it to the name used by
+MSBuild ``Microsoft.VCToolsVersion.*.props`` files. This is useful
+to distinguish between VS 16.8's ``14.28.29333`` toolset and VS 16.9's
+``14.28.29910`` toolset. It also matches ``vcvarsall``'s ``-vcvars_ver=``
+behavior.