mirror of
https://github.com/Kitware/CMake.git
synced 2026-02-14 11:09:56 -06:00
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
1006 B
ReStructuredText
27 lines
1006 B
ReStructuredText
CMP0073
|
|
-------
|
|
|
|
.. versionadded:: 3.12
|
|
|
|
Do not produce legacy ``_LIB_DEPENDS`` cache entries.
|
|
|
|
Ancient CMake versions once used ``<tgt>_LIB_DEPENDS`` cache entries to
|
|
propagate library link dependencies. This has long been done by other
|
|
means, leaving the :command:`export_library_dependencies` command as the
|
|
only user of these values. That command has long been disallowed by
|
|
policy :policy:`CMP0033`, but the ``<tgt>_LIB_DEPENDS`` cache entries
|
|
were left for compatibility with possible non-standard uses by projects.
|
|
|
|
CMake 3.12 and above now prefer to not produce these cache entries
|
|
at all. This policy provides compatibility with projects that have
|
|
not been updated to avoid using them.
|
|
|
|
The ``OLD`` behavior for this policy is to set ``<tgt>_LIB_DEPENDS`` cache
|
|
entries. The ``NEW`` behavior for this policy is to not set them.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.12
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|