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]