summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorMatthew Woehlke <matthew.woehlke@kitware.com>2022-10-04 20:42:54 (GMT)
committerBrad King <brad.king@kitware.com>2022-10-06 12:13:03 (GMT)
commit7e6b2a92a0a3fe1261c1ecb5db2acb7e30a4f75c (patch)
tree59b492910729614d7a7ff1212be24706c6a7ea87 /Help
parentcbf3252975ef4acf9d1f11130bf03a8431998697 (diff)
downloadCMake-7e6b2a92a0a3fe1261c1ecb5db2acb7e30a4f75c.zip
CMake-7e6b2a92a0a3fe1261c1ecb5db2acb7e30a4f75c.tar.gz
CMake-7e6b2a92a0a3fe1261c1ecb5db2acb7e30a4f75c.tar.bz2
try_compile: Report build dir with --debug-trycompile
When `--debug-trycompile` is enabled, issue a log (with trace) for every `try_compile` noting what directory is being used for the compilation. This will make it easier to find the corresponding artifacts. Closes: #24022
Diffstat (limited to 'Help')
-rw-r--r--Help/manual/cmake.1.rst5
-rw-r--r--Help/release/dev/try_compile-signatures.rst5
2 files changed, 9 insertions, 1 deletions
diff --git a/Help/manual/cmake.1.rst b/Help/manual/cmake.1.rst
index 868dac4..801229e 100644
--- a/Help/manual/cmake.1.rst
+++ b/Help/manual/cmake.1.rst
@@ -292,6 +292,11 @@ Options
is effectively a :command:`try_compile`. Any combination of the two
is subject to the potential issues described.)
+ .. versionadded:: 3.25
+
+ When this option is enabled, every try-compile check prints a log
+ message reporting the directory in which the check is performed.
+
.. option:: --debug-output
Put cmake in a debug mode.
diff --git a/Help/release/dev/try_compile-signatures.rst b/Help/release/dev/try_compile-signatures.rst
index d477d989..c32babd 100644
--- a/Help/release/dev/try_compile-signatures.rst
+++ b/Help/release/dev/try_compile-signatures.rst
@@ -5,4 +5,7 @@ try_compile-signatures
signatures that more consistently use keyword dispatch and do not require a
binary directory to be specified. Additionally, these signatures use a
unique directory for each invocation, which allows multiple outputs to be
- preserved when using ``--debug-trycompile``.
+ preserved when using :option:`--debug-trycompile <cmake --debug-trycompile>`.
+
+* The :option:`cmake --debug-trycompile` option now prints log messages
+ reporting the directory in which each try-compile check is done.