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 对我来说没问题:
- 将部分重命名为
ABC Header
和 DEF Header
- 或者回到 Doxygen 语法
@section abcHeader Header
那么,有没有另一种方法可以在多个页面中使用相同的部分名称,使用 Markdown 语法?
编辑
此错误已在版本 1.8.7
中引入:View commit
它似乎比新功能或改进更像是一个错误,因为 setext-syntax(使用 # 而不是 ==)在同一部分时不会发出警告名称被多次使用。
在 1.8.7 版中引入并在 1.8.8 版中解决的错误
我使用 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 对我来说没问题:
- 将部分重命名为
ABC Header
和DEF Header
- 或者回到 Doxygen 语法
@section abcHeader Header
那么,有没有另一种方法可以在多个页面中使用相同的部分名称,使用 Markdown 语法?
编辑
此错误已在版本 1.8.7
中引入:View commit
它似乎比新功能或改进更像是一个错误,因为 setext-syntax(使用 # 而不是 ==)在同一部分时不会发出警告名称被多次使用。
在 1.8.7 版中引入并在 1.8.8 版中解决的错误