mirror of
https://github.com/Kitware/CMake.git
synced 2026-02-13 02:29:02 -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.
40 lines
2.0 KiB
ReStructuredText
40 lines
2.0 KiB
ReStructuredText
CMP0022
|
|
-------
|
|
|
|
:prop_tgt:`INTERFACE_LINK_LIBRARIES` defines the link interface.
|
|
|
|
CMake 2.8.11 constructed the 'link interface' of a target from
|
|
properties matching ``(IMPORTED_)?LINK_INTERFACE_LIBRARIES(_<CONFIG>)?``.
|
|
The modern way to specify config-sensitive content is to use generator
|
|
expressions and the ``IMPORTED_`` prefix makes uniform processing of the
|
|
link interface with generator expressions impossible. The
|
|
:prop_tgt:`INTERFACE_LINK_LIBRARIES` target property was introduced as a
|
|
replacement in CMake 2.8.12. This new property is named consistently
|
|
with the ``INTERFACE_COMPILE_DEFINITIONS``, ``INTERFACE_INCLUDE_DIRECTORIES``
|
|
and ``INTERFACE_COMPILE_OPTIONS`` properties. For in-build targets, CMake
|
|
will use the INTERFACE_LINK_LIBRARIES property as the source of the
|
|
link interface only if policy ``CMP0022`` is ``NEW``. When exporting a target
|
|
which has this policy set to ``NEW``, only the :prop_tgt:`INTERFACE_LINK_LIBRARIES`
|
|
property will be processed and generated for the ``IMPORTED`` target by
|
|
default. A new option to the :command:`install(EXPORT)` and export commands
|
|
allows export of the old-style properties for compatibility with
|
|
downstream users of CMake versions older than 2.8.12. The
|
|
:command:`target_link_libraries` command will no longer populate the properties
|
|
matching ``LINK_INTERFACE_LIBRARIES(_<CONFIG>)?`` if this policy is ``NEW``.
|
|
|
|
Warning-free future-compatible code which works with CMake 2.8.7 onwards
|
|
can be written by using the ``LINK_PRIVATE`` and ``LINK_PUBLIC`` keywords
|
|
of :command:`target_link_libraries`.
|
|
|
|
The ``OLD`` behavior for this policy is to ignore the
|
|
:prop_tgt:`INTERFACE_LINK_LIBRARIES` property for in-build targets.
|
|
The ``NEW`` behavior for this policy is to use the ``INTERFACE_LINK_LIBRARIES``
|
|
property for in-build targets, and ignore the old properties matching
|
|
``(IMPORTED_)?LINK_INTERFACE_LIBRARIES(_<CONFIG>)?``.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 2.8.12
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|