https://svn.boost.org/trac10/ticket/6952 <p> There are a handful of comments of the form: </p> <pre class="wiki"> //! ... */ </pre><p> In at least one instance (boost/interprocess/ipc/message_queue.hpp), the code looks like this: </p> <pre class="wiki"> //!Sends a message stored in buffer "buffer" with size "buffer_size" in the //!message queue with priority "priority". If the message queue is full //!the sender is blocked. Throws interprocess_error on error.*/ void send (const void *buffer, size_type buffer_size, unsigned int priority); </pre><p> Which got rendered into the docs like so: </p> <blockquote> <p> *void send(const void * buffer, size_type buffer_size, unsigned int priority); </p> </blockquote> <blockquote> <p> Sends a message stored in buffer "buffer" with size "buffer_size" in the message queue with priority "priority". If the message queue is full the sender is blocked. Throws interprocess_error on error. </p> </blockquote> <blockquote> <p> -- <a href="http://www.boost.org/doc/libs/1_49_0/doc/html/boost/interprocess/message_queue_t.html#id985430-bb">http://www.boost.org/doc/libs/1_49_0/doc/html/boost/interprocess/message_queue_t.html#id985430-bb</a> </p> </blockquote> <p> Note the leading "*" on the method signature. </p> en-us /htdocs/site/boost.png https://svn.boost.org/trac10/ticket/6952 Trac 1.4.3 anthony.foiani@… Tue, 29 May 2012 15:43:43 GMT https://svn.boost.org/trac10/ticket/6952 https://svn.boost.org/trac10/ticket/6952 <ul> <li><strong>attachment</strong> → <span class="trac-field-new">0001-Fix-mixed-comment-style-that-might-be-confusing-doc-.patch</span> </li> </ul> <p> patch to fix mixed-style comments </p> Ticket