summaryrefslogtreecommitdiff
path: root/share/cmake-3.22/Help/policy/CMP0037.rst
diff options
context:
space:
mode:
authorRyan Prichard <rprichard@google.com>2022-01-13 17:30:17 -0800
committerRyan Prichard <rprichard@google.com>2022-01-13 17:30:31 -0800
commit7aea7e9880110799088cd1de509886871078306f (patch)
tree5cf68b7dabd868f99ec4160cf1f7237ff63e4c37 /share/cmake-3.22/Help/policy/CMP0037.rst
parentd09ee7574f3e46668b23b3b6efebd0ea75de85b2 (diff)
downloaddarwin-x86-7aea7e9880110799088cd1de509886871078306f.tar.gz
Fusion2: http://fusion2/610fb8e3-5633-41a6-b50b-ed5819f55cd6 GCS path: gs://ndk-kokoro-release-artifacts/prod/ndk/cmake/darwin_release/3/20211215-131219 Prebuilt updated using: ndk/scripts/update_kokoro_prebuilts.py Test: Treehugger, Kokoro presubmit Bug: http://b/213946898 Change-Id: Icbb6d90cad49dbe67f168075508872b1704d9f61
Diffstat (limited to 'share/cmake-3.22/Help/policy/CMP0037.rst')
-rw-r--r--share/cmake-3.22/Help/policy/CMP0037.rst34
1 files changed, 34 insertions, 0 deletions
diff --git a/share/cmake-3.22/Help/policy/CMP0037.rst b/share/cmake-3.22/Help/policy/CMP0037.rst
new file mode 100644
index 0000000..9895fb0
--- /dev/null
+++ b/share/cmake-3.22/Help/policy/CMP0037.rst
@@ -0,0 +1,34 @@
+CMP0037
+-------
+
+Target names should not be reserved and should match a validity pattern.
+
+CMake 2.8.12 and lower allowed creating targets using :command:`add_library`,
+:command:`add_executable` and :command:`add_custom_target` with unrestricted
+choice for the target name. Newer cmake features such
+as :manual:`cmake-generator-expressions(7)` and some
+diagnostics expect target names to match a restricted pattern.
+
+Target names may contain upper and lower case letters, numbers, the underscore
+character (``_``), dot(``.``), plus(``+``) and minus(``-``).
+As a special case, ``ALIAS`` and ``IMPORTED`` targets may contain
+two consecutive colons.
+
+Target names reserved by one or more CMake generators are not allowed.
+Among others these include ``all``, ``clean``, ``help``, and ``install``.
+
+Target names associated with optional features, such as ``test`` and
+``package``, may also be reserved. CMake 3.10 and below always reserve them.
+CMake 3.11 and above reserve them only when the corresponding feature is
+enabled (e.g. by including the :module:`CTest` or :module:`CPack` modules).
+
+The ``OLD`` behavior for this policy is to allow creating targets with
+reserved names or which do not match the validity pattern.
+The ``NEW`` behavior for this policy is to report an error
+if an add_* command is used with an invalid target name.
+
+This policy was introduced in CMake version 3.0. 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