8f2a82f24d8a644b6e96df0501f8ad5557da8a51
[platform/upstream/cmake.git] / Help / variable / CMAKE_FIND_DEBUG_MODE.rst
1 CMAKE_FIND_DEBUG_MODE
2 ---------------------
3
4 .. versionadded:: 3.17
5
6 Print extra find call information for the following commands to standard
7 error:
8
9 * :command:`find_program`
10 * :command:`find_library`
11 * :command:`find_file`
12 * :command:`find_path`
13 * :command:`find_package`
14
15 Output is designed for human consumption and not for parsing.
16 Enabling this variable is equivalent to using :manual:`cmake <cmake(1)>` ``--debug-find``
17 with the added ability to enable debugging for a subset of find calls.
18
19 .. code-block:: cmake
20
21   set(CMAKE_FIND_DEBUG_MODE TRUE)
22   find_program(...)
23   set(CMAKE_FIND_DEBUG_MODE FALSE)
24
25 Default is unset.