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.
28 lines
1006 B
ReStructuredText
28 lines
1006 B
ReStructuredText
CMP0051
|
|
-------
|
|
|
|
.. versionadded:: 3.1
|
|
|
|
List :genex:`TARGET_OBJECTS` in SOURCES target property.
|
|
|
|
CMake 3.0 and lower did not include the ``TARGET_OBJECTS``
|
|
:manual:`generator expression <cmake-generator-expressions(7)>` when
|
|
returning the :prop_tgt:`SOURCES` target property.
|
|
|
|
Configure-time CMake code is not able to handle generator expressions. If
|
|
using the :prop_tgt:`SOURCES` target property at configure time, it may be
|
|
necessary to first remove generator expressions using the
|
|
:command:`string(GENEX_STRIP)` command. Generate-time CMake code such as
|
|
:command:`file(GENERATE)` can handle the content without stripping.
|
|
|
|
The ``OLD`` behavior for this policy is to omit ``TARGET_OBJECTS``
|
|
expressions from the :prop_tgt:`SOURCES` target property. The ``NEW``
|
|
behavior for this policy is to include ``TARGET_OBJECTS`` expressions
|
|
in the output.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.1
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|