mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-07 14:20:06 -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.
22 lines
926 B
ReStructuredText
22 lines
926 B
ReStructuredText
CMP0017
|
|
-------
|
|
|
|
Prefer files from the CMake module directory when including from there.
|
|
|
|
Starting with CMake 2.8.4, if a cmake-module shipped with CMake (i.e.
|
|
located in the CMake module directory) calls :command:`include` or
|
|
:command:`find_package`, the files located in the CMake module directory are
|
|
preferred over the files in :variable:`CMAKE_MODULE_PATH`. This makes sure
|
|
that the modules belonging to CMake always get those files included which
|
|
they expect, and against which they were developed and tested. In all
|
|
other cases, the files found in :variable:`CMAKE_MODULE_PATH` still take
|
|
precedence over the ones in the CMake module directory. The ``OLD``
|
|
behavior is to always prefer files from CMAKE_MODULE_PATH over files
|
|
from the CMake modules directory.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 2.8.4
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|