Doc: Make finding settings about resetting them

Combine "Find settings files" with the FAQ question about
resetting settings and add the related CLI commands.

Change-Id: I544e863407c6eb925772f00527b1ebb9edee47ed
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
This commit is contained in:
Leena Miettinen
2024-05-15 10:47:11 +02:00
parent ea9f7f27fe
commit 19355ccfe3
4 changed files with 33 additions and 13 deletions

View File

@@ -93,7 +93,7 @@
\row \row
\li -installsettingspath <path> \li -installsettingspath <path>
\li Override the default path from where user-independent settings are read \li Override the default path from where user-independent settings are read
(for example written by the installer). (for example, those written by the installer).
\row \row
\li -temporarycleansettings, -tcs \li -temporarycleansettings, -tcs

View File

@@ -1,4 +1,4 @@
// Copyright (C) 2023 The Qt Company Ltd. // Copyright (C) 2024 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*! /*!
@@ -7,9 +7,9 @@
\ingroup creator-how-to-use \ingroup creator-how-to-use
\title Find settings files \title Reset \QC settings
\QC creates the following files and directories: To reset all \QC settings, remove the settings files that it creates:
\list \list
\li QtCreator.db \li QtCreator.db
@@ -29,4 +29,32 @@
\li On Windows, look in \li On Windows, look in
\c {%appdata%\QtProject} and \c {%localappdata%\QtProject}. \c {%appdata%\QtProject} and \c {%localappdata%\QtProject}.
\endlist \endlist
To check whether the settings are causing a problem before resetting them,
start \QC from the command line with options.
\section1 Override the default settings path
To override the default path where user settings are stored, enter:
\badcode
qtcreator -settingspath <path>
\endcode
To override the default path from where user-independent settings are read
(for example, those written by the installer), enter:
\badcode
qtcreator -installsettingspath <path>
\endcode
\section1 Start \QC with temporary clean settings
To use clean settings that are deleted when you quit \QC, enter:
\badcode
qtcreator -tcs
\endcode
\sa {Run Qt Creator from the command line}
*/ */

View File

@@ -18,14 +18,6 @@
\section1 General Questions \section1 General Questions
\b {How do I reset all \QC settings?}
Remove the settings files created by \QC.
For more information about where the files are located on each supported
platform, see \l {Find settings files}.
\b {\QC comes with \MinGW, should I use this version with Qt?} \b {\QC comes with \MinGW, should I use this version with Qt?}
Use the version that was built against the Qt version. Use the version that was built against the Qt version.

View File

@@ -44,5 +44,5 @@
to specify the position of the wizard. For example, \c B.MyClass. to specify the position of the wizard. For example, \c B.MyClass.
\endlist \endlist
\sa {Custom Wizards}, {Find settings files} \sa {Run Qt Creator from the command line}, {Custom Wizards}
*/ */