From 8621604e675b2f16af7b15c3c514151f3e91a7e5 Mon Sep 17 00:00:00 2001 From: Topi Reinio Date: Fri, 22 Aug 2025 12:08:03 +0000 Subject: [PATCH] Doc: Document QT_INSTALL_CONFIG_INFO_FILES CMake variable Add documentation in `Qt Configure Options` for how to enable this feature and where the configure summary and options files end up in the installation. Pick-to: 6.10 Fixes: QTBUG-137052 Change-Id: I331cffff62bd86f6946eb77e81a92a0ebe496b81 Reviewed-by: Andreas Eliasson --- doc/src/configure.qdoc | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/doc/src/configure.qdoc b/doc/src/configure.qdoc index ebfd2fc14..dd56684f0 100644 --- a/doc/src/configure.qdoc +++ b/doc/src/configure.qdoc @@ -333,6 +333,31 @@ ensuring a relatively safe state for reconfiguration. The initial configure flags will still apply to the reconfigured build. + \section1 Installing Configure Summary and Options + + Since Qt 6.9, the configure summary files, as well as the options passed to + \c configure, can be automatically included as part of the installation. + + This feature is enabled by setting the CMake variable + \b{QT_INSTALL_CONFIG_INFO_FILES} to \b {ON}: + + \badcode + ~/qt-source/configure -prefix /opt/Qt6 -- -D QT_INSTALL_CONFIG_INFO_FILES=ON + \endcode + + During installation, text files for configure summary and options (for each + repository part of the build) are copied to the \l {QLibraryInfo::DataPath} + {architecture-independent Qt data directory}. + + For example, + \badcode + /opt/Qt6/config_qtbase.opt + /opt/Qt6/config_qtbase.summary + /opt/Qt6/config_qtdeclarative.opt + /opt/Qt6/config_qtdeclarative.summary + ... + \endcode + \section1 Specific Options for Platforms The following pages provide guidelines on how to configure Qt for specific