mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-06 05:40:54 -06:00
ad3c2c0b03
Every policy's documentation has a paragraph on what version of CMake introduced it, how to set the policy, and whether CMake warns if the policy is not set. The wording of this paragraph has diverged across policies over time. Factor the paragraph out into a standard advice document included by every policy.
31 lines
1.1 KiB
ReStructuredText
31 lines
1.1 KiB
ReStructuredText
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
|