diff options
| author | Eugene Shalygin <eugene.shalygin@gmail.com> | 2021-07-07 12:41:34 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2021-07-08 12:03:38 (GMT) |
| commit | a2e9fe38e43bd73513cde410f83e53e0c31ec6d6 (patch) | |
| tree | 5967cc1531f5a4f5c561c6d1159c9a98db434036 /Help/manual/cmake-packages.7.rst | |
| parent | d49b507bb6fb798bdab3edc738af80495efa979f (diff) | |
| download | CMake-a2e9fe38e43bd73513cde410f83e53e0c31ec6d6.zip CMake-a2e9fe38e43bd73513cde410f83e53e0c31ec6d6.tar.gz CMake-a2e9fe38e43bd73513cde410f83e53e0c31ec6d6.tar.bz2 | |
find_package: Add variable to make package REQUIRED
Add a `CMAKE_REQUIRE_FIND_PACKAGE_<PackageName>` variable is complement
to `CMAKE_DISABLE_FIND_PACKAGE_<PackageName>` with just the opposite
behaviour: it turns non-required find_package call into the required one.
While optional package dependencies usually result in simple and clean
build logic, sometimes people want to be sure those optional
dependencies will be found and used. Examples are reproducible builds
and build instructions for 3rd parties. People choose to make
find_package calls REQUIRED and put them behind an option(). Such
workarounds blend build logic with build environment management and do
not look elegant.
Diffstat (limited to 'Help/manual/cmake-packages.7.rst')
| -rw-r--r-- | Help/manual/cmake-packages.7.rst | 4 |
1 files changed, 3 insertions, 1 deletions
diff --git a/Help/manual/cmake-packages.7.rst b/Help/manual/cmake-packages.7.rst index 4b2934a..5262105 100644 --- a/Help/manual/cmake-packages.7.rst +++ b/Help/manual/cmake-packages.7.rst @@ -74,7 +74,9 @@ package. By setting the :variable:`CMAKE_DISABLE_FIND_PACKAGE_<PackageName>` variable to ``TRUE``, the ``<PackageName>`` package will not be searched, and will always -be ``NOTFOUND``. +be ``NOTFOUND``. Likewise, setting the +:variable:`CMAKE_REQUIRE_FIND_PACKAGE_<PackageName>` to ``TRUE`` will make the +package REQUIRED. .. _`Config File Packages`: |