Doxygen:多次使用部分标签错误?

Doxygen: multiple use of section label bug?

我使用 Doxygen 记录我的代码,但在使用 markdown 语法时遇到问题。

比如我有两个.dox个文件:

fileABC.dox:

/**
@page abcPage

Header {#abcHeader}
======

abc Text.
*/

fileDEF.dox

/**
@page defPage

Header {#defHeader}
======

def Text.
*/

哪个引发警告:

warning: multiple use of section label 'Header'

并且 abcHeader 部分未生成。

有两种解决方法,但其中 none 对我来说没问题:

那么,有没有另一种方法可以在多个页面中使用相同的部分名称,使用 Markdown 语法?

编辑

此错误已在版本 1.8.7 中引入:View commit

它似乎比新功能或改进更像是一个错误,因为 setext-syntax(使用 # 而不是 ==)在同一部分时不会发出警告名称被多次使用。

在 1.8.7 版中引入并在 1.8.8 版中解决的错误

Bug description -- fix