summaryrefslogtreecommitdiffstats
path: root/Help/policy/CMP0062.rst
blob: e0cf71ba3267d8412fcc37e3c4ee8e5c3b02df42 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
CMP0062
-------

.. versionadded:: 3.3

Disallow :command:`install` of :command:`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.

.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.3
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
.. include:: STANDARD_ADVICE.txt

.. include:: DEPRECATED.txt