Doc: Use the \generatelist command in TOC, How To, and Reference

...to automatically list the topics in each group and avoid manual
work.

Task-number: QTCREATORBUG-29361
Change-Id: I45391b548354e6499bbd0698a9da8d6f9dc77dff
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
This commit is contained in:
Leena Miettinen
2023-10-12 15:35:58 +02:00
parent 78974347c5
commit fd92781e87
3 changed files with 44 additions and 277 deletions

View File

@@ -16,134 +16,33 @@
The following topics describe how to use \QC to perform a particular task. The following topics describe how to use \QC to perform a particular task.
\section1 Build and Run
\generatelist creator-how-to-build
\section1 Design UIs \section1 Design UIs
\list \generatelist creator-how-to-design
\li \l {Export SVG images}
\li \l {Run QML files}
\li \l {View images}
\endlist
\section1 Edit Code \section1 Edit Code
\list \generatelist creator-how-to-edit
\li \l {Add code snippets to the auto-complete menu}
\li \l {Document code}
\li \l {Enclose selected code in curly braces, parentheses, or double quotes}
\li \l {Indent text or code}
\li \l {Jump to a function in QML code}
\li \l {Locate files using the keyboard}
\li \l {Move between open files}
\li \l {Move to symbols}
\li \l {Paste text from clipboard history}
\li \l {Perform calculations}
\li \l {Search and replace across files using a regular expression}
\li \l {Select the enclosing block in C++}
\li \l {Sort lines alphabetically}
\li \l {Specify code style}
\li \l {Switch to Edit mode}
\li \l {Write down notes}
\endlist
\section1 Manage Projects \section1 Manage Projects
\table \generatelist creator-how-to-projects
\header
\li Create Projects
\li Configure Projects
\row
\li
\list
\li \l {Add a license header template for C++ code}
\li \l {Add libraries to projects}
\li \l {Add subprojects to projects}
\li \l {Add wizards}
\li \l {Create compiler explorer sessions}
\li \l {Create C++ classes}
\li \l {Create files}
\li \l {Create OpenGL fragment and vertex shaders}
\li \l {Create resource files}
\li \l {Create VCS repositories for new projects}
\li \l {Select the build system}
\li \l {Use project wizards}
\endlist
\li
\list
\li \l {Activate kits for a project}
\li \l {Develop Qt for Python applications}
\li \l {Open projects}
\li \l {Specify dependencies}
\li \l {Specify editor settings}
\li \l {Specify project contents}
\endlist
\endtable
\section1 Build and Run
\list
\li \l {Explore compiler code}
\endlist
\section2 Manage Kits
\list
\li \l {Add compilers}
\li \l {Add custom compilers}
\li \l {Add debuggers}
\li \l {Add kits}
\li \l {Add Nim compilers}
\li \l {Add Qt versions}
\li \l {Edit Qbs profiles}
\endlist
\section1 Read Qt Documentation \section1 Read Qt Documentation
\list \generatelist creator-how-to-get-help
\li \l {Add bookmarks to help pages}
\li \l {Add external documentation}
\li \l {Detach the help window}
\li \l {Filter documentation}
\li \l {Find information in Qt documentation}
\li \l {Get help}
\li \l {Search from documentation}
\li \l {Select the help start page}
\endlist
\section1 Use \QC \section1 Use \QC
\list \generatelist creator-how-to-use
\li \l {Collect usage statistics}
\li \l {Enable and disable plugins}
\li \l {Find settings files}
\li \l {Inspect internal logs}
\li \l {Install plugins}
\li \l {Manage data collection}
\li \l {Record screens}
\li \l {Run \QC from the command line}
\li \l {Set up version control systems}
\li \l {Use common VCS functions}
\li \l {Use external text editors}
\li \l {Use external tools}
\li \l {Use Qt Linguist}
\endlist
\section1 Use the UI \section1 Use the UI
\list \generatelist creator-how-to-ui
\li \l {Assign keyboard shortcuts}
\li \l {Detach views}
\li \l {Find a particular preference}
\li \l {Find keyboard shortcuts}
\li \l {Find menu items on \macos}
\li \l {Import and export keyboard shortcuts}
\li \l {Set high DPI scaling}
\li \l {Set the number of recent files shown}
\li \l {Show and hide sidebars}
\li \l {Show task list files in Issues}
\li \l {Switch between modes}
\li \l {Switch UI themes}
\li \l {View output}
\endlist
*/ */
/*! /*!

View File

@@ -19,10 +19,6 @@
\annotatedlist creator-reference-build-systems \annotatedlist creator-reference-build-systems
\section1 Output Views
\annotatedlist creator-reference-output-views
\section1 Preferences \section1 Preferences
\annotatedlist creator-reference-preferences \annotatedlist creator-reference-preferences
@@ -35,7 +31,13 @@
\annotatedlist creator-reference-preferences-text-editor \annotatedlist creator-reference-preferences-text-editor
\section1 Sidebar Views \section1 Views
\section2 Output Views
\annotatedlist creator-reference-output-views
\section2 Sidebar Views
\annotatedlist creator-reference-sidebar-views \annotatedlist creator-reference-sidebar-views
*/ */

View File

@@ -145,7 +145,6 @@
\li \l{Viewing and Editing Register State} \li \l{Viewing and Editing Register State}
\li \l{Debugger Log} \li \l{Debugger Log}
\li \l{Viewing Disassembled Code} \li \l{Viewing Disassembled Code}
\li
\endlist \endlist
\li \l{Stopping Applications} \li \l{Stopping Applications}
\li \l{Examining Data} \li \l{Examining Data}
@@ -179,175 +178,42 @@
\endlist \endlist
\li \l{How To} \li \l{How To}
\list \list
\li Design UIs
\list
\li \l {Export SVG images}
\li \l {Run QML files}
\li \l {View images}
\endlist
\li Edit Code
\list
\li \l {Add code snippets to the auto-complete menu}
\li \l {Document code}
\li \l {Enclose selected code in curly braces, parentheses, or double quotes}
\li \l {Indent text or code}
\li \l {Jump to a function in QML code}
\li \l {Locate files using the keyboard}
\li \l {Move between open files}
\li \l {Move to symbols}
\li \l {Paste text from clipboard history}
\li \l {Perform calculations}
\li \l {Search and replace across files using a regular expression}
\li \l {Select the enclosing block in C++}
\li \l {Sort lines alphabetically}
\li \l {Specify code style}
\li \l {Switch to Edit mode}
\li \l {Write down notes}
\endlist
\li Manage Projects
\list
\li \l {Activate kits for a project}
\li \l {Add a license header template for C++ code}
\li \l {Add libraries to projects}
\li \l {Add subprojects to projects}
\li \l {Add wizards}
\li \l {Create compiler explorer sessions}
\li \l {Create C++ classes}
\li \l {Create files}
\li \l {Create OpenGL fragment and vertex shaders}
\li \l {Create resource files}
\li \l {Create VCS repositories for new projects}
\li \l {Develop Qt for Python applications}
\li \l {Open projects}
\li \l {Select the build system}
\li \l {Specify dependencies}
\li \l {Specify editor settings}
\li \l {Specify project contents}
\li \l {Use project wizards}
\endlist
\li Build and Run \li Build and Run
\list \generatelist creator-how-to-build
\li \l {Add compilers} \li Design UIs
\li \l {Add custom compilers} \generatelist creator-how-to-design
\li \l {Add debuggers} \li Edit Code
\li \l {Add kits} \generatelist creator-how-to-edit
\li \l {Add Nim compilers} \li Manage Projects
\li \l {Add Qt versions} \generatelist creator-how-to-projects
\li \l {Edit Qbs profiles}
\li \l {Explore compiler code}
\endlist
\li Read Qt Documentation \li Read Qt Documentation
\list \generatelist creator-how-to-get-help
\li \l {Add bookmarks to help pages}
\li \l {Add external documentation}
\li \l {Detach the help window}
\li \l {Filter documentation}
\li \l {Find information in Qt documentation}
\li \l {Get help}
\li \l {Search from documentation}
\li \l {Select the help start page}
\endlist
\li Use \QC \li Use \QC
\list \generatelist creator-how-to-use
\li \l {Collect usage statistics}
\li \l {Enable and disable plugins}
\li \l {Find settings files}
\li \l {Inspect internal logs}
\li \l {Install plugins}
\li \l {Manage data collection}
\li \l {Record screens}
\li \l {Run \QC from the command line}
\li \l {Set up version control systems}
\li \l {Use common VCS functions}
\li \l {Use external text editors}
\li \l {Use external tools}
\li \l {Use Qt Linguist}
\endlist
\li Use the UI \li Use the UI
\list \generatelist creator-how-to-ui
\li \l {Assign keyboard shortcuts}
\li \l {Detach views}
\li \l {Find a particular preference}
\li \l {Find keyboard shortcuts}
\li \l {Find menu items on \macos}
\li \l {Import and export keyboard shortcuts}
\li \l {Set high DPI scaling}
\li \l {Set the number of recent files shown}
\li \l {Show and hide sidebars}
\li \l {Show task list files in Issues}
\li \l {Switch between modes}
\li \l {Switch UI themes}
\li \l {View output}
\endlist
\endlist \endlist
\li \l{Reference} \li \l{Reference}
\generatelist creator-reference
\list \list
\li \l {Acknowledgements} \li Build Systems
\li \l {Command-Line Options} \generatelist creator-reference-build-systems
\li \l {Custom Wizards}
\li \l {FAQ}
\li \l {Glossary}
\li \l {Keyboard Shortcuts}
\li \l {Known Issues}
\li \l {Technical Support}
\li \l {Build Systems}
\list
\li \l{Managing Packages with vcpkg}
\li \l{Setting Up CMake}
\li \l{Setting Up Conan}
\li \l{Setting Up IncrediBuild}
\li \l{Setting Up Nimble}
\li \l{Setting Up Meson}
\li \l{Setting Up Qbs}
\li \l{Setting Up a Generic Project}
\li \l{Setting Up an Autotools Project}
\endlist
\li Output Views
\list
\li \l {Application Output}
\li \l {Compile Output}
\li \l {Issues}
\li \l {Search Results}
\li \l {To-Do Entries}
\endlist
\li Preferences \li Preferences
\generatelist creator-reference-preferences
\list \list
\li \l {Behavior} \li C++
\li \l {Compilers} \generatelist creator-reference-preferences-cpp
\li \l {C++ Code Style} \li Text editor
\li \l {Kits} \generatelist creator-reference-preferences-text-editor
\li \l {Nim}
\li \l {Qt Quick Code Style}
\li \l {Screen Recording}
\endlist \endlist
\li Version Control Systems
\generatelist creator-reference-vcs
\li Views
\list
\li Output Views
\generatelist creator-reference-output-views
\li Sidebar Views \li Sidebar Views
\list \generatelist creator-reference-sidebar-views
\li \l {Call Hierarchy}
\li \l {Class View}
\li \l {File System}
\li \l {Include Hierarchy}
\li \l {Open Documents}
\li \l {Outline}
\li \l {Projects}
\li \l {Type Hierarchy}
\endlist
\li \l {Supported Platforms}
\list
\li \l {Desktop Platforms}
\li \l {Embedded Platforms}
\li \l {Mobile Platforms}
\endlist
\li \l{Version Control Systems}
\list
\li \l {Bazaar}
\li \l {ClearCase}
\li \l {CVS}
\li \l {Fossil}
\li \l {Git}
\li \l {GitLab}
\li \l {Mercurial}
\li \l {Perforce}
\li \l {Subversion}
\endlist \endlist
\endlist \endlist
\endlist \endlist