mirror/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2026-01-06 13:51:33 -06:00
Code Issues Packages Projects Releases Wiki Activity

Dart,FindDart: Add policy to remove these modules

Browse Source 
These modules and the "DART" tool they support have long been replaced
by CTest.
This commit is contained in:
Brad King
2023-02-27 14:13:21 -05:00
parent 6dd2948b4b
commit 2e469212c8
27 changed files with 183 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
Help/manual/cmake-policies.7.rst
View File

@@ -57,6 +57,7 @@ Policies Introduced by CMake 3.27
.. toctree::
:maxdepth: 1
CMP0145: The Dart and FindDart modules are removed. </policy/CMP0145>
CMP0144: find_package uses upper-case PACKAGENAME_ROOT variables. </policy/CMP0144>
Policies Introduced by CMake 3.26

30
Help/policy/CMP0145.rst Normal file
View File

@@ -0,0 +1,30 @@
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.
This policy was introduced in CMake version 3.27. CMake version
|release| warns when the policy is not set and uses ``OLD`` behavior.
Use the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW``
explicitly.
.. include:: DEPRECATED.txt

5
Help/release/dev/remove-dart-modules.rst Normal file
View File

@@ -0,0 +1,5 @@
remove-dart-modules
-------------------
* The :module:`Dart` and :module:`FindDart` modules have been deprecated via
policy :policy:`CMP0145`. Port projects to the :module:`CTest` module.