mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-05 13:20:47 -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.
30 lines
1.2 KiB
ReStructuredText
30 lines
1.2 KiB
ReStructuredText
CMP0145
|
|
-------
|
|
|
|
.. versionadded:: 3.27
|
|
|
|
The :module:`Dart` and :module:`FindDart` modules are removed.
|
|
|
|
These modules were added very early in CMake's development to support
|
|
driving tests with a "DART" tool, but DART has not been distributed or
|
|
maintained for many years. Projects would ``include(Dart)`` to use it,
|
|
and the ``Dart`` module would run ``find_package(Dart)`` internally.
|
|
Since :manual:`ctest(1)` was created, the ``Dart`` module has just been
|
|
a compatibility shim that finds ``Dart`` to support some legacy
|
|
functionality and then forwards to the :module:`CTest` module.
|
|
|
|
CMake 3.27 and above prefer to not provide the :module:`Dart` or
|
|
:module:`FindDart` modules. This policy provides compatibility for
|
|
projects that have not been ported away from them. Projects using the
|
|
``Dart`` module should be updated to use the :module:`CTest` module directly.
|
|
|
|
The ``OLD`` behavior of this policy is for ``include(Dart)`` and
|
|
``find_package(Dart)`` to load the deprecated modules. The ``NEW``
|
|
behavior is for uses of the modules to fail as if they do not exist.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.27
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|