Merge topic 'doc-CMP0149' into release-3.28 fe0d03b044 Help: Document that CMP0149 should be set before project() Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8990
diff --git a/Help/policy/CMP0149.rst b/Help/policy/CMP0149.rst index 714eeaf..a84149f 100644 --- a/Help/policy/CMP0149.rst +++ b/Help/policy/CMP0149.rst
@@ -35,6 +35,13 @@ build scripts that have not been ported away from using :variable:`CMAKE_SYSTEM_VERSION` to specify an exact SDK version. +.. note:: + + This policy must be set before the first :command:`project` or + :command:`enable_language` command invocation at the top of the + project. That is when :ref:`Visual Studio Generators` select a + Windows SDK. + The ``OLD`` behavior for this policy is to use the exact value of :variable:`CMAKE_SYSTEM_VERSION` if possible. The ``NEW`` behavior for this policy is to ignore it.