summaryrefslogtreecommitdiffstats
path: root/Help/variable/CMAKE_FIND_PACKAGE_WARN_NO_MODULE.rst
blob: 5d7599c0cd608397d0ba6be7a8b883bfaa353d55 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
CMAKE_FIND_PACKAGE_WARN_NO_MODULE
---------------------------------

Tell find_package to warn if called without an explicit mode.

If find_package is called without an explicit mode option (MODULE,
CONFIG or NO_MODULE) and no Find<pkg>.cmake module is in
CMAKE_MODULE_PATH then CMake implicitly assumes that the caller
intends to search for a package configuration file.  If no package
configuration file is found then the wording of the failure message
must account for both the case that the package is really missing and
the case that the project has a bug and failed to provide the intended
Find module.  If instead the caller specifies an explicit mode option
then the failure message can be more specific.

Set CMAKE_FIND_PACKAGE_WARN_NO_MODULE to TRUE to tell find_package to
warn when it implicitly assumes Config mode.  This helps developers
enforce use of an explicit mode in all calls to find_package within a
project.