Doc: Update info about environment settings

They are now edited in an editor next to the variable list.

Task-number: QTCREATORBUG-30209
Change-Id: I8eb46272a2b4b3b92ebf93247f4ef33ee4114b6f
Reviewed-by: Christian Kandeler <christian.kandeler@qt.io>
This commit is contained in:
Leena Miettinen
2024-03-05 09:51:37 +01:00
parent 9bb85fabf7
commit 681d2da3b3
12 changed files with 38 additions and 37 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.7 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.6 KiB

After

Width:  |  Height:  |  Size: 68 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 4.6 KiB

After

Width:  |  Height:  |  Size: 6.4 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 28 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

View File

@@ -94,9 +94,9 @@
You can select several variables and apply an action to them. To clear You can select several variables and apply an action to them. To clear
the selection, click anywhere in the view. the selection, click anywhere in the view.
To change the environment variable values for the CMake build environment, To batch edit variable values, select \uicontrol {Batch Edit}.
select \uicontrol {Batch Edit}. For more information, see
\l{Batch edit environment settings}. \image qtcreator-edit-cmake-configuration.webp {Edit CMake Configuration dialog}
To build using the current configuration, select \uicontrol {Run CMake}. To build using the current configuration, select \uicontrol {Run CMake}.
While building, the button text changes to \uicontrol {Stop CMake}. Select While building, the button text changes to \uicontrol {Stop CMake}. Select

View File

@@ -117,7 +117,7 @@
\sa {Run QML files}, {Use external text editors}, {Use Qt Linguist} \sa {Run QML files}, {Use external text editors}, {Use Qt Linguist}
\if defined(qtcreator) \if defined(qtcreator)
\sa {Batch edit environment settings}, {Specify the environment for projects}, \sa {Edit environment settings}, {Specify the environment for projects},
{Use Qt Creator variables} {Use Qt Creator variables}
\endif \endif
*/ */

View File

@@ -49,5 +49,5 @@
\endlist \endlist
\sa {Enable and disable plugins}, {Search}{How To: Search}, \sa {Enable and disable plugins}, {Search}{How To: Search},
{Batch edit environment settings} {Edit environment settings}
*/ */

View File

@@ -152,7 +152,7 @@
\li Select \uicontrol Change to modify environment variable values for \li Select \uicontrol Change to modify environment variable values for
build environments in the \uicontrol {Edit Environment Changes} build environments in the \uicontrol {Edit Environment Changes}
dialog. For more information about how to add and remove variable dialog. For more information about how to add and remove variable
values, see \l{Batch edit environment settings}. values, see \l{Edit environment settings}.
\row \row
\li \uicontrol {Force UTF-8 MSVC compiler output} \li \uicontrol {Force UTF-8 MSVC compiler output}
\li Either switches the language of MSVC to English or keeps the \li Either switches the language of MSVC to English or keeps the

View File

@@ -16,7 +16,7 @@
By default, the environment in which \QC was started is used and modified By default, the environment in which \QC was started is used and modified
to include the Qt version. Depending on the selected Qt version, \QC to include the Qt version. Depending on the selected Qt version, \QC
automatically sets the necessary environment variables. You can edit automatically sets the necessary environment variables. You can edit
existing environment variables or add, reset and unset new variables existing environment variables or add, reset, and unset variables
based on your project requirements. based on your project requirements.
The final environment is specified separately for each kit. With The final environment is specified separately for each kit. With
@@ -35,7 +35,7 @@
To globally change the environment from the one in which \QC is started, To globally change the environment from the one in which \QC is started,
select \preferences > \uicontrol Environment > \uicontrol System, and then select \preferences > \uicontrol Environment > \uicontrol System, and then
select \uicontrol Change in the \uicontrol Environment field. select \uicontrol Change in \uicontrol Environment.
\image qtcreator-preferences-environment-system.webp "Environment preferences System tab" \image qtcreator-preferences-environment-system.webp "Environment preferences System tab"
@@ -47,42 +47,43 @@
\image qtcreator-projects-environment.webp {Environment tab in Project Settings} \image qtcreator-projects-environment.webp {Environment tab in Project Settings}
You can edit existing environment variables or add, reset, unset, or
temporarily disable variables.
\section1 Specify the build environment \section1 Specify the build environment
Specify the build environment to use for a kit in \uicontrol Projects > To specify the build environment to use for a kit, go to \uicontrol Projects
\uicontrol {Build Settings} > \uicontrol {Build Environment}. > \uicontrol {Build Settings} and select \uicontrol {Build Environment}.
\image qtcreator-build-environment.png {Build Environment section in Build Settings} \image qtcreator-build-environment.webp {Build Environment section in Build Settings}
To change the values of environment variables for the build environment,
select the variable and then select \uicontrol Edit. Enter the new value
in the editor on the righ side.
To add new variables, select \uicontrol {Add}.
\section2 Clear the build environment \section2 Clear the build environment
To build with a clean system environment, select the \uicontrol {Clear To build with a clean system environment, select
system environment} check box. \QC discards the current environment, and \uicontrol {Clear system environment}. \QC discards the current environment,
populates a clean system environment with the environment variables that and populates a clean system environment with the environment variables that
the compilers and tools need. Therefore, the environment is never totally the compilers and tools need. Therefore, the environment is never totally
empty, even after you clear it. empty, even after you clear it.
\section1 Specify the run environment \section1 Specify the run environment
\QC automatically selects the environment used for running the application \QC automatically selects the environment used for running the application
based on the \l{glossary-device}{device} type. You can edit the environment based on the \l{glossary-device}{device} type. To edit the environment
or select another environment in \uicontrol Projects > or select another environment, go to \uicontrol Projects >
\uicontrol {Run Settings} > \uicontrol {Environment}. \uicontrol {Run Settings} and select \uicontrol {Environment}.
You can edit existing environment variables or add, reset and unset new \image qtcreator-run-environment.webp {Environment section in Run Settings}
variables.
\image qtcreator-run-environment.png {Environment section in Run Settings}
When running on the desktop, the \uicontrol {Build Environment} is used by When running on the desktop, the \uicontrol {Build Environment} is used by
default, but you can also use the \uicontrol {System Environment} without the default, but you can also use the \uicontrol {System Environment} without the
additions made to the build environment. additions made to the build environment.
To modify the environment variable values for the run environment,
double-click environment variables or their values and change them inline,
or select \uicontrol {Batch Edit} to change several variable values at a
time.
\section2 Clean the run environment \section2 Clean the run environment
To run in a clean system environment, select \uicontrol {Clean Environment}. To run in a clean system environment, select \uicontrol {Clean Environment}.
@@ -107,32 +108,32 @@
\section2 Use device environment \section2 Use device environment
When running on a mobile device connected to the development host, \QC When you run applications on a mobile device connected to the computer, \QC
fetches information about the \uicontrol {Device Environment} from the device. fetches information about the \uicontrol {Device Environment} from the device.
Usually, it does not make sense to edit the device environment. Usually, it does not make sense to edit the device environment.
\sa {Batch edit environment settings}, {Configure projects for building}, \sa {Edit environment settings}, {Configure projects for building},
{Configure projects for running}, {Use Qt Creator variables} {Configure projects for running}, {Use Qt Creator variables}
*/ */
/*! /*!
\page creator-how-to-batch-edit-environment-settings.html \page creator-how-to-edit-environment-settings.html
\previouspage creator-how-tos.html \previouspage creator-how-tos.html
\ingroup creator-how-to-projects \ingroup creator-how-to-projects
\title Batch edit environment settings \title Edit environment settings
You can change the environment variable values for build or run environments You can change the environment variable values for build or run environments
either for a particular project or globally for all projects in the either for a particular project or globally:
\uicontrol {Edit Environment} dialog:
\list \list
\li To change values globally, select \uicontrol Change in the \li To change values globally, go to \preferences >
\l {Globally change the environment}{global environment preferences}. \uicontrol Environment > \uicontrol System, and select
\li To change values for a project, select \uicontrol {Batch Edit} in the \uicontrol Change in \uicontrol {Environment}.
\l {Change the environment for a project}{project}, \li To change values for a project, select \uicontrol Edit or
\l {Specify the build environment}{build}, or \uicontrol {Add} in the \l {Change the environment for a project}
{project}, \l {Specify the build environment}{build}, or
\l {Specify the run environment}{run} environment settings. \l {Specify the run environment}{run} environment settings.
\endlist \endlist