From 2311b0a7f716ba5bf9c74c2013559b78944d3182 Mon Sep 17 00:00:00 2001 From: Brad King Date: Thu, 9 Feb 2023 13:39:49 -0500 Subject: Help: Clarify that the documented configure log location is not stable Issue: #23200 --- Help/manual/cmake-configure-log.7.rst | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/Help/manual/cmake-configure-log.7.rst b/Help/manual/cmake-configure-log.7.rst index 72d4093..4d64506 100644 --- a/Help/manual/cmake-configure-log.7.rst +++ b/Help/manual/cmake-configure-log.7.rst @@ -12,18 +12,24 @@ cmake-configure-log(7) Introduction ============ -CMake writes a running log, known as the configure log, -of certain events that occur during the "configure" step. -The log file is located at:: - - ${CMAKE_BINARY_DIR}/CMakeFiles/CMakeConfigureLog.yaml - +CMake writes a running log, known as the *configure log*, +of certain events that occur during the Configure step. The configure log does *not* contain a log of all output, errors, or messages printed while configuring a project. It is a log of detailed information about specific events, such as toolchain inspection by :command:`try_compile`, meant for use in debugging the configuration of a build tree. +For human use, this version of CMake writes the configure log to the file:: + + ${CMAKE_BINARY_DIR}/CMakeFiles/CMakeConfigureLog.yaml + +However, the *location and name of the log file may change* in future +versions of CMake. Tools that read the configure log should get its +location using a :ref:`configureLog ` query to +the :manual:`cmake-file-api(7)`. +See the `Log Versioning`_ section below for details. + Log Structure ============= -- cgit v0.12