<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On Mon, Dec 4, 2017 at 9:21 PM, Julie Hockett via cfe-dev <span dir="ltr"><<a href="mailto:cfe-dev@lists.llvm.org" target="_blank">cfe-dev@lists.llvm.org</a>></span> wrote:<br></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><span id="m_-6542414250764604232gmail-docs-internal-guid-4ab54f72-232a-73d9-2464-0a2aec30f523"><p style="line-height:1.38;margin-top:0pt;margin-bottom:0pt;text-indent:36pt"><span style="text-indent:36pt;background-color:transparent;font-size:11pt;font-family:Arial;color:rgb(0,0,0);vertical-align:baseline;white-space:pre-wrap">Since a good deal of existing C/C++ code uses the Doxygen documentation comment style, which is also supported by Clang's parser (and Doxygen itself can use Clang to parse these comments</span><span style="text-indent:36pt;background-color:transparent;font-size:11pt;font-family:Arial;color:rgb(0,0,0);vertical-align:baseline;white-space:pre-wrap">), this is the syntax we are going to support as well. In the future, we would also like to support Markdown-style comments, akin to Apple Swift Markup</span><span style="text-indent:36pt;background-color:transparent;font-size:11pt;font-family:Arial;color:rgb(0,0,0);vertical-align:baseline;white-space:pre-wrap">.</span></p></span></div></blockquote><div>Needless to say<span style="text-indent:36pt">, a good deal of existing C/C++ code does not use the Doxygen documentation comment style, or any other explicit markup style.</span></div><div>Additionally, doxygen (and similar things like Javadoc) sacrifice some readability of the comments for the documentation.</div><div><br></div><div>For these reasons, it'd be great to have first-class support for "plain" comments. (Even though it's a hard problem)</div></div></div></div>