diff --git a/cmake/README.md b/cmake/README.md
index 864d0998b5a..65be11666d3 100644
--- a/cmake/README.md
+++ b/cmake/README.md
@@ -56,6 +56,8 @@ The basic way of building with cmake is as follows:
cmake --install .
```
+The mapping of configure options to CMake arguments is described [here](configure-cmake-mapping.md).
+
You need one build directory per Qt module. The build directory can be a sub-directory inside the
module ``qtbase/build`` or an independent directory ``qtbase_build``. The installation prefix is
chosen when running cmake by passing ``-DCMAKE_INSTALL_PREFIX``. To build more than one Qt module,
diff --git a/cmake/configure-cmake-mapping.md b/cmake/configure-cmake-mapping.md
new file mode 100644
index 00000000000..41ddec29609
--- /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 | | |