diff options
author | Lars Knoll <lars.knoll@theqtcompany.com> | 2016-04-19 16:46:39 +0200 |
---|---|---|
committer | Lars Knoll <lars.knoll@theqtcompany.com> | 2016-05-01 10:28:45 +0000 |
commit | 799be4e48912170a0441de6dadcbc64aeb7baffa (patch) | |
tree | 610049760ef242624324c4d15b9d1302d13ea276 /config_help.txt | |
parent | c7b6e1345059faa73d0f5e2e436ae1b80850f16a (diff) |
Move the help text for configure into its own file
Change-Id: If9c86c5bf9c6194f1ac282a657f9967f4fa589b3
Reviewed-by: Oswald Buddenhagen <oswald.buddenhagen@theqtcompany.com>
Diffstat (limited to 'config_help.txt')
-rw-r--r-- | config_help.txt | 433 |
1 files changed, 433 insertions, 0 deletions
diff --git a/config_help.txt b/config_help.txt new file mode 100644 index 0000000000..971e932657 --- /dev/null +++ b/config_help.txt @@ -0,0 +1,433 @@ +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. + -l <string> .......... Add an explicit library. + + -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-nis .............. Do not compile NIS support. + * -nis ................. Compile NIS support. + + -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-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. + -fw string .......... Add an explicit framework. + + * -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. |