What's the benefit to use QDoc than Doxygen?
-
wrote on 23 Aug 2013, 17:07 last edited by
Is there anything offered in QDoc which is not supported by Doxygen?
-
wrote on 23 Aug 2013, 17:38 last edited by
It's qt :)
-
QDoc has slightly better support for QML. In all remaining aspects, Doxygen is far, far superior.
-
wrote on 23 Aug 2013, 19:16 last edited by
[quote author="sierdzio" date="1377284513"]QDoc has slightly better support for QML. In all remaining aspects, Doxygen is far, far superior.[/quote]
have you seen this "Doxygen helper?":http://www.stack.nl/~dimitri/doxygen/helpers.html#doxfilt_qmlBTW glad to read your comment. I have tried to find documentation for qdoc but it seems almost non-existent or someone has hiding it away from google.
-
[quote author="koahnig" date="1377285408"]I have tried to find documentation for qdoc but it seems almost non-existent or someone has hiding it away from google. [/quote]QDoc docs are at http://qt-project.org/doc/qt-5.1/qdoc/qdoc-index.html
From what I've heard, QDoc is intended to be an internal Qt tool; it wasn't designed to be used for external projects, but it can be used I guess.
Unfortunately, Qt's docs aren't well-optimized for Google.
-
wrote on 24 Aug 2013, 08:41 last edited by
JKSH thanks for sharing the link.
The misery is that even on Qt main documentation page you do not find a reference to the qdoc tool.It needs quite a bit of digging to find it. Finally I have found a "wiki entry":http://qt-project.org/wiki/Category:Tools::QDoc . However, it referred to an old Nokia page and the Digia redirection was of no help. I have updated the wiki page to reflect the current status.
-
[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.
6/7