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