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.2 KiB
ReStructuredText
31 lines
1.2 KiB
ReStructuredText
CMP0131
|
|
-------
|
|
|
|
.. versionadded:: 3.24
|
|
|
|
:prop_tgt:`LINK_LIBRARIES` supports the :genex:`$<LINK_ONLY:...>`
|
|
generator expression.
|
|
|
|
CMake 3.23 and below documented the :genex:`$<LINK_ONLY:...>` generator
|
|
expression only for use in :prop_tgt:`INTERFACE_LINK_LIBRARIES`.
|
|
When used in :prop_tgt:`LINK_LIBRARIES`, the content guarded inside
|
|
:genex:`$<LINK_ONLY:...>` was always used, even when collecting non-linking
|
|
usage requirements such as :prop_tgt:`INTERFACE_COMPILE_DEFINITIONS`.
|
|
|
|
CMake 3.24 and above prefer to support :genex:`$<LINK_ONLY:...>`, when
|
|
used in :prop_tgt:`LINK_LIBRARIES`, by using the guarded content only
|
|
for link dependencies and not other usage requirements. This policy
|
|
provides compatibility for projects that have not been updated to
|
|
account for this change.
|
|
|
|
The ``OLD`` behavior for this policy is to use :prop_tgt:`LINK_LIBRARIES`
|
|
content guarded by :genex:`$<LINK_ONLY:...>` even for non-linking
|
|
usage requirements. The ``NEW`` behavior for this policy is to use
|
|
the guarded content only for link dependencies.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.24
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|