Details
-
Bug
-
Resolution: Fixed
-
P2: Important
-
None
-
6.8.3
-
e6b38aea5 (dev), 967078281 (dev), 149a8d7d4 (dev), 1fd95c958 (dev), c6fa0b976 (dev), 531c721ab (dev), d5652d694 (dev), d364f2a5a (dev)
-
DaVinci 117, DaVinci 118, DaVinci 119, DaVinci 120
Description
Since QML types can have enumerations there should be a \qmlenum directive to document them, like there is a \qmlproperty directive for properties. Various hacks have been established around this problem. For example:
- The "enumeration" pseudo type for \qmlproperty - this thing does not exist in actual QML.
- Listing the enumeration values as part of the documentation of each property that can hold the enumeration - this leads to duplication.
- Documenting the enumeration as a property. This is wrong because an enumeration is not a property.
Attachments
Issue Links
- resulted in
-
QTBUG-137458 Update 'QML Documentation Style" page for \qmlenum
-
- Reported
-
For Gerrit Dashboard: QTBUG-134806 | ||||||
---|---|---|---|---|---|---|
# | Subject | Branch | Project | Status | CR | V |
644928,3 | qdoc: Test \qmlenum output | dev | qt/qttools | Status: NEW | +2 | 0 |
643982,4 | qdoc: C++ code parser: Extract recurring logic for searching nodes | dev | qt/qttools | Status: MERGED | +2 | 0 |
643983,5 | qdoc: Introduce QmlEnumNode | dev | qt/qttools | Status: MERGED | +2 | 0 |
643984,5 | qdoc: Extend QmlPropertyArguments | dev | qt/qttools | Status: MERGED | +2 | 0 |
643985,5 | qdoc: Add sections for QML enumeration documentation | dev | qt/qttools | Status: MERGED | +2 | 0 |
644214,5 | qdoc: Introduce \qmlenum command | dev | qt/qttools | Status: MERGED | +2 | 0 |
644215,5 | qdoc: Add QmlEnumNode instances to index | dev | qt/qttools | Status: MERGED | +2 | 0 |
644216,7 | qdoc: Introduce NativeEnum container | dev | qt/qttools | Status: MERGED | +2 | 0 |
644927,3 | qdoc: Process Nodes of type QmlEnum in HelpProjectWriter | dev | qt/qttools | Status: MERGED | +2 | 0 |