qdoc: properly implement \typealias command

\typealias was already a command recognized by QDoc, but it was simply
treated as a synonym for \typedef and was not documented. Implement
proper support for the command:

 - Add [alias] designation both in type summary and details.
 - Auto-generate information about the aliased type, including a link
   if aliasing a public, documented type.
 - Auto-convert aliases documented with \typedef to type aliases.
 - Add basic support for aliases also to DocBook and WebXML generators.
 - Document \typealias.

Fixes: QTBUG-82712
Change-Id: Iafa8c7def0a7488d7521fbc2862290a9bb3167ff
Reviewed-by: Qt CI Bot <qt_ci_bot@qt-project.org>
Reviewed-by: Paul Wicking <paul.wicking@qt.io>

1 files changed, 6 insertions, 10 deletions

diff --git a/src/qdoc/clangcodeparser.cpp b/src/qdoc/clangcodeparser.cpp
index b5c6a8ac6..0a0b7e7ac 100644
--- a/src/qdoc/clangcodeparser.cpp
+++ b/src/qdoc/clangcodeparser.cpp
@@ -632,18 +632,14 @@ CXChildVisitResult ClangVisitor::visitHeader(CXCursor cursor, CXSourceLocation l
     QString templateString;
     switch (kind) {
     case CXCursor_TypeAliasDecl: {
-        QString spelling = getSpelling(clang_getCursorExtent(cursor));
-        QStringList typeAlias = spelling.split(QChar('='));
+        QString aliasDecl = getSpelling(clang_getCursorExtent(cursor)).simplified();
+        QStringList typeAlias = aliasDecl.split(QLatin1Char('='));
         if (typeAlias.size() == 2) {
-            typeAlias[0] = typeAlias[0].trimmed();
+            typeAlias[0] = typeAlias[0].trimmed().split(QLatin1Char(' ')).last();
             typeAlias[1] = typeAlias[1].trimmed();
-            int lastBlank = typeAlias[0].lastIndexOf(QChar(' '));
-            if (lastBlank > 0) {
-                typeAlias[0] = typeAlias[0].right(typeAlias[0].size() - (lastBlank + 1));
-                TypeAliasNode *ta = new TypeAliasNode(parent_, typeAlias[0], typeAlias[1]);
-                ta->setAccess(fromCX_CXXAccessSpecifier(clang_getCXXAccessSpecifier(cursor)));
-                ta->setLocation(fromCXSourceLocation(clang_getCursorLocation(cursor)));
-            }
+            TypeAliasNode *ta = new TypeAliasNode(parent_, typeAlias[0], typeAlias[1]);
+            ta->setAccess(fromCX_CXXAccessSpecifier(clang_getCXXAccessSpecifier(cursor)));
+            ta->setLocation(fromCXSourceLocation(clang_getCursorLocation(cursor)));
         }
         return CXChildVisit_Continue;
     }