summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2020-08-25 14:30:06 (GMT)
committerKitware Robot <kwrobot@kitware.com>2020-08-25 14:30:14 (GMT)
commit0b0dc86eab8bbb2b6e1343a89eb4d147714aea19 (patch)
tree475c69caf4dcdc48329232cab5627226b20d47ac /Help
parenta65f95bb654a3d16a62d7dba39a01fafa9cf46f2 (diff)
parent359c500a2466ffc2507b81c0089bce18fd5debbb (diff)
downloadCMake-0b0dc86eab8bbb2b6e1343a89eb4d147714aea19.zip
CMake-0b0dc86eab8bbb2b6e1343a89eb4d147714aea19.tar.gz
CMake-0b0dc86eab8bbb2b6e1343a89eb4d147714aea19.tar.bz2
Merge topic 'unk_imported_location'
359c500a24 cmTarget: Raise error if imported target location is not set Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5113
Diffstat (limited to 'Help')
-rw-r--r--Help/manual/cmake-policies.7.rst1
-rw-r--r--Help/policy/CMP0111.rst20
-rw-r--r--Help/release/dev/imported-target-location-required.rst5
3 files changed, 26 insertions, 0 deletions
diff --git a/Help/manual/cmake-policies.7.rst b/Help/manual/cmake-policies.7.rst
index 2627e0c..ce8969b 100644
--- a/Help/manual/cmake-policies.7.rst
+++ b/Help/manual/cmake-policies.7.rst
@@ -57,6 +57,7 @@ Policies Introduced by CMake 3.19
.. toctree::
:maxdepth: 1
+ CMP0111: An imported target with a missing location fails during generation. </policy/CMP0111>
CMP0110: add_test() supports arbitrary characters in test names. </policy/CMP0110>
CMP0109: find_program() requires permission to execute but not to read. </policy/CMP0109>
diff --git a/Help/policy/CMP0111.rst b/Help/policy/CMP0111.rst
new file mode 100644
index 0000000..37e5ad5
--- /dev/null
+++ b/Help/policy/CMP0111.rst
@@ -0,0 +1,20 @@
+CMP0111
+-------
+
+.. versionadded:: 3.19
+
+An imported target with a missing location fails during generation.
+
+Prior to this the location would be generated as ``<TARGET_NAME>-NOTFOUND``,
+which would result in build failures.
+
+The ``OLD`` behavior of this policy is to generate the location of an imported
+unknown, static or shared library target as ``<TARGET_NAME>-NOTFOUND`` if not
+set.
+The ``NEW`` behavior is to raise an error.
+
+This policy was introduced in CMake version 3.19. CMake version |release|
+warns when the policy is not set and uses ``OLD`` behavior. Use the
+:command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
+
+.. include:: DEPRECATED.txt
diff --git a/Help/release/dev/imported-target-location-required.rst b/Help/release/dev/imported-target-location-required.rst
new file mode 100644
index 0000000..3625242
--- /dev/null
+++ b/Help/release/dev/imported-target-location-required.rst
@@ -0,0 +1,5 @@
+imported-target-location-required
+---------------------------------
+
+* An imported target with a missing location now fails during generation if the
+ location is used. See policy :policy:`CMP0111`.