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

[Bill Spitzak]

However I think the decision was to only require Doxygen 1.6 and 
therefore the tildes don't work, and you must use \code. Is this 
correct? This is what is currently in git head.

On 12/08/2014 01:35 AM, Pekka Paalanen wrote:
> On Fri, 05 Dec 2014 12:53:28 -0800
> Bill Spitzak <spitzak at gmail.com> wrote:
>
>> 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 1.7.6.1 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.
>
> Yes indeed:
> https://bugzilla.gnome.org/show_bug.cgi?id=707567
>
> Upgrading to 1.8.6 solved the problem for me, and since I'm probably
> the one to be uploading the generated docs to the Wayland website, I'd
> say problem solved.
>
>
> Thanks,
> pq
>