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

[Bill Spitzak]

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

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

>> 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.
>>