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.
30 lines
1.1 KiB
ReStructuredText
30 lines
1.1 KiB
ReStructuredText
CMP0101
|
|
-------
|
|
|
|
.. versionadded:: 3.17
|
|
|
|
:command:`target_compile_options` now always honors the ``BEFORE`` keyword.
|
|
|
|
In CMake 3.16 and below, the :command:`target_compile_options` command
|
|
ignores the ``BEFORE`` keyword when inserting items into the
|
|
:prop_tgt:`COMPILE_OPTIONS` target property (``PRIVATE`` and ``PUBLIC``
|
|
items). CMake 3.17 and later honors the ``BEFORE`` keyword in all cases.
|
|
This policy provides compatibility for projects that have not been updated
|
|
to expect the new behavior.
|
|
|
|
The behavior of inserting items into the :prop_tgt:`INTERFACE_COMPILE_OPTIONS`
|
|
target property (``PUBLIC`` and ``INTERFACE`` items) is not affected by this
|
|
policy. The ``BEFORE`` keyword has always been honored when adding items to
|
|
:prop_tgt:`INTERFACE_COMPILE_OPTIONS`.
|
|
|
|
The ``OLD`` behavior for this policy is to not honor the ``BEFORE`` keyword
|
|
when inserting into the :prop_tgt:`COMPILE_OPTIONS` property.
|
|
The ``NEW`` behavior for this policy is to honor the ``BEFORE`` keyword in
|
|
all cases.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.17
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|