1CMAKE_VS_PLATFORM_TOOLSET_VERSION
2---------------------------------
3
4.. versionadded:: 3.12
5
6Visual Studio Platform Toolset version.
7
8The :ref:`Visual Studio Generators` for VS 2017 and above allow to
9select minor versions of the same toolset. The toolset version number
10may be specified by a field in :variable:`CMAKE_GENERATOR_TOOLSET` of
11the form ``version=14.11``. If none is specified CMake will choose a default
12toolset. The value may be empty if no minor version was selected and the
13default is used.
14
15If the value is not empty, it is the version number that MSBuild uses in
16its ``Microsoft.VCToolsVersion.*.props`` file names.
17
18.. versionadded:: 3.19.7
19
20   VS 16.9's toolset may also be specified as ``14.28.16.9`` because
21   VS 16.10 uses the file name ``Microsoft.VCToolsVersion.14.28.16.9.props``.
22
23Three-Component MSVC Toolset Versions
24^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
25
26.. versionadded:: 3.19.7
27
28The ``version=`` field may be given a three-component toolset version
29such as ``14.28.29910``, and CMake will convert it to the name used by
30MSBuild ``Microsoft.VCToolsVersion.*.props`` files.  This is useful
31to distinguish between VS 16.8's ``14.28.29333`` toolset and VS 16.9's
32``14.28.29910`` toolset.  It also matches ``vcvarsall``'s ``-vcvars_ver=``
33behavior.
34