diff options
Diffstat (limited to 'config_help.txt')
| -rw-r--r-- | config_help.txt | 70 |
1 files changed, 57 insertions, 13 deletions
diff --git a/config_help.txt b/config_help.txt index f35ec4cc24..baa3e97c1b 100644 --- a/config_help.txt +++ b/config_help.txt @@ -25,6 +25,8 @@ except -sysconfdir should be located under -prefix: -libexecdir <dir> ..... Helper programs [ARCHDATADIR/bin on Windows, ARCHDATADIR/libexec otherwise] -qmldir <dir> ......... QML imports [ARCHDATADIR/qml] + -sbomdir <dir> ....... Software Bill of Materials (SBOM) + installation directory [ARCHDATADIR/sbom] -datadir <dir> ........ Arch-independent data [PREFIX] -docdir <dir> ......... Documentation [DATADIR/doc] -translationdir <dir> . Translations [DATADIR/translations] @@ -64,10 +66,13 @@ Build options: -cmake-file-api ...... Let CMake store build metadata for loading the build into an IDE. [no; yes if -developer-build] -no-guess-compiler ... Do not guess the compiler from the target mkspec. - -release ............. Build Qt with debugging turned off [yes] - -debug ............... Build Qt with debugging turned on [no] - -debug-and-release ... Build two versions of Qt, with and without - debugging turned on [yes] (Apple and Windows only) + -release ............. Build Qt with optimizations and without debug + symbols [yes] + Note that -developer-build implies -debug unless + -release is also explicitly specified + -debug ............... Build Qt without optimizations and with debug symbols + [no] + -debug-and-release ... Build two versions of Qt in one build tree [no] -optimize-debug ...... Enable debug-friendly optimizations in debug builds [auto] (Not supported with MSVC or Clang toolchains) -optimize-size ....... Optimize release builds for size instead of speed [no] @@ -80,7 +85,8 @@ Build options: sections. [auto for static builds, otherwise no] -force-asserts ....... Enable Q_ASSERT even in release builds [no] -developer-build ..... Compile and link Qt for developing Qt itself - (exports for auto-tests, extra checks, etc.) [no] + (exports for auto-tests, extra checks, implies + -no-prefix, etc.) [no] -shared .............. Build shared Qt libraries [yes] (no for UIKit) -static .............. Build static Qt libraries [no] (yes for UIKit) @@ -95,16 +101,21 @@ Build options: through an app store by default, in particular Android, iOS, tvOS, and watchOS. [auto] + -sbom ................ Enable Software Bill of Materials (SBOM) generation + [no] + -qt-host-path <path> . Specify path to a Qt host build for cross-compiling. -qtnamespace <name> .. Wrap all Qt library code in 'namespace <name> {...}'. + -qtinlinenamespace ... Make -qtnamespace an inline namespace -qtlibinfix <infix> .. Rename all libQt6*.so to libQt6*<infix>.so. - -testcocoon .......... Instrument with the TestCocoon code coverage tool [no] + -coverage <tool> ..... Instrument with the code coverage tool. -gcov ................ Instrument with the GCov code coverage tool [no] -trace [backend] ..... Enable instrumentation with tracepoints. - Currently supported backends are 'etw' (Windows) and - 'lttng' (Linux), or 'yes' for auto-detection. [no] + Currently supported backends are 'etw' (Windows), + 'lttng' (Linux), 'ctf' (Common Trace Format, cross-platform) + or 'yes' for auto-detection. [no] -sanitize {address|thread|memory|fuzzer-no-link|undefined} Instrument with the specified compiler sanitizer. @@ -133,7 +144,16 @@ Build options: -pch ................. Use precompiled headers [auto] -ltcg ................ Use Link Time Code Generation [no] - -intelcet ............ Use Intel Control-flow Enforcement Technology [no] + -intelcet ............ Use Intel Control-flow Enforcement Technology [auto] + -glibc-fortify-source Use Glibc function fortification [auto] + -trivial-auto-var-init-pattern + Use -ftrivial-auto-var-init=pattern [auto] + -stack-protector ..... Use -fstack-protector-strong [auto] + -stack-clash-protection + Use -fstack-clash-protection [auto] + -libstdcpp-assertions Use libstdc++ assertions [auto] + -libcpp-hardening .... Use libc++ hardening [auto] + -relro-now-linker .... Use -z relro -z now when linking [auto] -linker [bfd,gold,lld,mold] Force use of the GNU ld, GNU gold, LLVM/LLD or mold linker instead of default one (GCC and clang only) @@ -141,7 +161,7 @@ Build options: -unity-build ......... Enable Unity (Jumbo) build -unity-build-batch-size <int> Maximum number of source files used by the unity build - to create unity source files [8] + to create unity source files [32] -warnings-are-errors . Treat warnings as errors [no; yes if -developer-build] @@ -159,6 +179,8 @@ Build environment: -pkg-config .......... Use pkg-config [auto] (Unix only) + -vcpkg ............... Use vcpkg [no] + -D <string> .......... Pass additional preprocessor define -I <string> .......... Pass additional include path -L <string> .......... Pass additional library path @@ -189,6 +211,21 @@ Component selection: -skip <repo>[,<repo>] Exclude one or more entire repositories from the build. The list should be separated with commas. e.g. -skip qtimageformats,qtsvg + -skip-tests <repo>[,<repo>] ... Skip building tests for one or more + repositories. The list should be separated with commas. + e.g. -skip-tests qtimageformats,qtsvg + -skip-examples <repo>[,<repo>] ... Skip building examples for one or more + repositories. The list should be separated with commas. + e.g. -skip-examples qtimageformats,qtsvg + -init-submodules ..... When configure is called from the qt git super module, + it will automatically clone and initialize the + repositories specified by the -submodules option. When + no -submodules are specified, and no existing + submodules are cloned, a default set of submodules + will be initialized. To adjust other aspects of the + cloning process, check the init-repository --help + output for additional options that can be passed + to configure. -make <part> ......... Add <part> to the list of parts to be built. Specifying this option clears the default list first. (allowed values: libs, tools, examples, tests, @@ -196,6 +233,9 @@ Component selection: [default: libs and examples, also tools if not cross-building, also tests if -developer-build] -nomake <part> ....... Exclude <part> from the list of parts to be built. + -install-examples-sources Installs examples source code into the Qt prefix + Only possible when -make examples is also passed + [no] -gui ................. Build the Qt GUI module and dependencies [yes] -widgets ............. Build the Qt Widgets module and dependencies [yes] -no-dbus ............. Do not build the Qt D-Bus module @@ -208,12 +248,14 @@ Component selection: Qt comes with bundled copies of some 3rd party libraries. These are used by default if auto-detection of the respective system library fails. + -force-bundled-libs .. Only use bundled 3rd party libraries [no] + -force-system-libs ... Do not use bundled 3rd party libraries [no] + Core options: -doubleconversion .... Select used double conversion library [system/qt/no] No implies use of sscanf_l and snprintf_l (imprecise). -glib ................ Enable Glib support [no; auto on Unix] - -eventfd ............. Enable eventfd support -inotify ............. Enable inotify support -icu ................. Enable ICU support [auto] -pcre ................ Select used libpcre2 [system/qt/no] @@ -256,8 +298,10 @@ Gui, printing, widget options: -opengles3 ........... Enable OpenGL ES 3.x support instead of ES 2.x [auto] -egl ................. Enable EGL support [auto] - -qpa <name> .......... Select default QPA backend(s) (e.g., xcb, cocoa, windows) - A prioritized list separated by semi-colons. + -qpa <qpa1>[;<qpa2>] . Select supported QPA backend(s) (e.g., xcb, cocoa, + windows). A list separated by semi-colons. + -default-qpa <name> .. Select the default QPA backend (e.g., xcb, cocoa, + windows). -xcb-xlib............. Enable Xcb-Xlib support [auto] Platform backends: |