summaryrefslogtreecommitdiff
path: root/share/cmake-3.22/Help/policy/CMP0021.rst
diff options
context:
space:
mode:
Diffstat (limited to 'share/cmake-3.22/Help/policy/CMP0021.rst')
-rw-r--r--share/cmake-3.22/Help/policy/CMP0021.rst21
1 files changed, 21 insertions, 0 deletions
diff --git a/share/cmake-3.22/Help/policy/CMP0021.rst b/share/cmake-3.22/Help/policy/CMP0021.rst
new file mode 100644
index 0000000..937b106
--- /dev/null
+++ b/share/cmake-3.22/Help/policy/CMP0021.rst
@@ -0,0 +1,21 @@
+CMP0021
+-------
+
+Fatal error on relative paths in :prop_tgt:`INCLUDE_DIRECTORIES` target
+property.
+
+CMake 2.8.10.2 and lower allowed the :prop_tgt:`INCLUDE_DIRECTORIES` target
+property to contain relative paths. The base path for such relative
+entries is not well defined. CMake 2.8.12 issues a ``FATAL_ERROR`` if the
+:prop_tgt:`INCLUDE_DIRECTORIES` property contains a relative path.
+
+The ``OLD`` behavior for this policy is not to warn about relative paths
+in the ``INCLUDE_DIRECTORIES`` target property. The ``NEW`` behavior for this
+policy is to issue a ``FATAL_ERROR`` if ``INCLUDE_DIRECTORIES`` contains a
+relative path.
+
+This policy was introduced in CMake version 2.8.12. 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