From ea8ba787abf49e540f651ee26010bb905c9a632b Mon Sep 17 00:00:00 2001 From: Joerg Bornemann Date: Wed, 1 Jul 2020 17:42:07 +0200 Subject: CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor --- cmake/configure-cmake-mapping.md | 161 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 161 insertions(+) create mode 100644 cmake/configure-cmake-mapping.md (limited to 'cmake/configure-cmake-mapping.md') diff --git a/cmake/configure-cmake-mapping.md b/cmake/configure-cmake-mapping.md new file mode 100644 index 0000000000..41ddec2960 --- /dev/null +++ b/cmake/configure-cmake-mapping.md @@ -0,0 +1,161 @@ +The following table describes the mapping of configure options to CMake arguments. +Note that not everything is implemented in configure/configure.bat yet. +The effort of this is tracked in QTBUG-85373 and QTBUG-85349. + +| configure | cmake | Notes | +|---------------------------------------|---------------------------------------------------|-----------------------------------------------------------------| +| -prefix /opt/qt6 | -DCMAKE_INSTALL_PREFIX=/opt/qta6 | | +| -extprefix /opt/qt6 | -DCMAKE_STAGING_PREFIX=/opt/qt6 | | +| -hostprefix /where/ever | n/a | When cross-building Qt, we do not build for host system anymore | +| -external-hostbindir /path/to/host/qt | -DQT_HOST_PATH=/path/to/host/qt | | +| -bindir | -DINSTALL_BINDIR= | similar for -headerdir -libdir and so on | +| -host*dir | n/a | | +| -help | | | +| -verbose | | | +| -continue | | | +| -redo | | | +| -recheck [test,...] | | | +| -feature-foo | -DFEATURE_foo=ON | | +| -no-feature-foo | -DFEATURE_foo=OFF | | +| -list-features | | At the moment: configure with cmake once, | +| | | then use ccmake or cmake-gui to inspect the features. | +| -list-libraries | | | +| -opensource | | | +| -commercial | | | +| -confirm-license | | | +| -release | | | +| -debug | | | +| -debug-and-release | | | +| -optimize-debug | | | +| -optimize-size | | | +| -optimized-tools | | | +| -force-debug-info | | | +| -separate-debug-info . | | | +| -gdb-index | | | +| -strip | | | +| -gc-binaries | | | +| -force-asserts | | | +| -developer-build | | | +| -shared | | | +| -static | | | +| -framework | | | +| -platform | | | +| -xplatform | -DQT_QMAKE_TARGET_MKSPEC= | Only used for generating qmake-compatibility files. | +| -device | equivalent to -xplatform devices/ | | +| -device-option | -DQT_QMAKE_DEVICE_OPTIONS=key1=value1;key2=value2 | Only used for generation qmake-compatibility files. | +| | | The device options are written into mkspecs/qdevice.pri. | +| -appstore-compliant | | | +| -qtnamespace | | | +| -qtlibinfix | | | +| -qtlibinfix-plugins | | | +| -testcocoon | | | +| -gcov | | | +| -trace [backend] | | | +| -sanitize {address | | | +| -coverage {trace-pc-gu | | | +| -c++std | | | +| -sse2 | | | +| -sse3/-ssse3/-sse4.1/- | | | +| -mips_dsp/-mips_dspr2 | | | +| -qreal | | | +| -R | | | +| -rpath | | | +| -reduce-exports | | | +| -reduce-relocations | | | +| -plugin-manifests | | | +| -static-runtime | | | +| -pch | | | +| -ltcg | | | +| -linker [bfd,gold,lld] | | | +| -incredibuild-xge | | | +| -ccache | -DQT_USE_CCACHE=ON | | +| -make-tool | n/a | | +| -mp | n/a | | +| -warnings-are-errors | -DWARNINGS_ARE_ERRORS=ON | | +| -silent | | | +| -sysroot | -DCMAKE_SYSROOT= | Should be provided by a toolchain file that's | +| | | passed via -DCMAKE_TOOLCHAIN_FILE= | +| -gcc-sysroot | | | +| -pkg-config | | | +| -D | | | +| -I | | | +| -L | | | +| -F | | | +| -sdk | | | +| -android-sdk path | | | +| -android-ndk path | | | +| -android-ndk-platform | | | +| -android-ndk-host | | | +| -android-abis | | | +| -android-style-assets | | | +| mponent selection: | | | +| -skip | | | +| -make | | | +| -nomake | | | +| -compile-examples | | | +| -gui | | | +| -widgets | | | +| -no-dbus | | | +| -dbus-linked | | | +| -dbus-runtime | | | +| -accessibility | | | +| -skip | | | +| -make | | | +| -nomake | | | +| -compile-examples | | | +| -gui | | | +| -widgets | | | +| -no-dbus | | | +| -dbus-linked | | | +| -dbus-runtime | | | +| -accessibility | | | +| -doubleconversion | | | +| -glib | | | +| -eventfd | | | +| -inotify | | | +| -icu | | | +| -pcre | | | +| -pps | | | +| -zlib | | | +| -ssl | | | +| -no-openssl | | | +| -openssl-linked | | | +| -openssl-runtime | | | +| -schannel | | | +| -securetransport | | | +| -sctp | | | +| -libproxy | | | +| -system-proxies | | | +| -cups | | | +| -fontconfig | | | +| -freetype | | | +| -harfbuzz | | | +| -gtk | | | +| -lgmon | | | +| -no-opengl | | | +| -opengl | | | +| -opengles3 | | | +| -egl | | | +| -qpa | | | +| -xcb-xlib | | | +| -direct2d | | | +| -directfb | | | +| -eglfs | | | +| -gbm | | | +| -kms | | | +| -linuxfb | | | +| -xcb | | | +| -libudev | | | +| -evdev | | | +| -imf | | | +| -libinput | | | +| -mtdev | | | +| -tslib | | | +| -bundled-xcb-xinput | | | +| -xkbcommon | | | +| -gif | | | +| -ico | | | +| -libpng | | | +| -libjpeg | | | +| -sql- | | | +| -sqlite | | | -- cgit v1.2.3