summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2023-08-08 18:20:43 (GMT)
committerBrad King <brad.king@kitware.com>2023-08-10 13:57:00 (GMT)
commitae97d82e830c6ddc81808e3f44dad8a47a30bcae (patch)
tree6eb5216786d3167c8ad111d3f0a71cd4b104716b /Help
parent15ff89654b925b74f074ef7e13ed905c3ec38c4b (diff)
downloadCMake-ae97d82e830c6ddc81808e3f44dad8a47a30bcae.zip
CMake-ae97d82e830c6ddc81808e3f44dad8a47a30bcae.tar.gz
CMake-ae97d82e830c6ddc81808e3f44dad8a47a30bcae.tar.bz2
VS: Teach CMAKE_GENERATOR_PLATFORM to support Windows 8.1 SDK selection
Honor an explicit `version=8.1` field value regardless of the Windows target version. Issue: #25170
Diffstat (limited to 'Help')
-rw-r--r--Help/release/3.27.rst8
-rw-r--r--Help/variable/CMAKE_GENERATOR_PLATFORM.rst4
2 files changed, 12 insertions, 0 deletions
diff --git a/Help/release/3.27.rst b/Help/release/3.27.rst
index a8218ba..9b9db83 100644
--- a/Help/release/3.27.rst
+++ b/Help/release/3.27.rst
@@ -271,3 +271,11 @@ Changes made since CMake 3.27.0 include the following.
* This version made no changes to documented features or interfaces.
Some implementation updates were made to support ecosystem changes
and/or fix regressions.
+
+3.27.2
+------
+
+* :ref:`Visual Studio Generators` for VS 14 (2015) and above now support
+ using ``version=8.1`` in the :variable:`CMAKE_GENERATOR_PLATFORM` variable
+ to select the Windows 8.1 SDK. In CMake 3.27.[0-1] the ``version=`` field
+ was limited to selecting Windows 10 SDKs.
diff --git a/Help/variable/CMAKE_GENERATOR_PLATFORM.rst b/Help/variable/CMAKE_GENERATOR_PLATFORM.rst
index 7fbf6ba..22bf655 100644
--- a/Help/variable/CMAKE_GENERATOR_PLATFORM.rst
+++ b/Help/variable/CMAKE_GENERATOR_PLATFORM.rst
@@ -66,6 +66,10 @@ Supported pairs are:
the value of :variable:`CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM`,
if that variable is set.
+ ``8.1``
+ Specify the 8.1 SDK version. This is always supported by VS 2015.
+ On VS 2017 and above the 8.1 SDK must be installed.
+
If the ``version`` field is not specified, CMake selects a version as
described in the :variable:`CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION`
variable documentation.