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.
\section1 Build and Run
\generatelist creator-how-to-build
\section1 Design UIs
\list
\li \l {Export SVG images}
\li \l {Run QML files}
\li \l {View images}
\endlist
\generatelist creator-how-to-design
\section1 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
\generatelist creator-how-to-edit
\section1 Manage Projects
\table
\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
\generatelist creator-how-to-projects
\section1 Read Qt Documentation
\list
\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
\generatelist creator-how-to-get-help
\section1 Use \QC
\list
\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
\generatelist creator-how-to-use
\section1 Use the UI
\list
\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
\generatelist creator-how-to-ui
*/
/*!

View File

@@ -19,10 +19,6 @@
\annotatedlist creator-reference-build-systems
\section1 Output Views
\annotatedlist creator-reference-output-views
\section1 Preferences
\annotatedlist creator-reference-preferences
@@ -35,7 +31,13 @@
\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
*/

View File

@@ -145,7 +145,6 @@
\li \l{Viewing and Editing Register State}
\li \l{Debugger Log}
\li \l{Viewing Disassembled Code}
\li
\endlist
\li \l{Stopping Applications}
\li \l{Examining Data}
@@ -179,176 +178,43 @@
\endlist
\li \l{How To}
\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
\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}
\li \l {Explore compiler code}
\endlist
\generatelist creator-how-to-build
\li Design UIs
\generatelist creator-how-to-design
\li Edit Code
\generatelist creator-how-to-edit
\li Manage Projects
\generatelist creator-how-to-projects
\li Read Qt Documentation
\list
\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
\generatelist creator-how-to-get-help
\li Use \QC
\list
\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
\generatelist creator-how-to-use
\li Use the UI
\list
\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
\generatelist creator-how-to-ui
\endlist
\li \l{Reference}
\generatelist creator-reference
\list
\li \l {Acknowledgements}
\li \l {Command-Line Options}
\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 Build Systems
\generatelist creator-reference-build-systems
\li Preferences
\generatelist creator-reference-preferences
\list
\li \l {Behavior}
\li \l {Compilers}
\li \l {C++ Code Style}
\li \l {Kits}
\li \l {Nim}
\li \l {Qt Quick Code Style}
\li \l {Screen Recording}
\endlist
\li Sidebar Views
\list
\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}
\li C++
\generatelist creator-reference-preferences-cpp
\li Text editor
\generatelist creator-reference-preferences-text-editor
\endlist
\li Version Control Systems
\generatelist creator-reference-vcs
\li Views
\list
\li Output Views
\generatelist creator-reference-output-views
\li Sidebar Views
\generatelist creator-reference-sidebar-views
\endlist
\endlist
\endlist
*/