summaryrefslogtreecommitdiff
path: root/share/cmake-3.16/Help/variable/CMAKE_DISABLE_FIND_PACKAGE_PackageName.rst
diff options
context:
space:
mode:
Diffstat (limited to 'share/cmake-3.16/Help/variable/CMAKE_DISABLE_FIND_PACKAGE_PackageName.rst')
-rw-r--r--share/cmake-3.16/Help/variable/CMAKE_DISABLE_FIND_PACKAGE_PackageName.rst16
1 files changed, 16 insertions, 0 deletions
diff --git a/share/cmake-3.16/Help/variable/CMAKE_DISABLE_FIND_PACKAGE_PackageName.rst b/share/cmake-3.16/Help/variable/CMAKE_DISABLE_FIND_PACKAGE_PackageName.rst
new file mode 100644
index 0000000..ed60020
--- /dev/null
+++ b/share/cmake-3.16/Help/variable/CMAKE_DISABLE_FIND_PACKAGE_PackageName.rst
@@ -0,0 +1,16 @@
+CMAKE_DISABLE_FIND_PACKAGE_<PackageName>
+----------------------------------------
+
+Variable for disabling :command:`find_package` calls.
+
+Every non-``REQUIRED`` :command:`find_package` call in a project can be
+disabled by setting the variable
+``CMAKE_DISABLE_FIND_PACKAGE_<PackageName>`` to ``TRUE``.
+This can be used to build a project without an optional package,
+although that package is installed.
+
+This switch should be used during the initial CMake run. Otherwise if
+the package has already been found in a previous CMake run, the
+variables which have been stored in the cache will still be there. In
+that case it is recommended to remove the cache variables for this
+package from the cache using the cache editor or :manual:`cmake(1)` ``-U``