<br><br><div class="gmail_quote">On Sat, Aug 18, 2012 at 1:30 PM, Slav <span dir="ltr"><<a href="mailto:slavmfm@gmail.com" target="_blank">slavmfm@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
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...<div><div><img src=""></div></div><br><div class="gmail_quote">2012/8/18 Slav <span dir="ltr"><<a href="mailto:slavmfm@gmail.com" target="_blank">slavmfm@gmail.com</a>></span><br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

<div><div>
On Sat, Aug 18, 2012 at 12:21 PM, Slav <<a href="mailto:slavmfm@gmail.com" target="_blank">slavmfm@gmail.com</a>> wrote:<br>
> Hope, I am mistaken, but Clang does not keep comments, isn't it so? But it<br>
> is impossible to imagine a documentation generation tool which skips<br>
> comments...<br>
><br>
><br>
> 2012/8/17 Manuel Klimek <<a href="mailto:klimek@google.com" target="_blank">klimek@google.com</a>><br>
>><br>
>> On Fri, Aug 17, 2012 at 1:12 PM, Andy Gibbs <<a href="mailto:andyg1001@hotmail.co.uk" target="_blank">andyg1001@hotmail.co.uk</a>><br>
>> wrote:<br>
>> > On Thursday, August 16, 2012 10:01 PM, Don Hinton wrote:<br>
>> >> I've sent copies you and the others who expressed an interest,<br>
>> >> and will look into hosting it somewhere.<br>
>> ><br>
>> > Isn't this exactly the sort of thing that should end up in the<br>
>> > clang-tools-extras repository?<br>
>> ><br>
>> > What do others think?  Chandler, this is your thing isn't it?<br>
>><br>
>> Definitely, once the design has been discussed; my main concern would<br>
>> be that the tool nicely fits the latest extensions to clang's comment<br>
>> parsing, and has a clear strategy and maintenance story going forward.<br>
>><br>
>> Cheers,<br>
>> /Manuel<br>
>><br>
>> ><br>
>> > Cheers<br>
>> > Andy<br>
>> ><br>
>> > P.S. Don, I'd also be interested in a copy too :o)<br>
>> ><br>
>> ><br>
>> ><br>
>> > _______________________________________________<br>
>> > cfe-dev mailing list<br>
>> > <a href="mailto:cfe-dev@cs.uiuc.edu" target="_blank">cfe-dev@cs.uiuc.edu</a><br>
>> > <a href="http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev" target="_blank">http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev</a><br>
>> _______________________________________________<br>
>> cfe-dev mailing list<br>
>> <a href="mailto:cfe-dev@cs.uiuc.edu" target="_blank">cfe-dev@cs.uiuc.edu</a><br>
>> <a href="http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev" target="_blank">http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev</a><br>
><br>
><br>
</div></div></blockquote></div><br>
</div></div><br></blockquote></div><br>
<br>_______________________________________________<br>
cfe-dev mailing list<br>
<a href="mailto:cfe-dev@cs.uiuc.edu">cfe-dev@cs.uiuc.edu</a><br>
<a href="http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev" target="_blank">http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev</a><br>
<br></blockquote></div><br>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.<br>
<br>-- Matthieu<br>