summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorTopi Reinio <topi.reinio@qt.io>2022-09-27 15:22:26 +0200
committerTopi Reinio <topi.reinio@qt.io>2022-09-29 10:51:12 +0200
commit6713d066a8346d78a24ecbf6bbb1dff7fb57cf72 (patch)
tree637a5b826a229e6f203287bb3e87ae1eb495ac10
parentdb830ae43414a4882bd263641dad07b0b23811d7 (diff)
Doc: QDoc Manual: Document the \wrapper command
This command is used in a number of OpenGL and Vulkan-related classes, and it's sole purpose is to suppress warnings that QDoc would otherwise generate for an undocumented, non-Qt API. Pick-to: 6.4 Fixes: QTBUG-106255 Change-Id: I7146ecd1a904cf170907cbb184dd8d06cca9bb12 Reviewed-by: Paul Wicking <paul.wicking@qt.io>
-rw-r--r--src/qdoc/doc/qdoc-manual-cmdindex.qdoc1
-rw-r--r--src/qdoc/doc/qdoc-manual-contextcmds.qdoc9
2 files changed, 10 insertions, 0 deletions
diff --git a/src/qdoc/doc/qdoc-manual-cmdindex.qdoc b/src/qdoc/doc/qdoc-manual-cmdindex.qdoc
index dd72f63d6..ac39bc8f5 100644
--- a/src/qdoc/doc/qdoc-manual-cmdindex.qdoc
+++ b/src/qdoc/doc/qdoc-manual-cmdindex.qdoc
@@ -127,5 +127,6 @@
\li \l {variable-command} {\\variable}
\li \l {value-command} {\\value}
\li \l {warning-command} {\\warning}
+ \li \l {wrapper-command} {\\wrapper}
\endlist
*/
diff --git a/src/qdoc/doc/qdoc-manual-contextcmds.qdoc b/src/qdoc/doc/qdoc-manual-contextcmds.qdoc
index 97cb22514..e93ab25bf 100644
--- a/src/qdoc/doc/qdoc-manual-contextcmds.qdoc
+++ b/src/qdoc/doc/qdoc-manual-contextcmds.qdoc
@@ -49,6 +49,7 @@
\li \l {subtitle-command}{\\subtitle}
\li \l {threadsafe-command}{\\threadsafe}
\li \l {title-command}{\\title}
+ \li \l {wrapper-command}{\\wrapper}
\endlist
*/
@@ -529,6 +530,14 @@
marking specific C++ enum values with since information.
See also \l {value-command}{\\value} and \l {ignoresince}.
+
+ \target wrapper-command
+ \section1 \\wrapper
+
+ The \\wrapper command, when used in a C++ class documentation, marks the
+ class as a \e wrapper that provides access to a non-Qt API. This command
+ is used for suppressing warnings that might otherwise be generated for
+ members of such a class.
*/