diff options
author | Bartosz Kosiorek <bartosz.kosiorek@tomtom.com> | 2019-03-26 15:13:41 (GMT) |
---|---|---|
committer | Bartosz Kosiorek <bartosz.kosiorek@tomtom.com> | 2019-03-27 15:01:20 (GMT) |
commit | 07f3082d3b52f1bcba8dd4ef82b3e02c362b392e (patch) | |
tree | 36eb4256e37351a30273b3852c2d799c0e2e2e03 /Help/policy/CMP0037.rst | |
parent | db20cb2f9f2ff1d00593e0fc921184d99f58749a (diff) | |
download | CMake-07f3082d3b52f1bcba8dd4ef82b3e02c362b392e.zip CMake-07f3082d3b52f1bcba8dd4ef82b3e02c362b392e.tar.gz CMake-07f3082d3b52f1bcba8dd4ef82b3e02c362b392e.tar.bz2 |
Help: Improve documentation links and formatting
Diffstat (limited to 'Help/policy/CMP0037.rst')
-rw-r--r-- | Help/policy/CMP0037.rst | 20 |
1 files changed, 10 insertions, 10 deletions
diff --git a/Help/policy/CMP0037.rst b/Help/policy/CMP0037.rst index d1afeb7..c028b41 100644 --- a/Help/policy/CMP0037.rst +++ b/Help/policy/CMP0037.rst @@ -11,23 +11,23 @@ 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 -targets and IMPORTED targets may contain two consecutive colons. +targets 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". +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). +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 +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 +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 cmake_policy command to set it to OLD or NEW explicitly. +|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 |