summaryrefslogtreecommitdiffstats
path: root/Help/variable
diff options
context:
space:
mode:
authorRobert Maynard <robert.maynard@kitware.com>2019-12-17 15:53:35 (GMT)
committerRobert Maynard <robert.maynard@kitware.com>2019-12-19 13:09:49 (GMT)
commitf3c93962609f19ababd58b48db313f836bd8f0e7 (patch)
tree9acdabea885a30e65a4c789c710af351b76e7560 /Help/variable
parent204b8d9f4e9c5a64e1fa6a0ee4e6dc2911694bae (diff)
downloadCMake-f3c93962609f19ababd58b48db313f836bd8f0e7.zip
CMake-f3c93962609f19ababd58b48db313f836bd8f0e7.tar.gz
CMake-f3c93962609f19ababd58b48db313f836bd8f0e7.tar.bz2
Help: Document CMAKE_FIND_DEBUG_MODE
Diffstat (limited to 'Help/variable')
-rw-r--r--Help/variable/CMAKE_FIND_DEBUG_MODE.rst22
1 files changed, 22 insertions, 0 deletions
diff --git a/Help/variable/CMAKE_FIND_DEBUG_MODE.rst b/Help/variable/CMAKE_FIND_DEBUG_MODE.rst
new file mode 100644
index 0000000..33ffdd6
--- /dev/null
+++ b/Help/variable/CMAKE_FIND_DEBUG_MODE.rst
@@ -0,0 +1,22 @@
+CMAKE_FIND_DEBUG_MODE
+---------------------
+
+Print extra find call information for the following commands to standard
+error:
+* :command:`find_program`
+* :command:`find_library`
+* :command:`find_file`
+* :command:`find_path`
+* :command:`find_package`
+
+Output is designed for human consumption and not for parsing.
+Enabling this variable is equivalent to using :manual:`cmake <cmake(1)>` ``--debug-find``
+with the added ability to enable debugging for a subset of find calls.
+
+.. code-block:: cmake
+
+ set(CMAKE_FIND_DEBUG_MODE TRUE)
+ find_program(...)
+ set(CMAKE_FIND_DEBUG_MODE FALSE)
+
+Default is unset.