diff --git a/doc/qtcreator/images/qtcreator-android-cmake-settings.png b/doc/qtcreator/images/qtcreator-android-cmake-settings.png index 7f8026bccab..e02c77c38bc 100644 Binary files a/doc/qtcreator/images/qtcreator-android-cmake-settings.png and b/doc/qtcreator/images/qtcreator-android-cmake-settings.png differ diff --git a/doc/qtcreator/images/qtcreator-cmake-build-settings.png b/doc/qtcreator/images/qtcreator-cmake-build-settings.png index c5da0555aaa..33be38d67c7 100644 Binary files a/doc/qtcreator/images/qtcreator-cmake-build-settings.png and b/doc/qtcreator/images/qtcreator-cmake-build-settings.png differ diff --git a/doc/qtcreator/images/qtcreator-cmake-build-steps.png b/doc/qtcreator/images/qtcreator-cmake-build-steps.png index 5809136a85c..02784e47d20 100644 Binary files a/doc/qtcreator/images/qtcreator-cmake-build-steps.png and b/doc/qtcreator/images/qtcreator-cmake-build-steps.png differ diff --git a/doc/qtcreator/images/qtcreator-cmake-clean-steps.png b/doc/qtcreator/images/qtcreator-cmake-clean-steps.png index 88be99d715a..e04711c3a74 100644 Binary files a/doc/qtcreator/images/qtcreator-cmake-clean-steps.png and b/doc/qtcreator/images/qtcreator-cmake-clean-steps.png differ diff --git a/doc/qtcreator/images/qtcreator-cmakeexecutable.png b/doc/qtcreator/images/qtcreator-cmakeexecutable.png index 5c575887623..31f162d48b1 100755 Binary files a/doc/qtcreator/images/qtcreator-cmakeexecutable.png and b/doc/qtcreator/images/qtcreator-cmakeexecutable.png differ diff --git a/doc/qtcreator/images/qtcreator-kits-cmake.png b/doc/qtcreator/images/qtcreator-kits-cmake.png new file mode 100644 index 00000000000..9ccecb61db1 Binary files /dev/null and b/doc/qtcreator/images/qtcreator-kits-cmake.png differ diff --git a/doc/qtcreator/src/cmake/creator-projects-cmake-building.qdocinc b/doc/qtcreator/src/cmake/creator-projects-cmake-building.qdocinc index a31449984ce..d197facbc67 100644 --- a/doc/qtcreator/src/cmake/creator-projects-cmake-building.qdocinc +++ b/doc/qtcreator/src/cmake/creator-projects-cmake-building.qdocinc @@ -1,6 +1,6 @@ /**************************************************************************** ** -** Copyright (C) 2019 The Qt Company Ltd. +** Copyright (C) 2020 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the Qt Creator documentation. @@ -34,32 +34,45 @@ \section2 CMake Build Configuration + Configuring medium-sized to large CMake projects in \QC can be a + challenge due to the number of options that you need to pass to + CMake to configure the project correctly. \QC creates an initial + configuration for you based on the kit settings and displays it in + the \uicontrol {Initial CMake parameters} field. + \image qtcreator-cmake-build-settings.png - Setting names with a common prefix (up to the first underscore character) - are grouped under the prefix. To view all settings, select the - \uicontrol Advanced check box. + In the \uicontrol Value column, you can view and edit the actual values + of the parameters that are passed to CMake. Parameter names are listed + in the \uicontrol Key column. Names with a common prefix (up to the first + underscore character) are grouped under the prefix. To view all parameters, + select the \uicontrol Advanced check box. - To add build settings, select \uicontrol Add, and then select the type of - the setting that you are adding: \uicontrol Boolean, \uicontrol String, + To add parameters, select \uicontrol Add, and then select the type of + the parameter that you are adding: \uicontrol Boolean, \uicontrol String, \uicontrol Directory, or \uicontrol File. - To change the type of the selected setting, select + To change the type of the selected parameter, select \uicontrol {Force to bool}, \uicontrol {Force to file}, \uicontrol {Force to directory}, or \uicontrol {Force to string}. - To modify the value of a build setting, double-click it, or select it, + To modify the value of a parameter, double-click it, or select it, and then select \uicontrol Edit. To save the changes, select \uicontrol {Apply Configuration Changes}. Keep in mind that a configuration change might trigger a follow-up configuration change. - To remove a setting, select \uicontrol Unset. + To remove a parameter, select \uicontrol Unset. To reset the changes that you made, select \uicontrol Reset. - To reconfigure CMake, select \uicontrol Build > - \uicontrol {Clear CMake Configuration}, and then - select \uicontrol Build > \uicontrol {Rescan Project}. + The parameter values that you change are passed via \c -D