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>

4 files changed, 33 insertions, 13 deletions

diff --git a/doc/qtcreator/src/howto/creator-only/creator-cli.qdoc b/doc/qtcreator/src/howto/creator-only/creator-cli.qdoc
index fbc885df05..2d820d0d7f 100644
--- a/doc/qtcreator/src/howto/creator-only/creator-cli.qdoc
+++ b/doc/qtcreator/src/howto/creator-only/creator-cli.qdoc
@@ -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
diff --git a/doc/qtcreator/src/howto/creator-only/creator-how-to-find-settings-files.qdoc b/doc/qtcreator/src/howto/creator-only/creator-how-to-find-settings-files.qdoc
index 8bfb773a40..81bc78e307 100644
--- a/doc/qtcreator/src/howto/creator-only/creator-how-to-find-settings-files.qdoc
+++ b/doc/qtcreator/src/howto/creator-only/creator-how-to-find-settings-files.qdoc
@@ -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}
 */
diff --git a/doc/qtcreator/src/howto/creator-only/qtcreator-faq.qdoc b/doc/qtcreator/src/howto/creator-only/qtcreator-faq.qdoc
index 7126aee0cc..6d199ceb01 100644
--- a/doc/qtcreator/src/howto/creator-only/qtcreator-faq.qdoc
+++ b/doc/qtcreator/src/howto/creator-only/qtcreator-faq.qdoc
@@ -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.
diff --git a/doc/qtcreator/src/projects/creator-only/creator-how-to-add-wizards.qdoc b/doc/qtcreator/src/projects/creator-only/creator-how-to-add-wizards.qdoc
index fa7663f02d..e6cb582b9b 100644
--- a/doc/qtcreator/src/projects/creator-only/creator-how-to-add-wizards.qdoc
+++ b/doc/qtcreator/src/projects/creator-only/creator-how-to-add-wizards.qdoc
@@ -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}
 */