Hi,

I'm trying to document my QML API, that consists of custom QML items 
implemented in C++. Since there seems to be no other choice I'm using 
qdoc3, although its only ment for Qt internal use. It's quite a hassle 
because of the incomplete documentation.

What bugs me now at the moment is the \inherts command. Of course some 
of my items inherit Item and it's properties. However, using "\inherits 
Item" does not include the Item properties in the "List of all members, 
including inherited members" page, of course, since qdoc3 normally has 
no access to the Qt sources, in which the Item documentation is stored. 
If I include the Qt sources in the qdocconf file, it works, but it also 
duplicates the documentation of the standard items. What would be nice 
is a correct members page, that links the inherited properties to the 
original Qt Quick documentation. Since even the Qt Components 
documentation seem to have that problem I fear there is no solution to 
this problem. But maybe somebody here has found a solution?

Also some better supported alternatives to qdoc3 for QML documentation 
would be great, but I could not find one so far. Neither doxygen nor 
JSdoc support QML. This is really a gap in the QML experience so far.


Thanks and best regards,

Sven
_______________________________________________
Qt-qml mailing list
Qt-qml@qt.nokia.com
http://lists.qt.nokia.com/mailman/listinfo/qt-qml

Reply via email to