[Development] RFC: The Future of QDoc

[Manuel Nickschas]

On Thursday 09 February 2012 15:36:09 ext Olivier Goffart wrote:

> > I am working on QDoc part-time and we have been discussing some changes
> > that we would like to implement to make qdoc more future proof. I have
> > created a short list of the things we would like to do:
> > http://developer.qt.nokia.com/wiki/Category:Tools::QDoc
> > 
> > It comes down to: Implement a new C++ parser, make qdoc more modular and
> > be
> > able to handle the Qt modules better with qdoc.
> > 
> > I am wondering if anybody has any ideas about what he/she would like qdoc
> > to do, or how qdoc should evolve?
> 
> Have you thought about using doxygen or any similar tool?

Or at least make QDoc be able to parse doxygen-style comments (which also 
means it should not ignore headers, as documenting public API in a header file 
is much more common at least outside Qt than doing that in the implementation 
file...)

I'd be happy to see Qt use or at least support more standard solutions over 
homegrown ones. Since that failed for localization, maybe we can at least get 
it for documentation :)

BR,
~ Sput
-- 
Manuel "Sput" Nickschas         | mailto: manuel.nickschas at nokia.com |   .-.
Senior SW Engineer, Middlelayer | callto: +49 (0) 174 16 53 993      |   oo|
Nokia GmbH, MP Development      | sendto: Lise-Meitner-Str. 14       |  /`'\
Product Creation Center Ulm     |         89081 Ulm, Germany         | (\_;/)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.qt-project.org/pipermail/development/attachments/20120209/29093bc3/attachment.html>