diff options
| author | Alexandru Croitor <alexandru.croitor@qt.io> | 2019-05-02 17:26:19 +0200 |
|---|---|---|
| committer | Alexandru Croitor <alexandru.croitor@qt.io> | 2019-05-02 15:49:39 +0000 |
| commit | b26a52ec4874f707f6980b4c47592425c68d1360 (patch) | |
| tree | 5c21f35760db826ce0c22db4c05e23980e4c09b0 /cmake | |
| parent | 43c2580e5d607ca1a5642987d1b0bed17574e6db (diff) | |
Update readme to mention how to set feature flags
Change-Id: If63d37af4711c4332129d65b934269c33f041ea4
Reviewed-by: Simon Hausmann <simon.hausmann@qt.io>
Diffstat (limited to 'cmake')
| -rw-r--r-- | cmake/README.md | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/cmake/README.md b/cmake/README.md index 4a21e5f783..57f87e0d84 100644 --- a/cmake/README.md +++ b/cmake/README.md @@ -91,6 +91,12 @@ Make sure to remove CMakeCache.txt if you forgot to set the CMAKE_INSTALL_PREFIX You can use ``cmake-gui {path to build directory}`` or ``ccmake {path to build directory}`` to configure the values of individual cmake variables or Qt features. After changing a value, you need to choose the *configure* step (usually several times:-/), followed by the *generate* step (to generate makefiles/ninja files). +## Specifying configure.json features on the command line + +QMake defines most features in configure.json files, like -developer-build or -no-opengl. + +In CMake land, we currently generate configure.cmake files from the configure.json files. If the feature in configure.json has the name "dlopen", you can specify whether to enable or disable that feature in CMake with a -D flag on the CMake command line. So for example -DFEATURE_dlopen=ON or -DFEATURE_sql_mysql=OFF. At the moment, if you change a FEATURE flag's value, you have to remove the CMakeCache.txt file and reconfigure with CMake. And even then you might stumble on some issues when reusing an existing build, because of an automoc bug in upstream CMake. + ## Ninja reconfiguration bug If you use the Ninja generator, there's a bug that after the first CMake configuration, if you run ninja, it will do the reconfiguration step again. This is quite annoying and time consuming. |