aboutsummaryrefslogtreecommitdiffstats
path: root/src/qml/doc/src/cmake/cmake-variables.qdoc
diff options
context:
space:
mode:
Diffstat (limited to 'src/qml/doc/src/cmake/cmake-variables.qdoc')
-rw-r--r--src/qml/doc/src/cmake/cmake-variables.qdoc13
1 files changed, 11 insertions, 2 deletions
diff --git a/src/qml/doc/src/cmake/cmake-variables.qdoc b/src/qml/doc/src/cmake/cmake-variables.qdoc
index e2d6598ed1..79621542ca 100644
--- a/src/qml/doc/src/cmake/cmake-variables.qdoc
+++ b/src/qml/doc/src/cmake/cmake-variables.qdoc
@@ -44,11 +44,12 @@ modules, or to merge sets of QML modules under a common base point.
\title QT_QML_GENERATE_QMLLS_INI
\brief Enables autogeneration of .qmlls.ini files for QML Language Server
+\cmakevariablesince 6.7
\c QT_QML_GENERATE_QMLLS_INI is a boolean that describes whether
\l{qt6_add_qml_module}{qt6_add_qml_module()} calls generate \c{.qmlls.ini} files inside
-the \b{source folder}. If \c{.qmlls.ini} files already exists in the source folder,
-then they are overwritten.
+the \b{source folder}, into each subdirectory with a CMakeLists.txt file creating a QML module.
+If \c{.qmlls.ini} files already exist there, then they are overwritten.
\note Using \c QT_QML_GENERATE_QMLLS_INI requires a CMake version >= 3.19.
@@ -56,6 +57,14 @@ These \c{.qmlls.ini} files contain the path to the last configured build directo
and is needed by \l{QML Language Server} to find user defined modules. See also
\l{QML Language Server} about the other ways of passing build folder to QML Language Server.
+
+As This variable is used for IDE integration, it should normally not be set in a project itself, but
+passed to CMake via an IDE or manually by passing
+\badcode
+-DQT_QML_GENERATE_QMLLS_INI=ON
+\endcode
+to the cmake executable.
+
\note The files generated by \c QT_QML_GENERATE_QMLLS_INI are only valid for the current
configuration and should be ignored by your version control system. For git, this can be
done by adding \c{.qmlls.ini} to your \c{.gitignore}, for example.