diff options
| author | Stephen Kelly <steveire@gmail.com> | 2015-05-14 17:08:27 (GMT) |
|---|---|---|
| committer | Stephen Kelly <steveire@gmail.com> | 2015-05-14 19:38:29 (GMT) |
| commit | b85d3b66c63afa1ce7f30439deee524241b1efdc (patch) | |
| tree | 3fc468657faa5c66183b70ba54f4962dcba6a19e /Help | |
| parent | 501c237a83001a8783b2249bd5f5066c3472a2aa (diff) | |
| download | CMake-b85d3b66c63afa1ce7f30439deee524241b1efdc.zip CMake-b85d3b66c63afa1ce7f30439deee524241b1efdc.tar.gz CMake-b85d3b66c63afa1ce7f30439deee524241b1efdc.tar.bz2 | |
install: Disallow installing export() result.
Diffstat (limited to 'Help')
| -rw-r--r-- | Help/manual/cmake-policies.7.rst | 1 | ||||
| -rw-r--r-- | Help/policy/CMP0062.rst | 27 | ||||
| -rw-r--r-- | Help/release/dev/disallow-install-of-export.rst | 5 |
3 files changed, 33 insertions, 0 deletions
diff --git a/Help/manual/cmake-policies.7.rst b/Help/manual/cmake-policies.7.rst index e59cce7..2cc3a47 100644 --- a/Help/manual/cmake-policies.7.rst +++ b/Help/manual/cmake-policies.7.rst @@ -119,3 +119,4 @@ All Policies /policy/CMP0059 /policy/CMP0060 /policy/CMP0061 + /policy/CMP0062 diff --git a/Help/policy/CMP0062.rst b/Help/policy/CMP0062.rst new file mode 100644 index 0000000..e2f5a5a --- /dev/null +++ b/Help/policy/CMP0062.rst @@ -0,0 +1,27 @@ +CMP0062 +------- + +Disallow install() of export() result. + +The :command:`export()` command generates a file containing +:ref:`Imported Targets`, which is suitable for use from the build +directory. It is not suitable for installation because it contains absolute +paths to buildsystem locations, and is particular to a single build +configuration. + +The :command:`install(EXPORT)` generates and installs files which contain +:ref:`Imported Targets`. These files are generated with relative paths +(unless the user specifies absolute paths), and are designed for +multi-configuration use. See :ref:`Creating Packages` for more. + +CMake 3.3 no longer allows the use of the :command:`install(FILES)` command +with the result of the :command:`export()` command. + +The ``OLD`` behavior for this policy is to allow installing the result of +an :command:`export()` command. The ``NEW`` behavior for this policy is +not to allow installing the result of an :command:`export()` command. + +This policy was introduced in CMake version 3.3. 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. diff --git a/Help/release/dev/disallow-install-of-export.rst b/Help/release/dev/disallow-install-of-export.rst new file mode 100644 index 0000000..baee26d --- /dev/null +++ b/Help/release/dev/disallow-install-of-export.rst @@ -0,0 +1,5 @@ +disallow-install-of-export +-------------------------- + +* Using the output of :command:`export()` with the :command:`install(FILES)` + command is no longer allowed. See policy :policy:`CMP0062` for details. |