<html><head><meta http-equiv="Content-Type" content="text/html charset=us-ascii"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;"><br><div><div>On May 9, 2013, at 8:53 AM, Dmitri Gribenko <<a href="mailto:gribozavr@gmail.com">gribozavr@gmail.com</a>> wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div style="letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;">On Thu, May 9, 2013 at 2:38 AM, Fariborz Jahanian <<a href="mailto:fjahanian@apple.com">fjahanian@apple.com</a>> wrote:<br><blockquote type="cite">Author: fjahanian<br>Date: Wed May 8 18:38:56 2013<br>New Revision: 181487<br><br>URL:<span class="Apple-converted-space"> </span><a href="http://llvm.org/viewvc/llvm-project?rev=181487&view=rev">http://llvm.org/viewvc/llvm-project?rev=181487&view=rev</a><br>Log:<br>put noisy "unknown command tag name" warning<br>under -Wdocumentation-unknown-command and off by default.<br>patch by Dmitri Gribenko.<br></blockquote><br>Hi Fariborz, Doug,<br><br>This turned out to be not good enough:<br><br><a href="http://lab.llvm.org:8011/builders/llvm-clang-lld-x86_64-debian-fast/builds/2358/steps/build/logs/warnings%20%283808%29">http://lab.llvm.org:8011/builders/llvm-clang-lld-x86_64-debian-fast/builds/2358/steps/build/logs/warnings%20%283808%29</a><br><br>We could fix all the warnings (doable, there are just a few headers<br>that are included all over the place), but writing '\n' in a comment<br>is not too uncommon, IMHO. So I think we should not warn about<br>unknown single-character commands (or at least in cases where it is a<br>known escape sequence).<br><br>What do you think about this?<br></div></blockquote><div><br></div><div>This seems like a reasonable heuristic.</div><br><blockquote type="cite"><div style="letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;">(My personal opinion is that selecting \ or @ for a command marker in<br>Doxygen was a bad choice, but that ship has sailed long ago...)<br></div></blockquote></div><br><div>We don't get to fix that now :(</div><div><br></div><div><span class="Apple-tab-span" style="white-space:pre"> </span>- Doug</div></body></html>