Merge topic 'suppress-implicit-find-events'

c42d82d569 find_*: support suppressing implicit transition events
64f429cc4f Help/dev: add release note for implicit configure log find events
4cd83339f1 cmFindCommon: fix comment after renaming the `FullDebugMode` member

Acked-by: Kitware Robot <kwrobot@kitware.com>
Tested-by: buildbot <buildbot@kitware.com>
Merge-request: !10874
This commit is contained in:
Brad King
2025-06-12 13:49:00 +00:00
committed by Kitware Robot
31 changed files with 832 additions and 5 deletions
@@ -0,0 +1,26 @@
CMAKE_FIND_DEBUG_MODE_NO_IMPLICIT_CONFIGURE_LOG
-----------------------------------------------
.. versionadded:: 4.1
The following commands will report configure log events when they experience a
transition between found and not-found states or when the result is first
defined:
* :command:`find_program`
* :command:`find_library`
* :command:`find_file`
* :command:`find_path`
* :command:`find_package`
The ``CMAKE_FIND_DEBUG_MODE_NO_IMPLICIT_CONFIGURE_LOG`` boolean variable
suppresses these implicit events from the configure log when set to a true
value.
.. code-block:: cmake
set(CMAKE_FIND_DEBUG_MODE_NO_IMPLICIT_CONFIGURE_LOG TRUE)
find_program(...)
set(CMAKE_FIND_DEBUG_MODE_NO_IMPLICIT_CONFIGURE_LOG FALSE)
Default is unset.