[PATCH 5/6] utils: Ensure wl_list's doxygen formats properly

Bill Spitzak spitzak at gmail.com
Tue Sep 17 12:45:59 PDT 2013

Doxygen itself can parse nested C comments. So a solution I found is this:

/** This is some documentation.
  * Example:
  * \code
  * /* look this is a c-style comment! */
  * \endcode

>> Unfortunately, it doesn't seem possible to get Doxygen not to escape the
>> ampersand in / unless it's within a \htmlonly block. On top of that, a
>> \code block disables Doxygen commands, so \htmlonly sadly isn't available.

More information about the wayland-devel mailing list