refactor the configure help output

- remove the redundantly listed -no-* options and indicate the defaults
  differently
- completely regroup the options into somewhat logical sections

Change-Id: Iaa87c2f3749944cd3fc2ec18975767c04892f746
Reviewed-by: Lars Knoll <lars.knoll@qt.io>
This commit is contained in:
Oswald Buddenhagen 2016-08-05 17:58:02 +02:00 committed by Lars Knoll
parent c41dd40bff
commit 30cac3ed2d
1 changed files with 263 additions and 429 deletions

View File

@ -1,431 +1,265 @@
Usage: configure [options] Usage: configure [options]
Installation options: Top-level installation directories:
-prefix <dir> ...... The deployment directory, as seen on the target device.
These are optional, but you may specify install directories. [/usr/local/Qt-$QT_VERSION, $PWD if -developer-build]
-extprefix <dir> ... The installation directory, as seen on the host machine.
-prefix <dir> ...... The deployment directory, as seen on the target device. [SYSROOT/PREFIX]
(default /usr/local/Qt-$QT_VERSION, $PWD if -developer-build is active) -hostprefix [dir] .. The installation directory for build tools running on
the host machine. If [dir] is not given, the current
-extprefix <dir> ... The installation directory, as seen on the host machine. build directory will be used. [EXTPREFIX]
(default SYSROOT/PREFIX) -external-hostbindir <path> ... Path to Qt tools built for this machine.
Use this when -platform does not match the current
-hostprefix [dir] .. The installation directory for build tools running on the system, i.e., to make a Canadian Cross Build.
host machine. If [dir] is not given, the current build
directory will be used. (default EXTPREFIX) Fine tuning of installation directory layout. Note that all directories
except -sysconfdir should be located under -prefix/-hostprefix:
You may use these to change the layout of the install. Note that all directories
except -sysconfdir should be located under -prefix/-hostprefix: -bindir <dir> ......... Executables [PREFIX/bin]
-headerdir <dir> ...... Header files [PREFIX/include]
-bindir <dir> ......... User executables will be installed to <dir> -libdir <dir> ......... Libraries [PREFIX/lib]
(default PREFIX/bin) -archdatadir <dir> .... Arch-dependent data [PREFIX]
-headerdir <dir> ...... Headers will be installed to <dir> -plugindir <dir> ...... Plugins [ARCHDATADIR/plugins]
(default PREFIX/include) -libexecdir <dir> ..... Helper programs [ARCHDATADIR/bin on Windows,
-libdir <dir> ......... Libraries will be installed to <dir> ARCHDATADIR/libexec otherwise]
(default PREFIX/lib) -importdir <dir> ...... QML1 imports [ARCHDATADIR/imports]
-archdatadir <dir> .... Arch-dependent data used by Qt will be installed to <dir> -qmldir <dir> ......... QML2 imports [ARCHDATADIR/qml]
(default PREFIX) -datadir <dir> ........ Arch-independent data [PREFIX]
-plugindir <dir> ...... Plugins will be installed to <dir> -docdir <dir> ......... Documentation [DATADIR/doc]
(default ARCHDATADIR/plugins) -translationdir <dir> . Translations [DATADIR/translations]
-libexecdir <dir> ..... Program executables will be installed to <dir> -sysconfdir <dir> ..... Settings used by Qt programs [PREFIX/etc/xdg]
(default ARCHDATADIR/libexec, ARCHDATADIR/bin for MinGW) -examplesdir <dir> .... Examples [PREFIX/examples]
-importdir <dir> ...... Imports for QML1 will be installed to <dir> -testsdir <dir> ....... Tests [PREFIX/tests]
(default ARCHDATADIR/imports)
-qmldir <dir> ......... Imports for QML2 will be installed to <dir> -hostbindir <dir> ..... Host executables [HOSTPREFIX/bin]
(default ARCHDATADIR/qml) -hostlibdir <dir> ..... Host libraries [HOSTPREFIX/lib]
-datadir <dir> ........ Arch-independent data used by Qt will be installed to <dir> -hostdatadir <dir> .... Data used by qmake [HOSTPREFIX]
(default PREFIX)
-docdir <dir> ......... Documentation will be installed to <dir> Conventions for the remaining options: When an option's description is
(default DATADIR/doc) followed by a list of values in brackets, the interpretation is as follows:
-translationdir <dir> . Translations of Qt programs will be installed to <dir> 'yes' represents the bare option; all other values are possible prefixes to
(default DATADIR/translations) the option, e.g., -no-gui. Alternatively, the value can be assigned, e.g.,
-sysconfdir <dir> ..... Settings used by Qt programs will be looked for in <dir> -gui=yes. Values are listed in the order they are tried if not specified;
(default PREFIX/etc/xdg) 'auto' is a shorthand for 'yes/no'. Solitary 'yes' and 'no' represent binary
-examplesdir <dir> .... Examples will be installed to <dir> options without auto-detection.
(default PREFIX/examples)
-testsdir <dir> ....... Tests will be installed to <dir> Configure meta:
(default PREFIX/tests)
-help, -h ............ Display this help screen
-hostbindir <dir> ..... Host executables will be installed to <dir> -verbose, -v ......... Print verbose messages during configuration
(default HOSTPREFIX/bin) -continue ............ Continue configure despite errors
-hostlibdir <dir> ..... Host libraries will be installed to <dir>
(default HOSTPREFIX/lib) Build options:
-hostdatadir <dir> .... Data used by qmake will be installed to <dir>
(default HOSTPREFIX) -opensource .......... Build the Open-Source Edition of Qt
-commercial .......... Build the Commercial Edition of Qt
Configure options: -confirm-license ..... Automatically acknowledge the license
The defaults (*) are usually acceptable. A plus (+) denotes a default value -release ............. Build Qt with debugging turned off [yes]
that needs to be evaluated. If the evaluation succeeds, the feature is -debug ............... Build Qt with debugging turned on [no]
included. Here is a short explanation of each option: -debug-and-release ... Build two versions of Qt, with and without
debugging turned on [yes] (Apple and Windows only)
* -release ............. Compile and link Qt with debugging turned off. -optimized-tools ..... Build optimized host tools even in debug build [no]
-debug ............... Compile and link Qt with debugging turned on. -force-debug-info .... Create symbol files for release builds [no]
-debug-and-release ... Compile and link two versions of Qt, with and without -separate-debug-info . Split off debug information to separate files [no]
debugging turned on (Apple platforms only). -strip ............... Strip release binaries of unneeded symbols [yes]
-force-asserts ....... Enable Q_ASSERT even in release builds [no]
-force-debug-info .... Create symbol files for release builds. -developer-build ..... Compile and link Qt for developing Qt itself
(exports for auto-tests, extra checks, etc.) [no]
-developer-build ..... Compile and link Qt with Qt developer options (including auto-tests exporting)
-shared .............. Build shared Qt libraries [yes] (no for UIKit)
* -no-optimized-tools .. Do not build optimized host tools even in debug build. -static .............. Build static Qt libraries [no] (yes for UIKit)
-optimized-tools ..... Build optimized host tools even in debug build. -framework ........... Build Qt framework bundles [yes] (Apple only)
-opensource .......... Compile and link the Open-Source Edition of Qt. -platform <target> ... Select host mkspec [detected]
-commercial .......... Compile and link the Commercial Edition of Qt. -host-option <key=value> ..... Add option for the host mkspec
-xplatform <target> .. Select target mkspec when cross-compiling [PLATFORM]
-confirm-license ..... Automatically acknowledge the license (use with -device <name> ....... Cross-compile for device <name>
either -opensource or -commercial) -device-option <key=value> ... Add option for the device mkspec
-c++std <edition> .... Compile Qt with C++ standard edition (c++11, c++14, c++1z) -qtnamespace <name> .. Wrap all Qt library code in 'namespace <name> {...}'.
Default: highest supported -qtlibinfix <infix> .. Rename all libQt5*.so to libQt5*<infix>.so.
* -shared .............. Create and use shared Qt libraries. -testcocoon .......... Instrument with the TestCocoon code coverage tool [no]
-static .............. Create and use static Qt libraries. -gcov ................ Instrument with the GCov code coverage tool [no]
-sanitize {address|thread|memory|undefined}
-no-accessibility .... Do not compile Accessibility support. Instrument with the specified compiler sanitizer.
Disabling accessibility is not recommended, as it will break QStyle
and may break other internal parts of Qt. -c++std <edition> .... Select C++ standard <edition> [c++1z/c++14/c++11]
With this switch you create a source incompatible version of Qt,
which is unsupported. -sse2 ................ Use SSE2 instructions [auto]
+ -accessibility ....... Compile Accessibility support. -sse3/-ssse3/-sse4.1/-sse4.2/-avx/-avx2/-avx512
Enable use of particular x86 instructions [auto]
-no-sql-<driver> ..... Disable SQL <driver>. Enabled ones are still subject to runtime detection.
-sql-<driver> Enable SQL <driver> plugin. -mips_dsp/-mips_dspr2 Use MIPS DSP/rev2 instructions [auto]
Possible values for <driver>: -qreal <type> ........ typedef qreal to the specified type. [double]
[db2, ibase, mysql, oci, odbc, psql, sqlite, sqlite2, tds] Note: this affects binary compatibility.
-system-sqlite ....... Use sqlite from the operating system. -R <string> .......... Add an explicit runtime library path to the Qt
libraries. Supports paths relative to LIBDIR.
-no-qml-debug ........ Do not build the in-process QML debugging support. -rpath ............... Link Qt libraries and executables using the library
+ -qml-debug ........... Build the QML debugging support. install path as a runtime library path. Similar to
-R LIBDIR. On Apple platforms, disabling this implies
-platform target ..... The operating system and compiler you are building using absolute install names (based in LIBDIR) for
on (default detected from host system). dynamic libraries and frameworks. [auto]
See the README file for a list of supported -reduce-exports ...... Reduce amount of exported symbols [auto]
operating systems and compilers. -reduce-relocations .. Reduce amount of relocations [auto]
-no-sse2 ............. Do not compile with use of SSE2 instructions. -pch ................. Use precompiled headers [auto]
-no-sse3 ............. Do not compile with use of SSE3 instructions. -ltcg ................ Use Link Time Code Generation [no]
-no-ssse3 ............ Do not compile with use of SSSE3 instructions. -use-gold-linker ..... Use the GNU gold linker [auto]
-no-sse4.1 ........... Do not compile with use of SSE4.1 instructions.
-no-sse4.2 ........... Do not compile with use of SSE4.2 instructions. -warnings-are-errors . Treat warnings as errors [no; yes if -developer-build]
-no-avx .............. Do not compile with use of AVX instructions. -silent .............. Reduce the build output so that warnings and errors
-no-avx2 ............. Do not compile with use of AVX2 instructions. can be seen more easily
-no-avx512 ........... Do not compile with use of AVX512 instructions.
-no-mips_dsp ......... Do not compile with use of MIPS DSP instructions. Build environment:
-no-mips_dspr2 ....... Do not compile with use of MIPS DSP rev2 instructions.
-sysroot <dir> ....... Set <dir> as the target sysroot
-qtnamespace <name> .. Wraps all Qt library code in 'namespace <name> {...}'. -gcc-sysroot ......... With -sysroot, pass --sysroot to the compiler [yes]
-qtlibinfix <infix> .. Renames all libQt*.so to libQt*<infix>.so.
-pkg-config .......... Use pkg-config [auto]
-testcocoon .......... Instrument Qt with the TestCocoon code coverage tool.
-gcov ................ Instrument Qt with the GCov code coverage tool. -D <string> .......... Pass additional preprocessor define
-I <string> .......... Pass additional include path
-D <string> .......... Add an explicit define to the preprocessor. -L <string> .......... Pass additional library path
-I <string> .......... Add an explicit include path. -F <string> .......... Pass additional framework path (Apple only)
-L <string> .......... Add an explicit library path.
-sdk <sdk> ........... Build Qt using Apple provided SDK <sdk>. The argument
+ -pkg-config .......... Use pkg-config to detect include and library paths. By default, should be one of the available SDKs as listed by
configure determines whether to use pkg-config or not with 'xcodebuild -showsdks'.
some heuristics such as checking the environment variables. Note that the argument applies only to Qt libraries
-no-pkg-config ....... Disable use of pkg-config. and applications built using the target mkspec - not
-force-pkg-config .... Force usage of pkg-config (skips pkg-config usability host tools such as qmake, moc, rcc, etc.
detection heuristic).
-android-sdk path .... Set Android SDK root path [$ANDROID_SDK_ROOT]
-help, -h ............ Display this information. -android-ndk path .... Set Android NDK root path [$ANDROID_NDK_ROOT]
-android-ndk-platform Set Android platform
Third Party Libraries: -android-ndk-host .... Set Android NDK host (linux-x86, linux-x86_64, etc.)
[$ANDROID_NDK_HOST]
-qt-zlib ............. Use the zlib bundled with Qt. -android-arch ........ Set Android architecture (armeabi, armeabi-v7a,
+ -system-zlib ......... Use zlib from the operating system. arm64-v8a, x86, x86_64, mips, mips64)
See http://www.gzip.org/zlib -android-toolchain-version ... Set Android toolchain version
-android-style-assets Automatically extract style assets from the device at
-no-mtdev ............ Do not compile mtdev support. run time. This option makes the Android style behave
+ -mtdev ............... Enable mtdev support. correctly, but also makes the Android platform plugin
incompatible with the LGPL2.1. [yes]
+ -no-journald ......... Do not send logging output to journald.
-journald ............ Send logging output to journald. Component selection:
+ -no-syslog ........... Do not send logging output to syslog. -skip <repo> ......... Exclude an entire repository from the build.
-syslog .............. Send logging output to syslog. -make <part> ......... Add <part> to the list of parts to be built.
Specifying this option clears the default list first.
-no-gif .............. Do not compile GIF reading support. [libs and examples, also tools if not cross-building,
also tests if -developer-build]
-no-libpng ........... Do not compile PNG support. -nomake <part> ....... Exclude <part> from the list of parts to be built.
-qt-libpng ........... Use the libpng bundled with Qt. -compile-examples .... When unset, install only the sources of examples [yes]
+ -system-libpng ....... Use libpng from the operating system. -gui ................. Build the Qt GUI module and dependencies [yes]
See http://www.libpng.org/pub/png -widgets ............. Build the Qt Widgets module and dependencies [yes]
-no-dbus ............. Do not build the Qt D-Bus module [default on Android]
-no-libjpeg .......... Do not compile JPEG support. -dbus-linked ......... Build Qt D-Bus and link to libdbus-1 [auto]
-qt-libjpeg .......... Use the libjpeg bundled with Qt. -dbus-runtime ........ Build Qt D-Bus and dynamically load libdbus-1 [no]
+ -system-libjpeg ...... Use libjpeg from the operating system. -feature-<feature> ... Enable <feature>. The available features are described
See http://www.ijg.org in src/corelib/global/qfeatures.txt. [all enabled]
-accessibility ....... Enable accessibility support [yes]
-no-doubleconversion ..... Use sscanf_l and snprintf_l for (imprecise) double conversion. Note: Disabling accessibility is not recommended.
-qt-doubleconversion ..... Use the libdouble-conversion bundled with Qt. -qml-debug ........... Enable QML debugging support [yes]
+ -system-doubleconversion . Use the libdouble-conversion provided by the system.
See https://github.com/google/double-conversion Qt comes with bundled copies of some 3rd party libraries. These are used
by default if auto-detection of the respective system library fails.
-no-freetype ......... Do not compile in Freetype2 support.
-qt-freetype ......... Use the libfreetype bundled with Qt. Core options:
+ -system-freetype...... Use the libfreetype provided by the system (enabled if -fontconfig is active).
See http://www.freetype.org -doubleconversion .... Select used double conversion library [system/qt/no]
No implies use of sscanf_l and snprintf_l (imprecise).
-no-harfbuzz ......... Do not compile HarfBuzz-NG support. -glib ................ Enable Glib support [auto]
-qt-harfbuzz ......... Use HarfBuzz-NG bundled with Qt to do text shaping. -iconv ............... Enable iconv(3) support [auto]
It can still be disabled by setting -icu ................. Enable ICU support [auto]
the QT_HARFBUZZ environment variable to "old". -pps ................. Enable PPS support [auto] (QNX only)
+ -system-harfbuzz ..... Use HarfBuzz-NG from the operating system -pcre ................ Select used libpcre3 [system/qt]
to do text shaping. It can still be disabled -zlib ................ Select used zlib [system/qt]
by setting the QT_HARFBUZZ environment variable to "old".
See http://www.harfbuzz.org Logging backends:
-journald .......... Enable journald support [no]
-no-openssl .......... Do not compile support for OpenSSL. -syslog ............ Enable syslog support [no]
+ -openssl ............. Enable run-time OpenSSL support. -slog2 ............. Enable slog2 support [auto] (QNX only)
-openssl-linked ...... Enabled linked OpenSSL support.
Network options:
* -no-libproxy ......... Do not compile support for libproxy
-libproxy ............ Use libproxy from the operating system. -ssl ................. Enable either SSL support method [auto]
-no-openssl .......... Do not use OpenSSL [default on Apple]
-qt-pcre ............. Use the PCRE library bundled with Qt. -openssl-linked ...... Use OpenSSL and link to libssl [no]
+ -system-pcre ......... Use the PCRE library from the operating system. -openssl-runtime ..... Use OpenSSL and dynamically load libssl [auto]
-securetransport ..... Use SecureTransport [auto] (Apple only)
-qt-xcb .............. Use xcb- libraries bundled with Qt.
(libxcb.so will still be used from operating system). -sctp ................ Enable SCTP support [no]
+ -system-xcb .......... Use xcb- libraries from the operating system.
-libproxy ............ Enable use of libproxy [no]
-xkb-config-root ..... Set default XKB config root. This option is used only together with -qt-xkbcommon-x11. -system-proxies ...... Use system network proxies by default [yes]
-qt-xkbcommon-x11 .... Use the xkbcommon library bundled with Qt in combination with xcb.
+ -system-xkbcommon-x11 Use the xkbcommon library from the operating system in combination with xcb. Gui, printing, widget options:
-no-xkbcommon-evdev .. Do not use X-less xkbcommon when compiling libinput support. -cups ................ Enable CUPS support [auto]
* -xkbcommon-evdev ..... Use X-less xkbcommon when compiling libinput support.
-fontconfig .......... Enable Fontconfig support [auto]
-no-xinput2 .......... Do not compile XInput2 support. -freetype ............ Select used FreeType [system/qt/no]
* -xinput2 ............. Compile XInput2 support. -harfbuzz ............ Select used HarfBuzz-NG [system/qt/no]
(Not auto-detected on Apple and Windows)
-no-xcb-xlib.......... Do not compile Xcb-Xlib support.
* -xcb-xlib............. Compile Xcb-Xlib support. -gtk ................. Enable GTK platform theme support [auto]
-no-glib ............. Do not compile Glib support. -lgmon ............... Enable lgmon support [auto] (QNX only)
+ -glib ................ Compile Glib support.
-no-opengl ........... Disable OpenGL support
-no-pulseaudio ....... Do not compile PulseAudio support. -opengl <api> ........ Enable OpenGL support. Supported APIs:
+ -pulseaudio .......... Compile PulseAudio support. es2 (default on Windows), desktop (default on Unix)
-opengles3 ........... Enable OpenGL ES 3.x support instead of ES 2.x [auto]
-no-alsa ............. Do not compile ALSA support.
+ -alsa ................ Compile ALSA support. -qpa <name> .......... Select default QPA backend (e.g., xcb, cocoa, windows)
-xcb-xlib............. Enable Xcb-Xlib support [auto]
-no-gtk .............. Do not compile GTK platform theme support.
+ -gtk ................. Compile GTK platform theme support. Platform backends:
-directfb .......... Enable DirectFB support [no] (Unix only)
Additional options: -eglfs ............. Enable EGLFS support [auto; no on Android]
-gbm ............... Enable backends for GBM [auto] (Linux only)
-make <part> ......... Add part to the list of parts to be built at make time. -kms ............... Enable backends for KMS [auto] (Linux only)
(defaults to: libs tools examples) -linuxfb ........... Enable Linux Framebuffer support [auto] (Linux only)
-nomake <part> ....... Exclude part from the list of parts to be built. -mirclient ......... Enable Mir client support [no] (Linux only)
-xcb ............... Select used xcb-* libraries [system/qt/no]
-skip <module> ....... Exclude an entire module from the build. (-qt-xcb still uses system version of libxcb itself)
-no-compile-examples . Install only the sources of examples. Input backends:
-evdev ............. Enable evdev support [auto]
-no-gui .............. Don't build the Qt GUI module and dependencies. -imf ............... Enable IMF support [auto] (QNX only)
+ -gui ................. Build the Qt GUI module and dependencies. -libinput .......... Enable libinput support [auto]
-mtdev ............. Enable mtdev support [auto]
-no-widgets .......... Don't build the Qt Widgets module and dependencies. -tslib ............. Enable tslib support [auto]
+ -widgets ............. Build the Qt Widgets module and dependencies. -xinput2 ........... Enable XInput2 support [auto]
-xkbcommon-x11 ..... Select xkbcommon used in combination with xcb
-R <string> .......... Add an explicit runtime library path to the Qt [system/qt/no]
libraries. -xkb-config-root <dir> ... With -qt-xkbcommon-x11, set default XKB config
root <dir> [detect]
-no-rpath ............ Do not use the library install path as a runtime -xkbcommon-evdev ... Enable X-less xkbcommon in combination with libinput
library path. On Apple platforms, this implies using [auto]
absolute install names (based in -libdir) for dynamic
libraries and frameworks. Image formats:
+ -rpath ............... Link Qt libraries and executables using the library -gif ............... Enable reading support for GIF [auto]
install path as a runtime library path. Equivalent -libpng ............ Select used libpng [system/qt/no]
to -R install_libpath -libjpeg ........... Select used libjpeg [system/qt/no]
-continue ............ Continue as far as possible if an error occurs. Database options:
-verbose, -v ......... Print verbose information about each step of the -sql-<driver> ........ Enable SQL <driver> plugin. Supported drivers:
configure process. db2 ibase mysql oci odbc psql sqlite2 sqlite tds
[all auto]
-silent .............. Reduce the build output so that warnings and errors -sqlite .............. Select used sqlite3 [system/qt]
can be seen more easily.
Multimedia options:
-no-cups ............. Do not compile CUPS support.
* -cups ................ Compile CUPS support. -pulseaudio .......... Enable PulseAudio support [auto]
Requires cups/cups.h and libcups.so.2. -alsa ................ Enable ALSA support [auto]
-no-gstreamer ........ Disable support for GStreamer
-no-iconv ............ Do not compile support for iconv(3). -gstreamer [version] . Enable GStreamer support [auto]
* -iconv ............... Compile support for iconv(3). With no parameter, 1.0 is tried first, then 0.10.
-no-evdev ............ Do not compile support for evdev.
* -evdev ............... Compile support for evdev.
-no-tslib ............ Do not compile support for tslib.
* -tslib ............... Compile support for tslib.
-no-icu .............. Do not compile support for ICU libraries.
+ -icu ................. Compile support for ICU libraries.
-no-fontconfig ....... Do not compile FontConfig support.
+ -fontconfig .......... Compile FontConfig support.
-no-strip ............ Do not strip binaries and libraries of unneeded symbols.
* -strip ............... Strip binaries and libraries of unneeded symbols when installing.
* -no-pch .............. Do not use precompiled header support.
-pch ................. Use precompiled header support.
* -no-ltcg Do not use Link Time Code Generation
-ltcg Use Link Time Code Generation.
-no-dbus ............. Do not compile the Qt D-Bus module.
+ -dbus-linked ......... Compile the Qt D-Bus module and link to libdbus-1.
-dbus-runtime ........ Compile the Qt D-Bus module and dynamically load libdbus-1.
-reduce-relocations .. Reduce relocations in the libraries through extra
linker optimizations (Qt/X11 and Qt for Embedded Linux only;
experimental; needs GNU ld >= 2.18).
-no-use-gold-linker .. Do not link using the GNU gold linker.
+ -use-gold-linker ..... Link using the GNU gold linker if available.
-force-asserts ....... Force Q_ASSERT to be enabled even in release builds.
-sanitize [address|thread|memory|undefined] Enables the specified compiler sanitizer.
-device <name> ............... Cross-compile for device <name> (experimental)
-device-option <key=value> ... Add device specific options for the device mkspec
(experimental)
-host-option <key=value> ..... Add host specific options for the host mkspec
* -no-separate-debug-info ...... Do not store debug information in a separate file.
-separate-debug-info ......... Strip debug information into a separate file.
-no-xcb .............. Do not compile Xcb (X protocol C-language Binding) support.
* -xcb ................. Compile Xcb support.
-no-eglfs ............ Do not compile EGLFS (EGL Full Screen/Single Surface) support.
* -eglfs ............... Compile EGLFS support.
-no-kms .............. Do not compile backends for KMS.
* -kms ................. Compile backends for KMS.
-no-gbm .............. Do not compile backends for GBM.
* -gbm ................. Compile backends for GBM.
* -no-directfb ......... Do not compile DirectFB support.
-directfb ............ Compile DirectFB support.
-no-linuxfb .......... Do not compile Linux Framebuffer support.
* -linuxfb ............. Compile Linux Framebuffer support.
* -no-mirclient......... Do not compile Mir client support.
-mirclient............ Compile Mir client support.
-qpa <name> .......... Sets the default QPA platform (e.g xcb, cocoa, windows).
-xplatform target .... The target platform when cross-compiling.
-sysroot <dir> ....... Sets <dir> as the target compiler's and qmake's sysroot and also sets pkg-config paths.
-no-gcc-sysroot ...... When using -sysroot, it disables the passing of --sysroot to the compiler
-external-hostbindir <path> .. Path to Qt tools built for this machine. Use this when -platform
does not match the current system, i.e., to make a Canadian Cross Build.
-no-feature-<feature> Do not compile in <feature>.
-feature-<feature> ... Compile in <feature>. The available features
are described in src/corelib/global/qfeatures.txt
-qreal [double|float] typedef qreal to the specified type. The default is double.
Note that changing this flag affects binary compatibility.
-no-opengl ........... Do not support OpenGL.
-opengl <api> ........ Enable OpenGL support
With no parameter, this will attempt to auto-detect
OpenGL ES 2.0 and higher, or regular desktop OpenGL.
Use es2 for <api> to override auto-detection.
-no-libinput ......... Do not support libinput.
* -libinput ............ Enable libinput support.
-no-gstreamer ........ Do not support GStreamer.
+ -gstreamer <version> . Enable GStreamer support
With no parameter, this will attempt to auto-detect GStreamer 0.10 and
1.0. GStreamer 1.0 is used by default when available.
Use 0.10 or 1.0 for <version> to override auto-detection.
-no-system-proxies ... Do not use system network proxies by default.
* -system-proxies ...... Use system network proxies by default.
* -no-sctp ............. Do not compile SCTP network protocol support.
-sctp ................ Compile SCTP support.
-no-warnings-are-errors Make warnings be treated normally
-warnings-are-errors Make warnings be treated as errors
(enabled if -developer-build is active)
QNX options:
-no-slog2 ........... Do not compile with slog2 support.
-slog2 .............. Compile with slog2 support.
-no-pps ............. Do not compile with pps support.
-pps ................ Compile with pps support.
-no-imf ............. Do not compile with imf support.
-imf ................ Compile with imf support.
-no-lgmon ........... Do not compile with lgmon support.
-lgmon .............. Compile with lgmon support.
Apple platform options:
-Fstring ............ Add an explicit framework path.
* -framework .......... Build Qt as a series of frameworks and
link tools against those frameworks.
-no-framework ....... Do not build Qt as a series of frameworks.
* -securetransport .... Use SecureTransport instead of OpenSSL
-no-securetransport . Do not use SecureTransport, either use OpenSSL or do not use any SSL backend
at all (if combined with -no-openssl).
-sdk <sdk> .......... Build Qt using Apple provided SDK <sdk>. The argument should be
one of the available SDKs as listed by 'xcodebuild -showsdks'.
Note that the argument applies only to Qt libraries and applications built
using the target mkspec - not host tools such as qmake, moc, rcc, etc.
Android options:
-android-sdk path .............. The Android SDK root path.
(default $ANDROID_SDK_ROOT)
-android-ndk path .............. The Android NDK root path.
(default $ANDROID_NDK_ROOT)
-android-ndk-platform .......... Sets the android platform
-android-ndk-host .............. Sets the android NDK host (linux-x86, linux-x86_64, etc.)
(default $ANDROID_NDK_HOST)
-android-arch .................. Sets the android architecture (armeabi, armeabi-v7a, x86, mips,
arm64-v8a, x86_64, mips64)
-android-toolchain-version ..... Sets the android toolchain version
-no-android-style-assets ....... Do not compile in the code which automatically extracts
style assets from the run-time device. Setting this will
make the Android style behave incorrectly, but will enable
compatibility with the LGPL2.1 license.
* -android-style-assets .......... Compile the code which automatically extracts style assets
from the run-time device. This option will make the
Android platform plugin incompatible with the LGPL2.1.