Priority: P2: Important
Resolution: Won't Do
Affects Version/s: 6.3
Fix Version/s: None
Component/s: Build tools: qdoc
Sprint:DaVinci sprint 53
The typealias command for QDoc is used to document C++ type aliases, such as using foo = bar;.
When using a typealias command to document a public typealias from a class that was generated from a macro, QDoc seems unable to resolve the documentation to any alias.
For example, if we had an header file:
And somewhere a documentation:
When generating the documenation QDoc will provide a warning and be unable to generate the typealias documentation:
If the header file contains the equivalent of the expanded code:
Then QDoc will not fail to find the alias and correctly produce the documentation.
The failure doesn't seem to be tied to generating the class itself but to the generation of the alias.
If the header files is modified to the following:
QDoc will fail to find the alias.
More specifically, the issue seems to exist only when the identifier used for the alias is behind a macro. For example:
Will fail but:
QDoc should be able to find typealiases that generates their identifier trough a macro or definition. To solve the issue, for all of the above and similar examples, QDoc should be able to generate the typealias documentation correctly.