[cfe-dev] libclang based doxygen-like tool

[Matthieu Monrocq]

On Sat, Aug 18, 2012 at 1:30 PM, Slav <slavmfm at gmail.com> wrote:

> Hope, I am mistaken, but Clang does not keep comments, isn't it so? But it
> is impossible to imagine a documentation generation tool which skips
> comments...
>
> 2012/8/18 Slav <slavmfm at gmail.com>
>
>>  On Sat, Aug 18, 2012 at 12:21 PM, Slav <slavmfm at gmail.com> wrote:
>>> > Hope, I am mistaken, but Clang does not keep comments, isn't it so?
>>> But it
>>> > is impossible to imagine a documentation generation tool which skips
>>> > comments...
>>> >
>>> >
>>> > 2012/8/17 Manuel Klimek <klimek at google.com>
>>> >>
>>> >> On Fri, Aug 17, 2012 at 1:12 PM, Andy Gibbs <andyg1001 at hotmail.co.uk>
>>> >> wrote:
>>> >> > On Thursday, August 16, 2012 10:01 PM, Don Hinton wrote:
>>> >> >> I've sent copies you and the others who expressed an interest,
>>> >> >> and will look into hosting it somewhere.
>>> >> >
>>> >> > Isn't this exactly the sort of thing that should end up in the
>>> >> > clang-tools-extras repository?
>>> >> >
>>> >> > What do others think?  Chandler, this is your thing isn't it?
>>> >>
>>> >> Definitely, once the design has been discussed; my main concern would
>>> >> be that the tool nicely fits the latest extensions to clang's comment
>>> >> parsing, and has a clear strategy and maintenance story going forward.
>>> >>
>>> >> Cheers,
>>> >> /Manuel
>>> >>
>>> >> >
>>> >> > Cheers
>>> >> > Andy
>>> >> >
>>> >> > P.S. Don, I'd also be interested in a copy too :o)
>>> >> >
>>> >> >
>>> >> >
>>> >> > _______________________________________________
>>> >> > cfe-dev mailing list
>>> >> > cfe-dev at cs.uiuc.edu
>>> >> > http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev
>>> >> _______________________________________________
>>> >> cfe-dev mailing list
>>> >> cfe-dev at cs.uiuc.edu
>>> >> http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev
>>> >
>>> >
>>>
>>
>>
>>
>
> _______________________________________________
> cfe-dev mailing list
> cfe-dev at cs.uiuc.edu
> http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev
>
>
It does actually, and Dmitri Gribenko has been working on implementing a
comment parser to recognize Doxygen-like comment (and hopefully other
styles afterward), attach them to the entities they do comment and warn
about improperly formatted doc comments.

-- Matthieu
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/cfe-dev/attachments/20120819/810bb0aa/attachment.html>