[quote author="koahnig" date="1377285408"]
have you seen this "Doxygen helper?":http://www.stack.nl/~dimitri/doxygen/helpers.html#doxfilt_qml[/quote]
Yes I am aware of it.
As for other comments: yes, qdoc is not intended for external use, it has no stable API, is not guaranteed to work the same in the future, etc. In general, it does work quite well, though. If you miss some documentation, you can check it in docs of doxygen - there is a big overlap (after all, doxygen was created for Qt).
Just to reiterate: I do recommend using doxygen.