-
Bug
-
Resolution: Fixed
-
P3: Somewhat important
-
6.10.0 Beta4
-
553f05755 (dev), 8c6045f15 (dev)
-
DaVinci 125
Given a struct with an anonymous struct inside:
template <typename AngleT>
struct AxisAndAngle
{
struct {
float x, y, z;
Q_IMPLICIT constexpr operator QVector3D() const noexcept { return {x, y, z}; }
} axis;
AngleT angle;
};
When I try to document the axis member like this:
/*!
\variable QQuaternion::AxisAndAngle::axis
The 3D axis that together with an \l{angle} corresponds to a
\l{QQuaternion}{quaternion}.
An unnamed struct containing members \c{x}, \c{y}, \c{z}. This data member
implicitly converts to QVector3D.
*/
Then this is the result:
(cf. the file name in the type name)
Expected: it shows something that is independent of the source code location, e.g. (unnamed struct).
Work-around:
struct
#ifdef Q_QDOC
__unnamed__
#endif
{
| For Gerrit Dashboard: QTBUG-140223 | ||||||
|---|---|---|---|---|---|---|
| # | Subject | Branch | Project | Status | CR | V |
| 676768,2 | QDoc: Fix poor rendering of unnamed struct types | dev | qt/qttools | Status: MERGED | +2 | 0 |
| 678626,5 | QDoc: Clean anonymous type names during node creation | dev | qt/qttools | Status: MERGED | +2 | 0 |