Browse Source

Merge topic 'doc-CMP0149'

fe0d03b044 Help: Document that CMP0149 should be set before project()

Acked-by: Kitware Robot <[email protected]>
Merge-request: !8990
Brad King 2 years ago
parent
commit
c184bd2d48
1 changed files with 7 additions and 0 deletions
  1. 7 0
      Help/policy/CMP0149.rst

+ 7 - 0
Help/policy/CMP0149.rst

@@ -35,6 +35,13 @@ This policy provides compatibility for projects, toolchain files, and
 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.