Warning, /graphics/digikam/project/bundles/3rdparty/ext_qt5/config_help-5.15.txt is written in an unsupported language. File is not indexed.

0001 Usage:  configure [options] [assignments]
0002 
0003 Configure understands variable assignments like VAR=value on the command line.
0004 Each uppercased library name (obtainable with -list-libraries) supports the
0005 suffixes _INCDIR, _LIBDIR, _PREFIX (INCDIR=PREFIX/include, LIBDIR=PREFIX/lib),
0006 _LIBS, and - on Windows and Darwin - _LIBS_DEBUG and _LIBS_RELEASE. E.g.,
0007 ICU_PREFIX=/opt/icu42 ICU_LIBS="-licui18n -licuuc -licudata".
0008 
0009 It is also possible to manipulate any QMAKE_* variable, to amend the values
0010 from the mkspec for the build of Qt itself, e.g., QMAKE_CXXFLAGS+=-g3.
0011 
0012 Note that the *_LIBS* and QMAKE_* assignments manipulate lists, so items
0013 containing meta characters (spaces in particular) need to be quoted according
0014 to qmake rules. On top of that, the assignments as a whole need to be quoted
0015 according to shell rules. It is recommended to use single quotes for the inner
0016 quoting and double quotes for the outer quoting.
0017 
0018 Top-level installation directories:
0019   -prefix <dir> ...... The deployment directory, as seen on the target device.
0020                        [/usr/local/Qt-$QT_VERSION; qtbase build directory if
0021                        -developer-build]
0022   -extprefix <dir> ... The installation directory, as seen on the host machine.
0023                        [SYSROOT/PREFIX]
0024   -hostprefix [dir] .. The installation directory for build tools running on
0025                        the host machine. If [dir] is not given, the current
0026                        build directory will be used. [EXTPREFIX]
0027   -external-hostbindir <path> ... Path to Qt tools built for this machine.
0028                        Use this when -platform does not match the current
0029                        system, i.e., to make a Canadian Cross Build.
0030 
0031 Fine tuning of installation directory layout. Note that all directories
0032 except -sysconfdir should be located under -prefix/-hostprefix:
0033 
0034   -bindir <dir> ......... Executables [PREFIX/bin]
0035   -headerdir <dir> ...... Header files [PREFIX/include]
0036   -libdir <dir> ......... Libraries [PREFIX/lib]
0037   -archdatadir <dir> .... Arch-dependent data [PREFIX]
0038   -plugindir <dir> ...... Plugins [ARCHDATADIR/plugins]
0039   -libexecdir <dir> ..... Helper programs [ARCHDATADIR/bin on Windows,
0040                           ARCHDATADIR/libexec otherwise]
0041   -importdir <dir> ...... QML1 imports [ARCHDATADIR/imports]
0042   -qmldir <dir> ......... QML2 imports [ARCHDATADIR/qml]
0043   -datadir <dir> ........ Arch-independent data [PREFIX]
0044   -docdir <dir> ......... Documentation [DATADIR/doc]
0045   -translationdir <dir> . Translations [DATADIR/translations]
0046   -sysconfdir <dir> ..... Settings used by Qt programs [PREFIX/etc/xdg]
0047   -examplesdir <dir> .... Examples [PREFIX/examples]
0048   -testsdir <dir> ....... Tests [PREFIX/tests]
0049 
0050   -hostbindir <dir> ..... Host executables [HOSTPREFIX/bin]
0051   -hostlibdir <dir> ..... Host libraries [HOSTPREFIX/lib]
0052   -hostdatadir <dir> .... Data used by qmake [HOSTPREFIX]
0053 
0054 Conventions for the remaining options: When an option's description is
0055 followed by a list of values in brackets, the interpretation is as follows:
0056 'yes' represents the bare option; all other values are possible prefixes to
0057 the option, e.g., -no-gui. Alternatively, the value can be assigned, e.g.,
0058 --gui=yes. Values are listed in the order they are tried if not specified;
0059 'auto' is a shorthand for 'yes/no'. Solitary 'yes' and 'no' represent binary
0060 options without auto-detection.
0061 
0062 Configure meta:
0063 
0064   -help, -h ............ Display this help screen
0065   -verbose, -v ......... Print verbose messages during configuration
0066   -continue ............ Continue configure despite errors
0067   -redo ................ Re-configure with previously used options.
0068                          Additional options may be passed, but will not be
0069                          saved for later use by -redo.
0070   -recheck [test,...] .. Discard cached negative configure test results.
0071                          Use this after installing missing dependencies.
0072                          Alternatively, if tests are specified, only their
0073                          results are discarded.
0074   -recheck-all ......... Discard all cached configure test results.
0075 
0076   -feature-<feature> ... Enable <feature>
0077   -no-feature-<feature>  Disable <feature> [none]
0078   -list-features ....... List available features. Note that some features
0079                          have dedicated command line options as well.
0080 
0081   -list-libraries ...... List possible external dependencies.
0082 
0083 Build options:
0084 
0085   -opensource .......... Build the Open-Source Edition of Qt
0086   -commercial .......... Build the Commercial Edition of Qt
0087   -confirm-license ..... Automatically acknowledge the license
0088 
0089   -release ............. Build Qt with debugging turned off [yes]
0090   -debug ............... Build Qt with debugging turned on [no]
0091   -debug-and-release ... Build two versions of Qt, with and without
0092                          debugging turned on [yes] (Apple and Windows only)
0093   -optimize-debug ...... Enable debug-friendly optimizations in debug builds
0094                          [auto] (Not supported with MSVC or Clang toolchains)
0095   -optimize-size ....... Optimize release builds for size instead of speed [no]
0096   -optimized-tools ..... Build optimized host tools even in debug build [no]
0097   -force-debug-info .... Create symbol files for release builds [no]
0098   -separate-debug-info . Split off debug information to separate files [no]
0099   -gdb-index ........... Index the debug info to speed up GDB
0100                          [no; auto if -developer-build with debug info]
0101   -strip ............... Strip release binaries of unneeded symbols [yes]
0102   -gc-binaries ......... Place each function or data item into its own section
0103                          and enable linker garbage collection of unused
0104                          sections. [auto for static builds, otherwise no]
0105   -force-asserts ....... Enable Q_ASSERT even in release builds [no]
0106   -developer-build ..... Compile and link Qt for developing Qt itself
0107                          (exports for auto-tests, extra checks, etc.) [no]
0108 
0109   -shared .............. Build shared Qt libraries [yes] (no for UIKit)
0110   -static .............. Build static Qt libraries [no] (yes for UIKit)
0111   -framework ........... Build Qt framework bundles [yes] (Apple only)
0112 
0113   -platform <target> ... Select host mkspec [detected]
0114   -xplatform <target> .. Select target mkspec when cross-compiling [PLATFORM]
0115   -device <name> ....... Cross-compile for device <name>
0116   -device-option <key=value> ... Add option for the device mkspec
0117 
0118   -appstore-compliant .. Disable code that is not allowed in platform app stores.
0119                          This is on by default for platforms which require distribution
0120                          through an app store by default, in particular Android,
0121                          iOS, tvOS, watchOS, and Universal Windows Platform. [auto]
0122 
0123   -qtnamespace <name> .. Wrap all Qt library code in 'namespace <name> {...}'.
0124   -qtlibinfix <infix> .. Rename all libQt5*.so to libQt5*<infix>.so.
0125   -qtlibinfix-plugins .. Rename Qt plugins according to -qtlibinfix [no]
0126 
0127   -testcocoon .......... Instrument with the TestCocoon code coverage tool [no]
0128   -gcov ................ Instrument with the GCov code coverage tool [no]
0129 
0130   -trace [backend] ..... Enable instrumentation with tracepoints.
0131                          Currently supported backends are 'etw' (Windows) and
0132                          'lttng' (Linux), or 'yes' for auto-detection. [no]
0133 
0134   -sanitize {address|thread|memory|fuzzer-no-link|undefined}
0135                          Instrument with the specified compiler sanitizer.
0136                          Note that some sanitizers cannot be combined;
0137                          for example, -sanitize address cannot be combined with
0138                          -sanitize thread.
0139 
0140   -coverage {trace-pc-guard|source-based}
0141                          Specify the 'trace-pc-guard' coverage instrumentation for
0142                          sanitizers or generate instrumented code to collect execution
0143                          counts and enable code coverage analysis, respectively. (Clang only)
0144 
0145   -c++std <edition> .... Select C++ standard <edition> [c++2a/c++17/c++14/c++11]
0146                          (Not supported with MSVC 2015)
0147 
0148   -sse2 ................ Use SSE2 instructions [auto]
0149   -sse3/-ssse3/-sse4.1/-sse4.2/-avx/-avx2/-avx512
0150                          Enable use of particular x86 instructions [auto]
0151                          Enabled ones are still subject to runtime detection.
0152   -mips_dsp/-mips_dspr2  Use MIPS DSP/rev2 instructions [auto]
0153 
0154   -qreal <type> ........ typedef qreal to the specified type. [double]
0155                          Note: this affects binary compatibility.
0156 
0157   -R <string> .......... Add an explicit runtime library path to the Qt
0158                          libraries. Supports paths relative to LIBDIR.
0159   -rpath ............... Link Qt libraries and executables using the library
0160                          install path as a runtime library path. Similar to
0161                          -R LIBDIR. On Apple platforms, disabling this implies
0162                          using absolute install names (based in LIBDIR) for
0163                          dynamic libraries and frameworks. [auto]
0164 
0165   -reduce-exports ...... Reduce amount of exported symbols [auto]
0166   -reduce-relocations .. Reduce amount of relocations [auto] (Unix only)
0167 
0168   -plugin-manifests .... Embed manifests into plugins [no] (Windows only)
0169   -static-runtime ...... With -static, use static runtime [no] (Windows only)
0170 
0171   -pch ................. Use precompiled headers [auto]
0172   -ltcg ................ Use Link Time Code Generation [no]
0173   -linker [bfd,gold,lld] Force use of the GNU ld, GNU gold or LLVM/LLD linker
0174                          instead of default one (GCC only)
0175   -incredibuild-xge .... Use the IncrediBuild XGE [no] (Windows only)
0176   -ccache .............. Use the ccache compiler cache [no] (Unix only)
0177   -make-tool <tool> .... Use <tool> to build qmake [nmake] (Windows only)
0178   -mp .................. Use multiple processors for compilation (MSVC only)
0179 
0180   -warnings-are-errors . Treat warnings as errors [no; yes if -developer-build]
0181   -silent .............. Reduce the build output so that warnings and errors
0182                          can be seen more easily
0183 
0184 Build environment:
0185 
0186   -sysroot <dir> ....... Set <dir> as the target sysroot
0187   -gcc-sysroot ......... With -sysroot, pass --sysroot to the compiler [yes]
0188 
0189   -pkg-config .......... Use pkg-config [auto] (Unix only)
0190 
0191   -D <string> .......... Pass additional preprocessor define
0192   -I <string> .......... Pass additional include path
0193   -L <string> .......... Pass additional library path
0194   -F <string> .......... Pass additional framework path (Apple only)
0195 
0196   -sdk <sdk> ........... Build Qt using Apple provided SDK <sdk>. The argument
0197                          should be one of the available SDKs as listed by
0198                          'xcodebuild -showsdks'.
0199                          Note that the argument applies only to Qt libraries
0200                          and applications built using the target mkspec - not
0201                          host tools such as qmake, moc, rcc, etc.
0202 
0203   -android-sdk path .... Set Android SDK root path [$ANDROID_SDK_ROOT]
0204   -android-ndk path .... Set Android NDK root path [$ANDROID_NDK_ROOT]
0205   -android-ndk-platform  Set Android platform
0206   -android-ndk-host .... Set Android NDK host (linux-x86, linux-x86_64, etc.)
0207                          [$ANDROID_NDK_HOST]
0208   -android-abis .......  Comma separated Android abis, default is:
0209                          armeabi-v7a,arm64-v8a,x86,x86_64
0210   -android-style-assets  Automatically extract style assets from the device at
0211                          run time. This option makes the Android style behave
0212                          correctly, but also makes the Android platform plugin
0213                          incompatible with the LGPL2.1. [yes]
0214 
0215 Component selection:
0216 
0217   -skip <repo> ......... Exclude an entire repository from the build.
0218   -make <part> ......... Add <part> to the list of parts to be built.
0219                          Specifying this option clears the default list first.
0220                          [libs and examples, also tools if not cross-building,
0221                          also tests if -developer-build]
0222   -nomake <part> ....... Exclude <part> from the list of parts to be built.
0223   -compile-examples .... When unset, install only the sources of examples
0224                          [no on WebAssembly, otherwise yes]
0225   -gui ................. Build the Qt GUI module and dependencies [yes]
0226   -widgets ............. Build the Qt Widgets module and dependencies [yes]
0227   -no-dbus ............. Do not build the Qt D-Bus module
0228                          [default on Android and Windows]
0229   -dbus-linked ......... Build Qt D-Bus and link to libdbus-1 [auto]
0230   -dbus-runtime ........ Build Qt D-Bus and dynamically load libdbus-1 [no]
0231   -accessibility ....... Enable accessibility support [yes]
0232                          Note: Disabling accessibility is not recommended.
0233 
0234 Qt comes with bundled copies of some 3rd party libraries. These are used
0235 by default if auto-detection of the respective system library fails.
0236 
0237 Core options:
0238 
0239   -doubleconversion .... Select used double conversion library [system/qt/no]
0240                          No implies use of sscanf_l and snprintf_l (imprecise).
0241   -glib ................ Enable Glib support [no; auto on Unix]
0242   -eventfd ............. Enable eventfd support
0243   -inotify ............. Enable inotify support
0244   -iconv ............... Enable iconv(3) support [posix/sun/gnu/no] (Unix only)
0245   -icu ................. Enable ICU support [auto]
0246   -pcre ................ Select used libpcre2 [system/qt/no]
0247   -pps ................. Enable PPS support [auto] (QNX only)
0248   -zlib ................ Select used zlib [system/qt]
0249 
0250   Logging backends:
0251     -journald .......... Enable journald support [no] (Unix only)
0252     -syslog ............ Enable syslog support [no] (Unix only)
0253     -slog2 ............. Enable slog2 support [auto] (QNX only)
0254 
0255 Network options:
0256 
0257   -ssl ................. Enable either SSL support method [auto]
0258   -no-openssl .......... Do not use OpenSSL [default on Apple and WinRT]
0259   -openssl-linked ...... Use OpenSSL and link to libssl [no]
0260   -openssl-runtime ..... Use OpenSSL and dynamically load libssl [auto]
0261   -schannel ............ Use Secure Channel [no] (Windows only)
0262   -securetransport ..... Use SecureTransport [auto] (Apple only)
0263 
0264   -sctp ................ Enable SCTP support [no]
0265 
0266   -libproxy ............ Enable use of libproxy [no]
0267   -system-proxies ...... Use system network proxies by default [yes]
0268 
0269 Gui, printing, widget options:
0270 
0271   -cups ................ Enable CUPS support [auto] (Unix only)
0272 
0273   -fontconfig .......... Enable Fontconfig support [auto] (Unix only)
0274   -freetype ............ Select used FreeType [system/qt/no]
0275   -harfbuzz ............ Select used HarfBuzz-NG [system/qt/no]
0276                          (Not auto-detected on Apple and Windows)
0277 
0278   -gtk ................. Enable GTK platform theme support [auto]
0279 
0280   -lgmon ............... Enable lgmon support [auto] (QNX only)
0281 
0282   -no-opengl ........... Disable OpenGL support
0283   -opengl <api> ........ Enable OpenGL support. Supported APIs:
0284                          es2 (default on Windows), desktop (default on Unix),
0285                          dynamic (Windows only)
0286   -opengles3 ........... Enable OpenGL ES 3.x support instead of ES 2.x [auto]
0287   -egl ................. Enable EGL support [auto]
0288   -angle ............... Use bundled ANGLE to support OpenGL ES 2.0 [auto]
0289                          (Windows only)
0290   -combined-angle-lib .. Merge LibEGL and LibGLESv2 into LibANGLE (Windows only)
0291 
0292   -qpa <name> .......... Select default QPA backend(s) (e.g., xcb, cocoa, windows)
0293                          A prioritized list separated by semi-colons.
0294   -xcb-xlib............. Enable Xcb-Xlib support [auto]
0295 
0296   Platform backends:
0297     -direct2d .......... Enable Direct2D support [auto] (Windows only)
0298     -directfb .......... Enable DirectFB support [no] (Unix only)
0299     -eglfs ............. Enable EGLFS support [auto; no on Android and Windows]
0300     -gbm ............... Enable backends for GBM [auto] (Linux only)
0301     -kms ............... Enable backends for KMS [auto] (Linux only)
0302     -linuxfb ........... Enable Linux Framebuffer support [auto] (Linux only)
0303     -xcb ............... Enable X11 support [auto] (Linux only)
0304 
0305   Input backends:
0306     -libudev............ Enable udev support [auto]
0307     -evdev ............. Enable evdev support [auto]
0308     -imf ............... Enable IMF support [auto] (QNX only)
0309     -libinput .......... Enable libinput support [auto]
0310     -mtdev ............. Enable mtdev support [auto]
0311     -tslib ............. Enable tslib support [auto]
0312     -bundled-xcb-xinput  Use bundled XInput2 support [auto]
0313     -xkbcommon ......... Enable key mapping support [auto]
0314 
0315   Image formats:
0316     -gif ............... Enable reading support for GIF [auto]
0317     -ico ............... Enable support for ICO [yes]
0318     -libpng ............ Select used libpng [system/qt/no]
0319     -libjpeg ........... Select used libjpeg [system/qt/no]
0320 
0321 Database options:
0322 
0323   -sql-<driver> ........ Enable SQL <driver> plugin. Supported drivers:
0324                          db2 ibase mysql oci odbc psql sqlite2 sqlite tds
0325                          [all auto]
0326   -sqlite .............. Select used sqlite3 [system/qt]