CMake/Help/policy/CMP0146.rst
Brad King ad3c2c0b03 Help: Normalize and consolidate standard policy advice paragraph
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.
2024-01-11 14:48:01 -05:00

29 lines
996 B
ReStructuredText

CMP0146
-------
.. versionadded:: 3.27
The :module:`FindCUDA` module is removed.
The :module:`FindCUDA` module has been deprecated since CMake 3.10.
CMake 3.27 and above prefer to not provide the module.
This policy provides compatibility for projects that have not been
ported away from it.
Projects using the :module:`FindCUDA` module should be updated to use
CMake's first-class ``CUDA`` language support. List ``CUDA`` among the
languages named in the top-level call to the :command:`project` command,
or call the :command:`enable_language` command with ``CUDA``.
Then one can add CUDA (``.cu``) sources directly to targets,
similar to other languages.
The ``OLD`` behavior of this policy is for ``find_package(CUDA)`` to
load the deprecated module. The ``NEW`` behavior is for uses of the
module to fail as if it does not exist.
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.27
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
.. include:: STANDARD_ADVICE.txt
.. include:: DEPRECATED.txt