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.
27 lines
977 B
ReStructuredText
27 lines
977 B
ReStructuredText
CMP0080
|
|
-------
|
|
|
|
.. versionadded:: 3.13
|
|
|
|
:module:`BundleUtilities` cannot be included at configure time.
|
|
|
|
The macros provided by :module:`BundleUtilities` are intended to be invoked
|
|
at install time rather than at configure time, because they depend on the
|
|
listed targets already existing at the time they are invoked. If they are
|
|
invoked at configure time, the targets haven't been built yet, and the
|
|
commands will fail.
|
|
|
|
This policy restricts the inclusion of :module:`BundleUtilities` to
|
|
``cmake -P`` style scripts and install rules. Specifically, it looks for the
|
|
presence of :variable:`CMAKE_GENERATOR` and throws a fatal error if it exists.
|
|
|
|
The ``OLD`` behavior of this policy is to allow :module:`BundleUtilities` to
|
|
be included at configure time. The ``NEW`` behavior of this policy is to
|
|
disallow such inclusion.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.13
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|