id	summary	reporter	owner	description	type	status	milestone	component	version	severity	resolution	keywords	cc
6952	[interprocess] mixed comment styles causing documentation issues?	anthony.foiani@…	Ion Gaztañaga	"There are a handful of comments of the form:


{{{
  //! ... */
}}}


In at least one instance (boost/interprocess/ipc/message_queue.hpp), the
code looks like this:


{{{
   //!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);
}}}


Which got rendered into the docs like so:

   *void send(const void * buffer, size_type buffer_size, unsigned int priority);

   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.

   -- http://www.boost.org/doc/libs/1_49_0/doc/html/boost/interprocess/message_queue_t.html#id985430-bb

Note the leading ""*"" on the method signature.
"	Bugs	new	To Be Determined	interprocess	Boost 1.49.0	Cosmetic