summaryrefslogtreecommitdiffstats
path: root/Help/policy
diff options
context:
space:
mode:
authorStephen Kelly <steveire@gmail.com>2015-05-14 17:08:27 (GMT)
committerStephen Kelly <steveire@gmail.com>2015-05-14 19:38:29 (GMT)
commitb85d3b66c63afa1ce7f30439deee524241b1efdc (patch)
tree3fc468657faa5c66183b70ba54f4962dcba6a19e /Help/policy
parent501c237a83001a8783b2249bd5f5066c3472a2aa (diff)
downloadCMake-b85d3b66c63afa1ce7f30439deee524241b1efdc.zip
CMake-b85d3b66c63afa1ce7f30439deee524241b1efdc.tar.gz
CMake-b85d3b66c63afa1ce7f30439deee524241b1efdc.tar.bz2
install: Disallow installing export() result.
Diffstat (limited to 'Help/policy')
-rw-r--r--Help/policy/CMP0062.rst27
1 files changed, 27 insertions, 0 deletions
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.