mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-05 21:31:08 -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.
29 lines
1.2 KiB
ReStructuredText
29 lines
1.2 KiB
ReStructuredText
CMP0158
|
|
-------
|
|
|
|
.. versionadded:: 3.29
|
|
|
|
:command:`add_test` honors :variable:`CMAKE_CROSSCOMPILING_EMULATOR` only
|
|
when :variable:`cross-compiling <CMAKE_CROSSCOMPILING>`.
|
|
|
|
In CMake 3.28 and below, :command:`add_test` unconditionally used the
|
|
:prop_tgt:`CROSSCOMPILING_EMULATOR` target property (initialized by the
|
|
:variable:`CMAKE_CROSSCOMPILING_EMULATOR` variable) to run test commands
|
|
naming executable targets. CMake 3.29 and above prefer to use the emulator
|
|
only when the :variable:`CMAKE_CROSSCOMPILING` variable is enabled. The
|
|
:variable:`CMAKE_TEST_LAUNCHER` variable may be used instead when not
|
|
cross-compiling. This policy provides compatibility for projects that
|
|
have not been updated.
|
|
|
|
The ``OLD`` behavior for this policy is for :command:`add_test` to use
|
|
the :prop_tgt:`CROSSCOMPILING_EMULATOR` target property unconditionally.
|
|
The ``NEW`` behavior for this policy is for :command:`add_test` to use
|
|
the :prop_tgt:`CROSSCOMPILING_EMULATOR` target property only when
|
|
:variable:`cross-compiling <CMAKE_CROSSCOMPILING>`.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.29
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|