Doxygen: multiple use of section label bug?

Question

I use Doxygen to document my code and I encounter a problem when I use the markdown syntax.

For example, I have two .dox files:

fileABC.dox:

/**
@page abcPage

Header {#abcHeader}
======

abc Text.
*/

fileDEF.dox

/**
@page defPage

Header {#defHeader}
======

def Text.
*/

Which raise the warning:

warning: multiple use of section label 'Header'

and the abcHeader section is not generated.

There is two workaround, but none of them is ok for me:

• Rename the section to ABC Header and DEF Header
• Or go back to the Doxygen syntax @section abcHeader Header

So, is there another way to use the same section name in several pages, with the Markdown syntax ?

EDIT

This bug has been introduced in version 1.8.7 : View commit

It seems to be more a bug than a new feature or improvement since the setext-syntax (using # instead of ==) does not give a warning when the same section name is used several times.

Answer 1

Bug introduced in version 1.8.7 and resolved in version 1.8.8

Bug description -- fix