mirror of
https://github.com/Kitware/CMake.git
synced 2026-02-13 18:49:38 -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.
44 lines
1.7 KiB
ReStructuredText
44 lines
1.7 KiB
ReStructuredText
CMP0113
|
|
-------
|
|
|
|
.. versionadded:: 3.19
|
|
|
|
:ref:`Makefile Generators` do not repeat custom commands from target
|
|
dependencies.
|
|
|
|
Consider a chain of custom commands split across two dependent targets:
|
|
|
|
.. code-block:: cmake
|
|
|
|
add_custom_command(OUTPUT output-not-created
|
|
COMMAND ... DEPENDS ...)
|
|
set_property(SOURCE output-not-created PROPERTY SYMBOLIC 1)
|
|
add_custom_command(OUTPUT output-created
|
|
COMMAND ... DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/output-not-created)
|
|
add_custom_target(first DEPENDS output-not-created)
|
|
add_custom_target(second DEPENDS output-created)
|
|
add_dependencies(second first)
|
|
|
|
In CMake 3.18 and lower, the Makefile generators put a copy of both custom
|
|
commands in the Makefile for target ``second`` even though its dependency on
|
|
target ``first`` ensures that the first custom command runs before the second.
|
|
Running ``make second`` would cause the first custom command to run once in
|
|
the ``first`` target and then again in the ``second`` target.
|
|
|
|
CMake 3.19 and above prefer to not duplicate custom commands in a target that
|
|
are already generated in other targets on which the target depends (directly or
|
|
indirectly). This policy provides compatibility for projects that have not
|
|
been updated to expect the new behavior. In particular, projects that relied
|
|
on the duplicate execution or that did not properly set the :prop_sf:`SYMBOLIC`
|
|
source file property may be affected.
|
|
|
|
The ``OLD`` behavior for this policy is to duplicate custom commands in
|
|
dependent targets. The ``NEW`` behavior of this policy is to not duplicate
|
|
custom commands in dependent targets.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.19
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|