qdoc: The \wrapper command is added

If \wrapper appears in a \class comment or a
\qmltype comment, qdoc will not print warnings
when it finds public members of the class or the
QML type that are not documented.

The \wrapper command is added to several
opengl classes. This reduces the number of
qdoc warnings by several thousands.

Task-number: QTBUG-30755
Change-Id: Iba1eebc1590ccf54100e40fe91423240c1b3d09d
Reviewed-by: Topi Reiniö <[email protected]>
Reviewed-by: Venugopal Shivashankar <[email protected]>
Reviewed-by: Martin Smith <[email protected]>
Reviewed-by: Jerome Pasion <[email protected]>

1 files changed, 6 insertions, 1 deletions

diff --git a/src/tools/qdoc/codeparser.cpp b/src/tools/qdoc/codeparser.cpp
index 557a6f08fad..7b534a6c955 100644
--- a/src/tools/qdoc/codeparser.cpp
+++ b/src/tools/qdoc/codeparser.cpp
@@ -70,6 +70,7 @@ QT_BEGIN_NAMESPACE
 #define COMMAND_SUBTITLE                Doc::alias(QLatin1String("subtitle"))
 #define COMMAND_THREADSAFE              Doc::alias(QLatin1String("threadsafe"))
 #define COMMAND_TITLE                   Doc::alias(QLatin1String("title"))
+#define COMMAND_WRAPPER                 Doc::alias(QLatin1String("wrapper"))
 
 QString CodeParser::currentSubDir_;
 QList<CodeParser *> CodeParser::parsers;
@@ -219,7 +220,8 @@ QSet<QString> CodeParser::commonMetaCommands()
                            << COMMAND_SINCE
                            << COMMAND_SUBTITLE
                            << COMMAND_THREADSAFE
-                           << COMMAND_TITLE;
+                           << COMMAND_TITLE
+                           << COMMAND_WRAPPER;
 }
 
 /*!
@@ -286,6 +288,9 @@ void CodeParser::processCommonMetaCommand(const Location& location,
     else if (command == COMMAND_SINCE) {
         node->setSince(arg.first);
     }
+    else if (command == COMMAND_WRAPPER) {
+        node->setWrapper();
+    }
     else if (command == COMMAND_PAGEKEYWORDS) {
         node->addPageKeywords(arg.first);
     }