From 551dde7fa9b218e84bc79e01da008a9f1d0bbf97 Mon Sep 17 00:00:00 2001 From: Leena Miettinen Date: Fri, 6 Oct 2023 14:06:20 +0200 Subject: [PATCH] Doc: Describe Documentation Comments preferences - Add a topic for setting preferences for Doxygen-style docs - Update screenshot for Text Editor > Completion preferences, where the documentation settings used to be Task-number: QTCREATORBUG-29392 Change-Id: Ifb915e78f3d2a5fb97555dd99bfaa5abf12ef14b Reviewed-by: Christian Kandeler --- ...tcreator-options-texteditor-completion.png | Bin 14439 -> 0 bytes ...or-preferences-documentation-comments.webp | Bin 0 -> 3222 bytes ...tor-preferences-texteditor-completion.webp | Bin 0 -> 7932 bytes .../src/editors/creator-code-completion.qdoc | 4 ++- .../creator-how-to-document-code.qdoc | 27 ++++++++++++++++++ .../howto/creator-only/creator-how-tos.qdoc | 5 +++- .../creator-projects-settings-overview.qdoc | 1 + doc/qtcreator/src/qtcreator-toc.qdoc | 1 + 8 files changed, 36 insertions(+), 2 deletions(-) delete mode 100644 doc/qtcreator/images/qtcreator-options-texteditor-completion.png create mode 100644 doc/qtcreator/images/qtcreator-preferences-documentation-comments.webp create mode 100644 doc/qtcreator/images/qtcreator-preferences-texteditor-completion.webp create mode 100644 doc/qtcreator/src/howto/creator-only/creator-how-to-document-code.qdoc diff --git a/doc/qtcreator/images/qtcreator-options-texteditor-completion.png b/doc/qtcreator/images/qtcreator-options-texteditor-completion.png deleted file mode 100644 index a891ed6365c4b9b2a22127c4546b43a4f6739c67..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 14439 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 diff --git a/doc/qtcreator/images/qtcreator-preferences-documentation-comments.webp b/doc/qtcreator/images/qtcreator-preferences-documentation-comments.webp new file mode 100644 index 0000000000000000000000000000000000000000..0e65dde2aeb0606671d1802299fdf4e91858e3f1 GIT binary patch literal 3222 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 QVE%FSzu>R){iPEb0mFhBNdN!< literal 0 HcmV?d00001 diff --git a/doc/qtcreator/images/qtcreator-preferences-texteditor-completion.webp b/doc/qtcreator/images/qtcreator-preferences-texteditor-completion.webp new file mode 100644 index 0000000000000000000000000000000000000000..e2b68ec78520e1ea2fc25d07df31acefbc1f3af2 GIT binary patch literal 7932 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 \uicontrol Preferences > \uicontrol {Text Editor} > \uicontrol Completion. - \image qtcreator-options-texteditor-completion.png "Text Editor Completion preferences" + \image qtcreator-preferences-texteditor-completion.webp "Text Editor Completion preferences" By default, code completion does not consider case. To apply full or first-letter case-sensitivity, select \uicontrol Full or @@ -298,6 +298,8 @@ To use Nimsuggest, you must install it on the development PC. Then select \uicontrol Edit > \uicontrol Preferences > \uicontrol Nim > \uicontrol Tools, and enter the path to the tool executable in the \uicontrol Path field. + + \sa {Document code} \else \include qtcreator-variables.qdocinc qtcreator variables \endif diff --git a/doc/qtcreator/src/howto/creator-only/creator-how-to-document-code.qdoc b/doc/qtcreator/src/howto/creator-only/creator-how-to-document-code.qdoc new file mode 100644 index 00000000000..3050f4a9a4e --- /dev/null +++ b/doc/qtcreator/src/howto/creator-only/creator-how-to-document-code.qdoc @@ -0,0 +1,27 @@ +// Copyright (C) 2023 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \page creator-how-to-document-code.html + \previouspage creator-how-tos.html + + \ingroup creator-how-to-edit + + \title Document code + + When you write documentation comments in the \uicontrol Edit mode, you can + enable Doxygen code blocks and add brief descriptions and leading asterisks + automatically. Also, you can select the Doxygen command prefix to use. + + To set preferences for documentation comments for a particular project, + select \uicontrol Projects > \uicontrol {Project Settings} > + \uicontrol {Documentation Comments}, and deselect the + \uicontrol {Use global settings} check box. + + \image qtcreator-preferences-documentation-comments.webp {Documentation Comments settings} + + To set global preferences, select \uicontrol Edit > \uicontrol Preferences > + \uicontrol {Text Editor} > \uicontrol {Documentation Comments}. + + \sa {Configuring Projects} +*/ 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 94a4f288393..a716f7aede6 100644 --- a/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc +++ b/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc @@ -28,6 +28,7 @@ \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} @@ -410,7 +411,9 @@ select \uicontrol Edit > \uicontrol Preferences > \uicontrol {Text Editor} > \uicontrol Completion. - \image qtcreator-options-texteditor-completion.png "Completion preferences" + \image qtcreator-preferences-texteditor-completion.webp "Completion preferences" + + \sa {Completing Code} */ /*! diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-overview.qdoc b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-overview.qdoc index 2b71e1f5000..3276706a95e 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-overview.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-overview.qdoc @@ -42,6 +42,7 @@ \li \l{Specify code style}{C++ Code Style} \li \l{Using Custom Output Parsers}{Custom Output Parsers} \li \l{Specify dependencies}{Dependencies} + \li \l{Document code}{Documentation Comments} \li \l{Specify editor settings}{Editor} \li \l{Specifying Environment Settings}{Environment} \li \l{Applying Refactoring Actions}{Quick Fixes} diff --git a/doc/qtcreator/src/qtcreator-toc.qdoc b/doc/qtcreator/src/qtcreator-toc.qdoc index 5fcbee47a94..bfc6e8122fa 100644 --- a/doc/qtcreator/src/qtcreator-toc.qdoc +++ b/doc/qtcreator/src/qtcreator-toc.qdoc @@ -188,6 +188,7 @@ \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}