"Fossies" - the Fresh Open Source Software Archive

Member "qt-everywhere-src-6.3.1/qtbase/config_help.txt" (25 May 2022, 14769 Bytes) of package /linux/misc/qt-everywhere-src-6.3.1.tar.xz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 Usage:  configure [options] [-- cmake-options]
    2 
    3 This is a convenience script for configuring Qt with CMake.
    4 Options after the double dash are directly passed to CMake.
    5 
    6 Top-level installation directories:
    7   -prefix <dir> ...... The deployment directory, as seen on the target device.
    8                        [/usr/local/Qt-$QT_VERSION; qtbase build directory if
    9                        -developer-build]
   10   -no-prefix ......... The deployment directory is set to the qtbase build
   11                        directory. Can be used instead of -developer-build
   12                        to not have to install, as well as avoid
   13                        -developer-build's default of -warnings-are-errors.
   14   -extprefix <dir> ... The installation directory, as seen on the host machine.
   15                        [SYSROOT/PREFIX]
   16 
   17 Fine tuning of installation directory layout. Note that all directories
   18 except -sysconfdir should be located under -prefix:
   19 
   20   -bindir <dir> ......... Executables [PREFIX/bin]
   21   -headerdir <dir> ...... Header files [PREFIX/include]
   22   -libdir <dir> ......... Libraries [PREFIX/lib]
   23   -archdatadir <dir> .... Arch-dependent data [PREFIX]
   24   -plugindir <dir> ...... Plugins [ARCHDATADIR/plugins]
   25   -libexecdir <dir> ..... Helper programs [ARCHDATADIR/bin on Windows,
   26                           ARCHDATADIR/libexec otherwise]
   27   -qmldir <dir> ......... QML imports [ARCHDATADIR/qml]
   28   -datadir <dir> ........ Arch-independent data [PREFIX]
   29   -docdir <dir> ......... Documentation [DATADIR/doc]
   30   -translationdir <dir> . Translations [DATADIR/translations]
   31   -sysconfdir <dir> ..... Settings used by Qt programs [PREFIX/etc/xdg]
   32   -examplesdir <dir> .... Examples [PREFIX/examples]
   33   -testsdir <dir> ....... Tests [PREFIX/tests]
   34   -hostdatadir <dir> .... Data used by qmake [PREFIX]
   35 
   36 Conventions for the remaining options: When an option's description is
   37 followed by a list of values in brackets, the interpretation is as follows:
   38 'yes' represents the bare option; all other values are possible prefixes to
   39 the option, e.g., -no-gui. Alternatively, the value can be assigned, e.g.,
   40 --gui=yes. Values are listed in the order they are tried if not specified;
   41 'auto' is a shorthand for 'yes/no'. Solitary 'yes' and 'no' represent binary
   42 options without auto-detection.
   43 
   44 Configure meta:
   45 
   46   -help, -h ............ Display this help screen
   47   -redo ................ Re-configure with previously used options.
   48                          Additional options may be passed, but will not be
   49                          saved for later use by -redo.
   50 
   51   -feature-<feature> ... Enable <feature>
   52   -no-feature-<feature>  Disable <feature> [none]
   53   -list-features ....... List available features. Note that some features
   54                          have dedicated command line options as well.
   55 
   56 Build options:
   57 
   58   -cmake-generator <name> ... Explicitly specify the build system generator for
   59                          CMake instead of auto-detecting one.
   60   -cmake-use-default-generator ... Turn off auto-detection of the CMake build
   61                          system generator.
   62   -cmake-file-api ...... Let CMake store build metadata for loading the build
   63                          into an IDE. [no; yes if -developer-build]
   64   -no-guess-compiler ... Do not guess the compiler from the target mkspec.
   65   -release ............. Build Qt with debugging turned off [yes]
   66   -debug ............... Build Qt with debugging turned on [no]
   67   -debug-and-release ... Build two versions of Qt, with and without
   68                          debugging turned on [yes] (Apple and Windows only)
   69   -optimize-debug ...... Enable debug-friendly optimizations in debug builds
   70                          [auto] (Not supported with MSVC or Clang toolchains)
   71   -optimize-size ....... Optimize release builds for size instead of speed [no]
   72   -force-debug-info .... Create symbol files for release builds [no]
   73   -separate-debug-info . Split off debug information to separate files [no]
   74   -gdb-index ........... Index the debug info to speed up GDB
   75                          [no; auto if -developer-build with debug info]
   76   -gc-binaries ......... Place each function or data item into its own section
   77                          and enable linker garbage collection of unused
   78                          sections. [auto for static builds, otherwise no]
   79   -force-asserts ....... Enable Q_ASSERT even in release builds [no]
   80   -developer-build ..... Compile and link Qt for developing Qt itself
   81                          (exports for auto-tests, extra checks, etc.) [no]
   82 
   83   -shared .............. Build shared Qt libraries [yes] (no for UIKit)
   84   -static .............. Build static Qt libraries [no] (yes for UIKit)
   85   -framework ........... Build Qt framework bundles [yes] (Apple only)
   86 
   87   -platform <target> ... Select mkspec for the qmake companion files
   88   -device <name> ....... Select devices/mkspec for the qmake companion files
   89   -device-option <key=value> ... Add option for the device mkspec
   90 
   91   -appstore-compliant .. Disable code that is not allowed in platform app stores.
   92                          This is on by default for platforms which require distribution
   93                          through an app store by default, in particular Android,
   94                          iOS, tvOS, and watchOS. [auto]
   95 
   96   -qt-host-path <path> . Specify path to a Qt host build for cross-compiling.
   97   -qtnamespace <name> .. Wrap all Qt library code in 'namespace <name> {...}'.
   98   -qtlibinfix <infix> .. Rename all libQt6*.so to libQt6*<infix>.so.
   99 
  100   -testcocoon .......... Instrument with the TestCocoon code coverage tool [no]
  101   -gcov ................ Instrument with the GCov code coverage tool [no]
  102 
  103   -trace [backend] ..... Enable instrumentation with tracepoints.
  104                          Currently supported backends are 'etw' (Windows) and
  105                          'lttng' (Linux), or 'yes' for auto-detection. [no]
  106 
  107   -sanitize {address|thread|memory|fuzzer-no-link|undefined}
  108                          Instrument with the specified compiler sanitizer.
  109                          Note that some sanitizers cannot be combined;
  110                          for example, -sanitize address cannot be combined with
  111                          -sanitize thread.
  112 
  113   -c++std <edition> .... Select C++ standard <edition> [c++20/c++17/c++14/c++11]
  114 
  115   -sse2 ................ Use SSE2 instructions [auto]
  116   -sse3/-ssse3/-sse4.1/-sse4.2/-avx/-avx2/-avx512
  117                          Enable use of particular x86 instructions [auto]
  118                          Enabled ones are still subject to runtime detection.
  119   -mips_dsp/-mips_dspr2  Use MIPS DSP/rev2 instructions [auto]
  120 
  121   -qreal <type> ........ typedef qreal to the specified type. [double]
  122                          Note: this affects binary compatibility.
  123 
  124   -R <string> .......... Add an explicit runtime library path to the Qt
  125                          libraries. Supports paths relative to LIBDIR.
  126   -rpath ............... Link Qt libraries and executables using the library
  127                          install path as a runtime library path. Similar to
  128                          -R LIBDIR. On Apple platforms, disabling this implies
  129                          using absolute install names (based in LIBDIR) for
  130                          dynamic libraries and frameworks. [auto]
  131 
  132   -reduce-exports ...... Reduce amount of exported symbols [auto]
  133   -reduce-relocations .. Reduce amount of relocations [auto] (Unix only)
  134 
  135   -plugin-manifests .... Embed manifests into plugins [no] (Windows only)
  136   -static-runtime ...... With -static, use static runtime [no] (Windows only)
  137 
  138   -pch ................. Use precompiled headers [auto]
  139   -ltcg ................ Use Link Time Code Generation [no]
  140   -linker [bfd,gold,lld,mold]
  141                          Force use of the GNU ld, GNU gold, LLVM/LLD or mold
  142                          linker instead of default one (GCC and clang only)
  143   -ccache .............. Use the ccache compiler cache [no] (Unix only)
  144 
  145   -warnings-are-errors . Treat warnings as errors [no; yes if -developer-build]
  146 
  147 Build environment:
  148 
  149   -sysroot <dir> ....... Set <dir> as the target sysroot
  150 
  151   -pkg-config .......... Use pkg-config [auto] (Unix only)
  152 
  153   -D <string> .......... Pass additional preprocessor define
  154   -I <string> .......... Pass additional include path
  155   -L <string> .......... Pass additional library path
  156   -F <string> .......... Pass additional framework path (Apple only)
  157 
  158   -sdk <sdk> ........... Build Qt using Apple provided SDK <sdk>. The argument
  159                          should be one of the available SDKs as listed by
  160                          'xcodebuild -showsdks'.
  161 
  162   -android-sdk path .... Set Android SDK root path [$ANDROID_SDK_ROOT]
  163   -android-ndk path .... Set Android NDK root path [$ANDROID_NDK_ROOT]
  164   -android-ndk-platform  Set Android platform
  165   -android-abis .......  Only one ABI can be specified, default is: armeabi-v7a
  166   -android-javac-target  Set the javac build target version [8]
  167   -android-javac-source  Set the javac build source version [8]
  168   -android-style-assets  Automatically extract style assets from the device at
  169                          run time. This option makes the Android style behave
  170                          correctly, but also makes the Android platform plugin
  171                          incompatible with the LGPL2.1. [yes]
  172 
  173 Component selection:
  174 
  175   -submodules <repo>[,<repo>] ... Build the listed repositories and those they
  176                          depend on rather than all checked-out repositories.
  177                          The list should be separated with commas, e.g.
  178                          -submodules qtsvg,qtnetworkauth
  179                          [default is to build all checked out repositories]
  180   -skip <repo>[,<repo>]  Exclude one or more entire repositories from the
  181                          build. The list should be separated with commas.
  182                          e.g. -skip qtimageformats,qtsvg
  183   -make <part> ......... Add <part> to the list of parts to be built.
  184                          Specifying this option clears the default list first.
  185                          (allowed values: libs, tools, examples, tests,
  186                          benchmarks, manual-tests, minimal-static-tests)
  187                          [default: libs and examples, also tools if not
  188                          cross-building, also tests if -developer-build]
  189   -nomake <part> ....... Exclude <part> from the list of parts to be built.
  190   -gui ................. Build the Qt GUI module and dependencies [yes]
  191   -widgets ............. Build the Qt Widgets module and dependencies [yes]
  192   -no-dbus ............. Do not build the Qt D-Bus module
  193                          [default on Android and Windows]
  194   -dbus-linked ......... Build Qt D-Bus and link to libdbus-1 [auto]
  195   -dbus-runtime ........ Build Qt D-Bus and dynamically load libdbus-1 [no]
  196   -accessibility ....... Enable accessibility support [yes]
  197                          Note: Disabling accessibility is not recommended.
  198 
  199 Qt comes with bundled copies of some 3rd party libraries. These are used
  200 by default if auto-detection of the respective system library fails.
  201 
  202 Core options:
  203 
  204   -doubleconversion .... Select used double conversion library [system/qt/no]
  205                          No implies use of sscanf_l and snprintf_l (imprecise).
  206   -glib ................ Enable Glib support [no; auto on Unix]
  207   -eventfd ............. Enable eventfd support
  208   -inotify ............. Enable inotify support
  209   -icu ................. Enable ICU support [auto]
  210   -pcre ................ Select used libpcre2 [system/qt/no]
  211   -zlib ................ Select used zlib [system/qt]
  212 
  213   Logging backends:
  214     -journald .......... Enable journald support [no] (Unix only)
  215     -syslog ............ Enable syslog support [no] (Unix only)
  216     -slog2 ............. Enable slog2 support [auto] (QNX only)
  217 
  218 Network options:
  219 
  220   -ssl ................. Enable either SSL support method [auto]
  221   -no-openssl .......... Do not use OpenSSL [default on Apple]
  222   -openssl-linked ...... Use OpenSSL and link to libssl [no]
  223   -openssl-runtime ..... Use OpenSSL and dynamically load libssl [auto]
  224   -schannel ............ Use Secure Channel [auto] (Windows only)
  225   -securetransport ..... Use SecureTransport [auto] (Apple only)
  226 
  227   -sctp ................ Enable SCTP support [no]
  228 
  229   -libproxy ............ Enable use of libproxy [no]
  230   -system-proxies ...... Use system network proxies by default [yes]
  231 
  232 Gui, printing, widget options:
  233 
  234   -cups ................ Enable CUPS support [auto] (Unix only)
  235 
  236   -fontconfig .......... Enable Fontconfig support [auto] (Unix only)
  237   -freetype ............ Select used FreeType [system/qt/no]
  238   -harfbuzz ............ Select used HarfBuzz-NG [system/qt/no]
  239                          (Not auto-detected on Apple and Windows)
  240 
  241   -gtk ................. Enable GTK platform theme support [auto]
  242 
  243   -no-opengl ........... Disable OpenGL support
  244   -opengl <api> ........ Enable OpenGL support. Supported APIs:
  245                          es2, desktop (default on Unix),
  246                          dynamic (Windows only, default on Windows)
  247   -opengles3 ........... Enable OpenGL ES 3.x support instead of ES 2.x [auto]
  248   -egl ................. Enable EGL support [auto]
  249 
  250   -qpa <name> .......... Select default QPA backend(s) (e.g., xcb, cocoa, windows)
  251                          A prioritized list separated by semi-colons.
  252   -xcb-xlib............. Enable Xcb-Xlib support [auto]
  253 
  254   Platform backends:
  255     -direct2d .......... Enable Direct2D support [auto] (Windows only)
  256     -directfb .......... Enable DirectFB support [no] (Unix only)
  257     -eglfs ............. Enable EGLFS support [auto; no on Android and Windows]
  258     -gbm ............... Enable backends for GBM [auto] (Linux only)
  259     -kms ............... Enable backends for KMS [auto] (Linux only)
  260     -linuxfb ........... Enable Linux Framebuffer support [auto] (Linux only)
  261     -xcb ............... Enable X11 support [auto] (Linux only)
  262 
  263   Input backends:
  264     -libudev............ Enable udev support [auto]
  265     -evdev ............. Enable evdev support [auto]
  266     -libinput .......... Enable libinput support [auto]
  267     -mtdev ............. Enable mtdev support [auto]
  268     -tslib ............. Enable tslib support [auto]
  269     -bundled-xcb-xinput  Use bundled XInput2 support [auto]
  270     -xkbcommon ......... Enable key mapping support [auto]
  271 
  272   Image formats:
  273     -gif ............... Enable reading support for GIF [auto]
  274     -ico ............... Enable support for ICO [yes]
  275     -libpng ............ Select used libpng [system/qt/no]
  276     -libjpeg ........... Select used libjpeg [system/qt/no]
  277 
  278 Database options:
  279 
  280   -sql-<driver> ........ Enable SQL <driver> plugin. Supported drivers:
  281                          db2 ibase mysql oci odbc psql sqlite
  282                          [all auto]
  283   -sqlite .............. Select used sqlite [system/qt]