diff --git a/doc/qtcreator/config/style/qt5-sidebar.html b/doc/qtcreator/config/style/qt5-sidebar.html
index 48111154eb8..9f272e3a7a8 100644
--- a/doc/qtcreator/config/style/qt5-sidebar.html
+++ b/doc/qtcreator/config/style/qt5-sidebar.html
@@ -101,7 +101,8 @@
- Using the Help Mode
- FAQ
- - How-tos
+ - How-to
+ - Reference
- Known Issues
- Glossary
- Technical Support
diff --git a/doc/qtcreator/src/howto/creator-how-to-macos.qdoc b/doc/qtcreator/src/howto/creator-how-to-macos.qdoc
index 166fb4517af..639fb08f27f 100644
--- a/doc/qtcreator/src/howto/creator-how-to-macos.qdoc
+++ b/doc/qtcreator/src/howto/creator-how-to-macos.qdoc
@@ -5,7 +5,7 @@
\page creator-how-to-macos.html
\if defined(qtcreator)
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\endif
\ingroup creator-how-to-ui
\ingroup studio-how-to
diff --git a/doc/qtcreator/src/howto/creator-how-to-set-high-dpi-scaling.qdoc b/doc/qtcreator/src/howto/creator-how-to-set-high-dpi-scaling.qdoc
index 849a4dbff52..a52be5210fb 100644
--- a/doc/qtcreator/src/howto/creator-how-to-set-high-dpi-scaling.qdoc
+++ b/doc/qtcreator/src/howto/creator-how-to-set-high-dpi-scaling.qdoc
@@ -5,7 +5,7 @@
\page creator-how-to-set-high-dpi-scaling.html
\if defined(qtcreator)
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\endif
\ingroup creator-how-to-ui
\ingroup studio-how-to
diff --git a/doc/qtcreator/src/howto/creator-how-to-switch-ui-themes.qdoc b/doc/qtcreator/src/howto/creator-how-to-switch-ui-themes.qdoc
index c03a50cf930..69fd7efef26 100644
--- a/doc/qtcreator/src/howto/creator-how-to-switch-ui-themes.qdoc
+++ b/doc/qtcreator/src/howto/creator-how-to-switch-ui-themes.qdoc
@@ -5,7 +5,7 @@
\page creator-how-to-switch-ui-themes.html
\if defined(qtcreator)
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\endif
\ingroup creator-how-to-ui
\ingroup studio-how-to
diff --git a/doc/qtcreator/src/howto/creator-how-to-view-images.qdoc b/doc/qtcreator/src/howto/creator-how-to-view-images.qdoc
index 0671ed9980c..c6532aa8029 100644
--- a/doc/qtcreator/src/howto/creator-how-to-view-images.qdoc
+++ b/doc/qtcreator/src/howto/creator-how-to-view-images.qdoc
@@ -5,7 +5,7 @@
\page creator-how-to-view-images.html
\if defined(qtcreator)
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\endif
\ingroup creator-how-to-design
\ingroup studio-how-to-image-viewer
@@ -47,7 +47,7 @@
\page creator-how-to-export-svg-images.html
\if defined(qtcreator)
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\endif
\ingroup creator-how-to-design
\ingroup studio-how-to-image-viewer
diff --git a/doc/qtcreator/src/howto/creator-keyboard-shortcuts.qdoc b/doc/qtcreator/src/howto/creator-keyboard-shortcuts.qdoc
index e16644c430d..8efe6c1324b 100644
--- a/doc/qtcreator/src/howto/creator-keyboard-shortcuts.qdoc
+++ b/doc/qtcreator/src/howto/creator-keyboard-shortcuts.qdoc
@@ -793,7 +793,7 @@
\nextpage studio-projects.html
\else
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\endif
\ingroup creator-how-to-ui
@@ -854,7 +854,7 @@
\nextpage studio-projects.html
\else
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\endif
\ingroup creator-how-to-ui
@@ -888,7 +888,7 @@
\nextpage studio-projects.html
\else
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\endif
\title Import and export keyboard shortcuts
diff --git a/doc/qtcreator/src/howto/creator-only/creator-how-to-enable-plugins.qdoc b/doc/qtcreator/src/howto/creator-only/creator-how-to-enable-plugins.qdoc
index f47ccc30c34..6cf11eff11f 100644
--- a/doc/qtcreator/src/howto/creator-only/creator-how-to-enable-plugins.qdoc
+++ b/doc/qtcreator/src/howto/creator-only/creator-how-to-enable-plugins.qdoc
@@ -4,7 +4,7 @@
/*!
\page creator-how-to-enable-plugins.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-use
\title Enable and disable plugins
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 42cb4759648..8bfb773a402 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
@@ -4,7 +4,7 @@
/*!
\page creator-how-to-find-settings-files.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-use
\title Find settings files
diff --git a/doc/qtcreator/src/howto/creator-only/creator-how-to-install-plugins.qdoc b/doc/qtcreator/src/howto/creator-only/creator-how-to-install-plugins.qdoc
index 10eb5e36c45..711e036c519 100644
--- a/doc/qtcreator/src/howto/creator-only/creator-how-to-install-plugins.qdoc
+++ b/doc/qtcreator/src/howto/creator-only/creator-how-to-install-plugins.qdoc
@@ -4,7 +4,7 @@
/*!
\page creator-how-to-install-plugins.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-use
\title Install plugins
diff --git a/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc b/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc
index c59902f3b04..9e2dc2afc40 100644
--- a/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc
+++ b/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc
@@ -10,7 +10,7 @@
/*!
\previouspage creator-faq.html
\page creator-how-tos.html
- \nextpage creator-known-issues.html
+ \nextpage creator-reference.html
\title How-to
@@ -76,7 +76,7 @@
/*!
\page creator-how-to-move-between-open-files.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-edit
\title Move between open files
@@ -96,7 +96,7 @@
/*!
\page creator-how-to-switch-to-edit-mode.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-edit
\title Switch to Edit mode
@@ -118,7 +118,7 @@
/*!
\page creator-how-to-find-preferences.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-ui
\title Find a particular preference
@@ -132,7 +132,7 @@
/*!
\page creator-how-to-run-from-cli.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-use
\title Run \QC from the command line
@@ -150,7 +150,7 @@
/*!
\page creator-how-to-move-to-symbols.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-edit
\title Move to symbols
@@ -173,7 +173,7 @@
/*!
\page creator-how-to-locate-files-using-keyboard.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-edit
\title Locate files using the keyboard
@@ -198,7 +198,7 @@
/*!
\page creator-how-to-perform-calculations.html
\previouspage creator-how-to-move-between-open-files.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-edit
\title Perform calculations
@@ -215,7 +215,7 @@
/*!
\page creator-how-to-jump-to-functions-in-qml-code.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-edit
\title Jump to a function in QML code
@@ -227,7 +227,7 @@
/*!
\page creator-how-to-add-license-header-templates.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-projects
\title Add a license header template for C++ code
@@ -258,7 +258,7 @@
/*!
\page creator-how-to-paste-text-from-clipboard-history.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-edit
\title Paste text from clipboard history
@@ -271,7 +271,7 @@
/*!
\page creator-how-to-sort-lines-alphabetically.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-edit
\title Sort lines alphabetically
@@ -284,7 +284,7 @@
/*!
\page creator-enclose-code-in-characters.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-edit
\title Enclose selected code in curly braces, parentheses, or double quotes
@@ -309,7 +309,7 @@
/*!
\page creator-how-to-select-enclosing-block.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-edit
\title Select the enclosing block in C++
@@ -320,7 +320,7 @@
/*!
\page creator-how-to-add-code-snippets.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-edit
\title Add code snippets to the auto-complete menu
@@ -337,7 +337,7 @@
/*!
\page creator-how-to-write-notes.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-edit
\title Write down notes
@@ -366,7 +366,7 @@
/*!
\page creator-how-to-set-recent-files.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-ui
\title Set the number of recent files shown
@@ -386,7 +386,7 @@
/*!
\page creator-how-to-search-and-replace-using-regexp.html
\previouspage creator-how-to-move-between-open-files.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-edit
\title Search and replace across files using a regular expression
diff --git a/doc/qtcreator/src/overview/creator-only/creator-reference.qdoc b/doc/qtcreator/src/overview/creator-only/creator-reference.qdoc
new file mode 100644
index 00000000000..22dfff65739
--- /dev/null
+++ b/doc/qtcreator/src/overview/creator-only/creator-reference.qdoc
@@ -0,0 +1,22 @@
+// Copyright (C) 2023 The Qt Company Ltd.
+// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
+
+/*!
+ \page creator-reference.html
+ \previouspage creator-how-tos.html
+ \nextpage creator-known-issues.html
+
+ \title Reference
+
+ The following topics describe the different parts of the UI in detail.
+
+ \section1 Sidebar Views
+
+ \annotatedlist creator-reference-sidebar-views
+
+ \section1 Output Views
+
+ \annotatedlist creator-reference-output-views
+
+ \sa {User Interface}, {Show and hide sidebars}, {View output}
+*/
diff --git a/doc/qtcreator/src/qtcreator-toc.qdoc b/doc/qtcreator/src/qtcreator-toc.qdoc
index da6f5444c50..3874d687a91 100644
--- a/doc/qtcreator/src/qtcreator-toc.qdoc
+++ b/doc/qtcreator/src/qtcreator-toc.qdoc
@@ -239,6 +239,7 @@
\li \l{Using the Help Mode}
\li \l{FAQ}
\li \l{How-to}
+ \li \l{Reference}
\li \l{Known Issues}
\li \l{Glossary}
\li \l{Technical Support}
diff --git a/doc/qtcreator/src/qtcreator.qdoc b/doc/qtcreator/src/qtcreator.qdoc
index 60f61a9561c..d1aba95665d 100644
--- a/doc/qtcreator/src/qtcreator.qdoc
+++ b/doc/qtcreator/src/qtcreator.qdoc
@@ -104,6 +104,7 @@
\li \l{Using the Help Mode}
\li \l{FAQ}
\li \l{How-to}
+ \li \l{Reference}
\li \l{Known Issues}
\li \l{Glossary}
\endlist
diff --git a/doc/qtcreator/src/user-interface/creator-file-system-view.qdoc b/doc/qtcreator/src/user-interface/creator-file-system-view.qdoc
index 26a7472500c..b2a9f0dfe1d 100644
--- a/doc/qtcreator/src/user-interface/creator-file-system-view.qdoc
+++ b/doc/qtcreator/src/user-interface/creator-file-system-view.qdoc
@@ -7,7 +7,7 @@
\previouspage creator-projects-view.html
\nextpage creator-open-documents-view.html
\else
- \previouspage creator-how-to-show-and-hide-sidebars.html
+ \previouspage creator-reference.html
\endif
\ingroup creator-reference-sidebar-views
diff --git a/doc/qtcreator/src/user-interface/creator-how-to-view-output.qdoc b/doc/qtcreator/src/user-interface/creator-how-to-view-output.qdoc
index 2121bd247a2..db90bb39f0b 100644
--- a/doc/qtcreator/src/user-interface/creator-how-to-view-output.qdoc
+++ b/doc/qtcreator/src/user-interface/creator-how-to-view-output.qdoc
@@ -73,13 +73,13 @@
Some output views do not support finding and filtering.
+ \if defined(qtcreator)
+ \sa {Output Views}
+ \else
\section1 Output views
The following views show output:
- \if defined(qtcreator)
- \annotatedlist creator-reference-output-views
- \else
\annotatedlist studio-reference-output-views
\endif
*/
diff --git a/doc/qtcreator/src/user-interface/creator-only/creator-how-to-show-and-hide-sidebars.qdoc b/doc/qtcreator/src/user-interface/creator-only/creator-how-to-show-and-hide-sidebars.qdoc
index 71105caadf9..52ecb03c011 100644
--- a/doc/qtcreator/src/user-interface/creator-only/creator-how-to-show-and-hide-sidebars.qdoc
+++ b/doc/qtcreator/src/user-interface/creator-only/creator-how-to-show-and-hide-sidebars.qdoc
@@ -4,7 +4,7 @@
/*!
\page creator-how-to-show-and-hide-sidebars.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-ui
\title Show and hide sidebars
@@ -32,12 +32,8 @@
(\uicontrol {Close}).
\endlist
- \section1 Sidebar views
-
- Manage projects and files in the following views:
-
- \annotatedlist creator-reference-sidebar-views
-
In some views, right-clicking opens a context menu that has functions
for managing the objects listed in the view.
+
+ \sa {Sidebar Views}
*/
diff --git a/doc/qtcreator/src/user-interface/creator-only/creator-how-to-switch-between-modes.qdoc b/doc/qtcreator/src/user-interface/creator-only/creator-how-to-switch-between-modes.qdoc
index a43cffc4f04..fb023f1f3c1 100644
--- a/doc/qtcreator/src/user-interface/creator-only/creator-how-to-switch-between-modes.qdoc
+++ b/doc/qtcreator/src/user-interface/creator-only/creator-how-to-switch-between-modes.qdoc
@@ -4,7 +4,7 @@
/*!
\page creator-how-to-switch-between-modes.html
\previouspage creator-how-tos.html
- \nextpage creator-known-issues.html
+
\ingroup creator-how-to-ui
\title Switch between modes
diff --git a/doc/qtcreator/src/user-interface/creator-only/creator-reference-sidebar-views.qdoc b/doc/qtcreator/src/user-interface/creator-only/creator-reference-sidebar-views.qdoc
index ca147e76dcf..ef50387b4fc 100644
--- a/doc/qtcreator/src/user-interface/creator-only/creator-reference-sidebar-views.qdoc
+++ b/doc/qtcreator/src/user-interface/creator-only/creator-reference-sidebar-views.qdoc
@@ -3,7 +3,7 @@
/*!
\page creator-outline-view.html
- \previouspage creator-how-to-show-and-hide-sidebars.html
+ \previouspage creator-reference.html
\ingroup creator-reference-sidebar-views
\title Outline
@@ -31,7 +31,7 @@
/*!
\page creator-class-view.html
- \previouspage creator-how-to-show-and-hide-sidebars.html
+ \previouspage creator-reference.html
\ingroup creator-reference-sidebar-views
\title Class View
@@ -51,7 +51,7 @@
/*!
\page creator-call-hierarchy-view.html
- \previouspage creator-how-to-show-and-hide-sidebars.html
+ \previouspage creator-reference.html
\ingroup creator-reference-sidebar-views
\title Call Hierarchy
@@ -73,7 +73,7 @@
/*!
\page creator-type-hierarchy.html
- \previouspage creator-how-to-show-and-hide-sidebars.html
+ \previouspage creator-reference.html
\ingroup creator-reference-sidebar-views
\title Type Hierarchy
@@ -105,7 +105,7 @@
/*!
\page creator-include-hierarchy-view.html
- \previouspage creator-how-to-show-and-hide-sidebars.html
+ \previouspage creator-reference.html
\ingroup creator-reference-sidebar-views
\title Include Hierarchy
diff --git a/doc/qtcreator/src/user-interface/creator-only/creator-reference-terminal-view.qdoc b/doc/qtcreator/src/user-interface/creator-only/creator-reference-terminal-view.qdoc
index a87ec969c80..abfae8ba8b2 100644
--- a/doc/qtcreator/src/user-interface/creator-only/creator-reference-terminal-view.qdoc
+++ b/doc/qtcreator/src/user-interface/creator-only/creator-reference-terminal-view.qdoc
@@ -3,7 +3,7 @@
/*!
\page creator-reference-terminal-view.html
- \previouspage creator-how-to-view-output.html
+ \previouspage creator-reference.html
\ingroup creator-reference-output-views
diff --git a/doc/qtcreator/src/user-interface/creator-only/creator-reference-to-do-entries-view.qdoc b/doc/qtcreator/src/user-interface/creator-only/creator-reference-to-do-entries-view.qdoc
index f8547ac3e1f..fb1b40f2633 100644
--- a/doc/qtcreator/src/user-interface/creator-only/creator-reference-to-do-entries-view.qdoc
+++ b/doc/qtcreator/src/user-interface/creator-only/creator-reference-to-do-entries-view.qdoc
@@ -3,7 +3,7 @@
/*!
\page creator-reference-to-do-entries-view.html
- \previouspage creator-how-to-view-output.html
+ \previouspage creator-reference.html
\ingroup creator-reference-output-views
diff --git a/doc/qtcreator/src/user-interface/creator-open-documents-view.qdoc b/doc/qtcreator/src/user-interface/creator-open-documents-view.qdoc
index 72ac21121ed..0ad0967dc0c 100644
--- a/doc/qtcreator/src/user-interface/creator-open-documents-view.qdoc
+++ b/doc/qtcreator/src/user-interface/creator-open-documents-view.qdoc
@@ -8,7 +8,7 @@
\previouspage creator-file-system-view.html
\nextpage studio-content-library.html
\else
- \previouspage creator-how-to-show-and-hide-sidebars.html
+ \previouspage creator-reference.html
\endif
\ingroup creator-reference-sidebar-views
diff --git a/doc/qtcreator/src/user-interface/creator-projects-view.qdoc b/doc/qtcreator/src/user-interface/creator-projects-view.qdoc
index be07f7f1580..529abfed348 100644
--- a/doc/qtcreator/src/user-interface/creator-projects-view.qdoc
+++ b/doc/qtcreator/src/user-interface/creator-projects-view.qdoc
@@ -7,7 +7,7 @@
\previouspage qtquick-curve-editor.html
\nextpage creator-file-system-view.html
\else
- \previouspage creator-how-to-show-and-hide-sidebars.html
+ \previouspage creator-reference.html
\endif
\ingroup creator-reference-sidebar-views
diff --git a/doc/qtcreator/src/user-interface/creator-reference-output-views.qdoc b/doc/qtcreator/src/user-interface/creator-reference-output-views.qdoc
index 42df7eb4d18..60387532f7e 100644
--- a/doc/qtcreator/src/user-interface/creator-reference-output-views.qdoc
+++ b/doc/qtcreator/src/user-interface/creator-reference-output-views.qdoc
@@ -9,7 +9,7 @@
/*!
\page creator-reference-issues-view.html
- \previouspage creator-how-to-view-output.html
+ \previouspage creator-reference.html
\ingroup creator-reference-output-views
\ingroup studio-reference-output-views
@@ -117,7 +117,7 @@
/*!
\page creator-reference-search-results-view.html
- \previouspage creator-how-to-view-output.html
+ \previouspage creator-reference.html
\ingroup creator-reference-output-views
\ingroup studio-reference-output-views
@@ -143,7 +143,7 @@
/*!
\page creator-reference-application-output-view.html
- \previouspage creator-how-to-view-output.html
+ \previouspage creator-reference.html
\ingroup creator-reference-output-views
\ingroup studio-reference-output-views
@@ -185,7 +185,7 @@
/*!
\page creator-reference-compile-output-view.html
- \previouspage creator-how-to-view-output.html
+ \previouspage creator-reference.html
\ingroup creator-reference-output-views
\ingroup studio-reference-output-views
diff --git a/doc/qtcreator/src/user-interface/creator-ui.qdoc b/doc/qtcreator/src/user-interface/creator-ui.qdoc
index b37c1c4e0f7..220d9af132a 100644
--- a/doc/qtcreator/src/user-interface/creator-ui.qdoc
+++ b/doc/qtcreator/src/user-interface/creator-ui.qdoc
@@ -76,7 +76,7 @@
For information about new features and bug fixes in each \QC release,
select \uicontrol Help > \uicontrol {Change Log}.
- \sa {Use the UI}{How-to: Use the UI}
+ \sa {Use the UI}{How-to: Use the UI}, {Reference}
\else