1CMP0017
2-------
3
4Prefer files from the CMake module directory when including from there.
5
6Starting with CMake 2.8.4, if a cmake-module shipped with CMake (i.e.
7located in the CMake module directory) calls :command:`include` or
8:command:`find_package`, the files located in the CMake module directory are
9preferred over the files in :variable:`CMAKE_MODULE_PATH`.  This makes sure
10that the modules belonging to CMake always get those files included which
11they expect, and against which they were developed and tested.  In all
12other cases, the files found in :variable:`CMAKE_MODULE_PATH` still take
13precedence over the ones in the CMake module directory.  The ``OLD``
14behavior is to always prefer files from CMAKE_MODULE_PATH over files
15from the CMake modules directory.
16
17This policy was introduced in CMake version 2.8.4.  CMake version
18|release| warns when the policy is not set and uses ``OLD`` behavior.  Use
19the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
20
21.. include:: DEPRECATED.txt
22