summaryrefslogtreecommitdiffstats
path: root/config_help.txt
diff options
context:
space:
mode:
authorAlexandru Croitor <alexandru.croitor@qt.io>2022-02-02 16:46:49 +0100
committerQt Cherry-pick Bot <cherrypick_bot@qt-project.org>2022-02-04 10:16:16 +0000
commit9c4b0a7c0fa80a0f541834848a1da13e8f58d985 (patch)
treeb9b09a6a98237bb2b60ce7958dd4d71b7dad041c /config_help.txt
parentbcc1ca6ee3870ffeecf950bb45230dd43b2d5162 (diff)
configure: Introduce -submodules option
The option is used to specify a list of Qt repos (git submodules) that should be included in the configuration of a top-level Qt build. The option takes a comma-separated list of qt submodule names e.g. 'qtbase,qtsvg,qtdeclarative' It can also take a single value like 'qtbase' or 'qtquick3d'. Each specified submodule and all of its transitive dependencies will be included when configuring the top-level Qt build (assuming that the submodules have previously been already checked out). Any missing submodules or dependencies will not be automatically checked out, but rather skipped. This can result in a failed configuration if a required submodule is missing. If some optional transitive submodule dependency is not desired in the build, you can combine the -submodules option together with -skip options. E.g. configuring with -submodules qtdoc,qtnetworkauth -skip qtmultimedia,qtimageformats will result in a top-level build with the following submodules: - qtbase (common dependency) - qttools (dependency of qtdoc) - qtactiveqt dependency of qttools) - qshadertools (dependency of qtdeclarative) - qtdeclarative (explicit) - qtnetworkauth (explicit) - qtdoc (explicit) Fixes: QTBUG-100388 Change-Id: Ie8c47cfd1d1e0e44a27260bf9ddf968531cc1cc0 Reviewed-by: Alexey Edelev <alexey.edelev@qt.io> Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io> (cherry picked from commit 7cb2bbd9e765bd90a2df06c7256d0306d669fbe6) Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
Diffstat (limited to 'config_help.txt')
-rw-r--r--config_help.txt5
1 files changed, 5 insertions, 0 deletions
diff --git a/config_help.txt b/config_help.txt
index 6e11f30851..095d036601 100644
--- a/config_help.txt
+++ b/config_help.txt
@@ -167,6 +167,11 @@ Build environment:
Component selection:
+ -submodules <repo>[,<repo>] ... Build the listed repositories and those they
+ depend on rather than all checked-out repositories.
+ The list should be separated with commas, e.g.
+ -submodules qtsvg,qtnetworkauth
+ [default is to build all checked out repositories]
-skip <repo>[,<repo>] Exclude one or more entire repositories from the
build. The list should be separated with commas.
e.g. -skip qtimageformats,qtsvg