<div style="font-family: arial, helvetica, sans-serif"><font size="2"><div>Figured it was good to ask this as James is busy making sure the Clang doxygen is actually all well formed, and reasonably linked together so we have proper docs for the ever growing number of Clang library users...</div>
<div><br></div>There are two ways to use doxygen directives:<div><br></div><div>/// \brief ...</div><div><br></div><div>and</div><div><br></div><div>/// @brief ...</div><div><br></div><div><br></div><div>I'd like to pick one form and be consistent going forward (with no real intention or need to clean up existing comments) just so the bikeshed stays a consistent hue.</div>
<div><br></div><div>I prefer '\brief' by a small margin, mostly because I read all of the @foo things as either email stuff, twitter stuff, or ObjC stuff. Does anyone care passionately about this bikeshed being painted the other color? If so, I cede the field. I'm much more interested in having a single preferred form than which one it is. The mixture kills me. =]</div>
<div><br></div><div>-Chandler</div></font></div>