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
\li -installsettingspath <path>
\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
\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
/*!
@@ -7,9 +7,9 @@
\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
\li QtCreator.db
@@ -29,4 +29,32 @@
\li On Windows, look in
\c {%appdata%\QtProject} and \c {%localappdata%\QtProject}.
\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
\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?}
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.
\endlist
\sa {Custom Wizards}, {Find settings files}
\sa {Run Qt Creator from the command line}, {Custom Wizards}
*/