<div class="gmail_quote">On Tue, Jun 12, 2012 at 11:59 PM, Sean Silva <span dir="ltr"><<a href="mailto:silvas@purdue.edu" target="_blank">silvas@purdue.edu</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I'm kind of against the backslash-escaping because it makes the comments uglier to read in the source. What does doxygen do with @ and # anyway? Is there a way to tell doxygen "don't give @ and # the special meaning"?</blockquote>
<div><br></div><div>I really don't think this is the priority. Instead I think the priority of making our web-based documentation significantly more usable is correct.</div><div><br></div><div>Also, '@' is used in several parts of the codebase for doxygen.</div>
<div><br></div><div>Finally, I think you're overestimating how hard it is to read backslash-escaping. It's something C++ developers should be pretty familiar with...</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div>Another thing to consider is that if programmer awareness of this isn't raised, then all of these changes are "going against the grain" of new comments, and will suffer a kind of "rot" in that respect.</div>
</blockquote><div><br></div><div>This is what code review is for.</div></div>