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

View File

@ -1,431 +1,265 @@
Usage: configure [options]
Installation options:
These are optional, but you may specify install directories.
-prefix <dir> ...... The deployment directory, as seen on the target device.
(default /usr/local/Qt-$QT_VERSION, $PWD if -developer-build is active)
-extprefix <dir> ... The installation directory, as seen on the host machine.
(default 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. (default EXTPREFIX)
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> ......... 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)
-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)
Configure options:
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:
* -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).
-force-debug-info .... Create symbol files for release builds.
-developer-build ..... Compile and link Qt with Qt developer options (including auto-tests exporting)
* -no-optimized-tools .. Do not build optimized host tools even in debug build.
-optimized-tools ..... Build optimized host tools even in debug build.
-opensource .......... Compile and link the Open-Source Edition of Qt.
-commercial .......... Compile and link the Commercial Edition of Qt.
-confirm-license ..... Automatically acknowledge the license (use with
either -opensource or -commercial)
-c++std <edition> .... Compile Qt with C++ standard edition (c++11, c++14, c++1z)
Default: highest supported
* -shared .............. Create and use shared Qt libraries.
-static .............. Create and use static Qt libraries.
-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.
-no-sql-<driver> ..... Disable SQL <driver>.
-sql-<driver> Enable SQL <driver> plugin.
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.
-R <string> .......... Add an explicit runtime library path to the Qt
libraries.
-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
-continue ............ Continue as far as possible if an error occurs.
-verbose, -v ......... Print verbose information about each step of the
configure process.
-silent .............. Reduce the build output so that warnings and errors
can be seen more easily.
-no-cups ............. Do not compile CUPS support.
* -cups ................ Compile CUPS support.
Requires cups/cups.h and libcups.so.2.
-no-iconv ............ Do not compile support for iconv(3).
* -iconv ............... Compile support for iconv(3).
-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.
Top-level installation directories:
-prefix <dir> ...... The deployment directory, as seen on the target device.
[/usr/local/Qt-$QT_VERSION, $PWD if -developer-build]
-extprefix <dir> ... The installation directory, as seen on the host machine.
[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.
Fine tuning of installation directory layout. Note that all directories
except -sysconfdir should be located under -prefix/-hostprefix:
-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 [HOSTPREFIX/bin]
-hostlibdir <dir> ..... Host libraries [HOSTPREFIX/lib]
-hostdatadir <dir> .... Data used by qmake [HOSTPREFIX]
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.
Configure meta:
-help, -h ............ Display this help screen
-verbose, -v ......... Print verbose messages during configuration
-continue ............ Continue configure despite errors
Build options:
-opensource .......... Build the Open-Source Edition of Qt
-commercial .......... Build the Commercial Edition of Qt
-confirm-license ..... Automatically acknowledge the license
-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]
-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)
-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
-qtnamespace <name> .. Wrap all Qt library code in 'namespace <name> {...}'.
-qtlibinfix <infix> .. Rename all libQt5*.so to libQt5*<infix>.so.
-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.
-c++std <edition> .... Select C++ standard <edition> [c++1z/c++14/c++11]
-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]
-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. 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]
-reduce-exports ...... Reduce amount of exported symbols [auto]
-reduce-relocations .. Reduce amount of relocations [auto]
-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
Build environment:
-sysroot <dir> ....... Set <dir> as the target sysroot
-gcc-sysroot ......... With -sysroot, pass --sysroot to the compiler [yes]
-pkg-config .......... Use pkg-config [auto]
-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)
-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-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]
Component selection:
-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]
Qt comes with bundled copies of some 3rd party libraries. These are used
by default if auto-detection of the respective system library fails.
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 [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]
Logging backends:
-journald .......... Enable journald support [no]
-syslog ............ Enable syslog support [no]
-slog2 ............. Enable slog2 support [auto] (QNX only)
Network options:
-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)
-sctp ................ Enable SCTP support [no]
-libproxy ............ Enable use of libproxy [no]
-system-proxies ...... Use system network proxies by default [yes]
Gui, printing, widget options:
-cups ................ Enable CUPS support [auto]
-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)
-gtk ................. Enable GTK platform theme support [auto]
-lgmon ............... Enable lgmon support [auto] (QNX only)
-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]
-qpa <name> .......... Select default QPA backend (e.g., xcb, cocoa, windows)
-xcb-xlib............. Enable Xcb-Xlib support [auto]
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)
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]
Image formats:
-gif ............... Enable reading support for GIF [auto]
-libpng ............ Select used libpng [system/qt/no]
-libjpeg ........... Select used libjpeg [system/qt/no]
Database options:
-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]
Multimedia options:
-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.