Details
-
Bug
-
Resolution: Unresolved
-
P2: Important
-
None
-
6.8.3
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.