[Development] RFC: The Future of QDoc

[Hugo Parente Lima]

On Thursday 09 February 2012 14:30:20 Matt Williams wrote:
> On 9 February 2012 14:15, Keno Fischer <kenof at stanford.edu> wrote:
> >> Implement a new C++ parser
> > 
> > Any plans on using Clang a parser? The wiki page mentioned Qt Creator's
> > AST, but it seems like Qt Creator will be moving away from its own
> > implementation in the future, so I think that might be something to
> > consider. Also, since the necessary work on Clang is being done for Qt
> > Creator anyway (I'm thinking of things like signals/slots) it might be
> > worth to keep qdoc in mind when working on Clang for Qt Creator. Any
> > thoughts?
> 
> There's also the KDevelop C++ parser. It already supports many C++11
> features and run very fast. As far as I'm aware it doesn't depends on
> any KDE libraries (Qt only) and already has the ability to extract
> Doxygen-style comments. I don't know if there are any KDevelop people
> on this list who can comment further?

The KDevelop parser is based on a version of Roberto's parser, last time I 
checked the sources it used few KDE utility classes like some smart pointers, 
but I see no difference in using the KDevelop or QtCreator parser as both are 
more or less the same.

I nice ability QDoc would have is to support other output formats like XML or 
JSON, the old QDoc had this feature but it was deprecated and not documented 
at all.

The PySide documentation is generated using the XML output of qdoc3, but the 
current version of qdoc3 doesn't support XML output anymore.

--
Hugo Parente Lima.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 198 bytes
Desc: This is a digitally signed message part.
URL: <http://lists.qt-project.org/pipermail/development/attachments/20120209/d640fd87/attachment.sig>