Boost C++ Libraries: Ticket #12184: clang -Wdocumentation warning https://svn.boost.org/trac10/ticket/12184 <p> I get the following documentation warning (-Wdocumentation) with clang: </p> <p> include/boost/intrusive/slist.hpp:1208:55: warning: not a Doxygen trailing comment [-Wdocumentation] </p> <blockquote> <p> const_iterator last_x(x.previous(x.end())); <em>&lt;- constant time if cache_last is active </em></p> <blockquote> <p> <sup><del>~ <em>/&lt; </em></del></sup></p> </blockquote> </blockquote> <p> It's not serious but since "<em>&lt;" looks like, but is not, a Doxygen documentation comment clang warns about it. Switching from "</em>&lt;" to "<em>" in the following line resolves the issue for me: </em></p> <p> <a class="ext-link" href="https://github.com/boostorg/intrusive/blob/develop/include/boost/intrusive/slist.hpp#L1268"><span class="icon">​</span>https://github.com/boostorg/intrusive/blob/develop/include/boost/intrusive/slist.hpp#L1268</a> </p> en-us Boost C++ Libraries /htdocs/site/boost.png https://svn.boost.org/trac10/ticket/12184 Trac 1.4.3 Ion Gaztañaga Sat, 02 Jul 2016 21:15:58 GMT status changed; resolution set https://svn.boost.org/trac10/ticket/12184#comment:1 https://svn.boost.org/trac10/ticket/12184#comment:1 <ul> <li><strong>status</strong> <span class="trac-field-old">new</span> → <span class="trac-field-new">closed</span> </li> <li><strong>resolution</strong> → <span class="trac-field-new">fixed</span> </li> </ul> <p> Thanks for the report. Fixed in commit: </p> <p> <a class="ext-link" href="https://github.com/boostorg/intrusive/commit/56e2e4345a7d0bc80536747f2b2d916ff98c0ccc"><span class="icon">​</span>https://github.com/boostorg/intrusive/commit/56e2e4345a7d0bc80536747f2b2d916ff98c0ccc</a> </p> Ticket