[Development] Make qdoc an officially supported tool for generating QML API documentation

[casper.vandonderen at nokia.com]

Hi,

We have been very busy to get qdoc running outside of Qt (I am starting to
use qdoc as LaTeX-lite now if I just need an HTML page). I do agree that
the qdoc manual should be improved with examples that do not necessarily
reflect how we use qdoc with Qt.

All changes that we are doing to qdoc are only added to the Qt5 version of
qdoc (which is qdoc instead of qdoc3). The Qt5 version should also support
the \inherits you mentioned in the QTBUG (be aware that you cannot use
\inherits when documenting .qml files, since we automatically use the top
level element in the .qml file.


Casper

On 6/8/12 5:16 PM, "ext Sven Anderson" <Sven.Anderson at snom.com> wrote:

>Hi all,
>
>since qdoc is the only tool that can create documentation for QML APIs,
>but it's (AFAIK) not supported as an external tool - although that is
>very much needed especially for QML - I suggest to make qdoc the offical
>tool for generation of external QML API documentation (and fix it
>accordingly).
>
>I filed a suggestion here:
>https://bugreports.qt-project.org/browse/QTBUG-26096
>
>
>Best regards,
>
>Sven
>_______________________________________________
>Development mailing list
>Development at qt-project.org
>http://lists.qt-project.org/mailman/listinfo/development