[PATCH 1/4] doc: use markdown tildes for code blocks

Bill Spitzak spitzak at gmail.com
Fri Dec 5 12:53:28 PST 2014

On 12/05/2014 06:44 AM, Pekka Paalanen wrote:

> do you have any suggestions on how to get rid of the asterisks in front
> of code examples?

All I can say is that this appears to be a Doxygen bug, and it depends 
both on the version of Doxygen and on what commands have been processed 
by Doxygen before it encounters this. For me 1.8.6 and do not 
produce this artifact with the current git head.

I did see 1.8.6 produce this, but only if a \code was first, then a ~~~, 
and then a \comment inside that. Obviously it is easier to trigger this 
but that was the only instance I found. You said you are using 1.8.5 so 
maybe it has this bug.

> How should we work around the lack of comment support?
> Should we just ignore our coding style when writing code examples in
> Doxygen comments?

I'm uncertain if removing the asterisks is even a good solution. If you 
have a line in there like "*pointer = value;" it apparently still 
removes the asterisk!

> Or maybe there is some doxygen.conf option we missed?

I doubt it.

More information about the wayland-devel mailing list