Doc: Update CMake build settings

- Describe context menu options for syncing configurations
- Describe options for getting help on variables and options

Task-number: QTCREATORBUG-26983
Change-Id: Ide88172bc2e8032434ee657a9995528b6917a871
Reviewed-by: Cristian Adam <cristian.adam@qt.io>
This commit is contained in:
Leena Miettinen
2022-02-10 14:34:29 +01:00
parent 9e0b7a0d60
commit 756a67c563
3 changed files with 13 additions and 8 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 22 KiB

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 7.5 KiB

After

Width:  |  Height:  |  Size: 7.4 KiB

View File

@@ -41,15 +41,16 @@
You can view and edit the actual values of the variables that are passed You can view and edit the actual values of the variables that are passed
to CMake. Variable names are listed in the \uicontrol Key column and their to CMake. Variable names are listed in the \uicontrol Key column and their
current values in the \uicontrol Value column. For more information current values in the \uicontrol Value column. For more information about
about the available variables, see \l{CMake: cmake-variables(7)}. the available variables, select \uicontrol Help in the context menu or see
For more information about Qt-specific variables, see \l{CMake: cmake-variables(7)}. For more information about Qt-specific
\l{CMake Variable Reference}. variables, see \l{CMake Variable Reference}.
You can specify additional CMake options, such as \c {--find-debug}, You can specify additional CMake options, such as \c {--find-debug},
\c {--preset}, \c {--trace-expand}, or \c {--warn-uninitialized}, in \c {--preset}, \c {--trace-expand}, or \c {--warn-uninitialized}, in
\uicontrol {Additional CMake options}. For more information about \uicontrol {Additional CMake options}. For more information about
the available options, see \l{CMake: cmake(1)}. the available options, click the link in the field name or see
\l{CMake: cmake(1)}.
After successfully running CMake, you can view and modify the current After successfully running CMake, you can view and modify the current
configuration in \uicontrol {Current Configuration}. configuration in \uicontrol {Current Configuration}.
@@ -97,7 +98,10 @@
select \uicontrol Copy in the context menu. select \uicontrol Copy in the context menu.
To modify the value of a variable, double-click it, or select it, To modify the value of a variable, double-click it, or select it,
and then select \uicontrol Edit. and then select \uicontrol Edit. If the initial, current, and kit
configuration get out of sync, select \uicontrol {Apply Kit Value} or
\uicontrol {Apply Initial Configuration Value} in the context menu in
\uicontrol {Initial Configuration} or \uicontrol {Current Configuration}.
You can apply actions to multiple variables at a time. To clear You can apply actions to multiple variables at a time. To clear
the selection, select \uicontrol {Clear Selection}. the selection, select \uicontrol {Clear Selection}.
@@ -194,8 +198,9 @@
\image qtcreator-cmake-generator.png "CMake Generator dialog" \image qtcreator-cmake-generator.png "CMake Generator dialog"
\li In \uicontrol Generator, select \uicontrol Ninja. \li In \uicontrol Generator, select \uicontrol Ninja.
\li Select \uicontrol OK to save your changes and close the dialog. \li Select \uicontrol OK to save your changes and close the dialog.
\li Close the \uicontrol {Kit CMake Configuration} dialog to return to \li Select \uicontrol Close to close the
\uicontrol {Build Settings}. \uicontrol {Kit CMake Configuration} dialog
and return to \uicontrol {Build Settings}.
\endlist \endlist
\note To make sure that old build artifacts don't get in the way \note To make sure that old build artifacts don't get in the way