【发布时间】:2015-06-29 14:40:52
【问题描述】:
我使用 Doxygen 来记录我的代码,但在使用 markdown 语法时遇到了问题。
例如,我有两个.dox 文件:
文件ABC.dox:
/**
@page abcPage
Header {#abcHeader}
======
abc Text.
*/
文件DEF.dox
/**
@page defPage
Header {#defHeader}
======
def Text.
*/
引发警告:
warning: multiple use of section label 'Header'
并且不会生成abcHeader 部分。
有两种解决方法,但对我来说都没有问题:
- 将该部分重命名为
ABC Header和DEF Header - 或者回到 Doxygen 语法
@section abcHeader Header
那么,有没有另一种方法可以在多个页面中使用相同的部分名称,使用 Markdown 语法?
编辑
此错误已在版本1.8.7 中引入:View commit
这似乎更像是一个错误而不是新功能或改进,因为 setext-syntax(使用 # 而不是 ==)在多次使用相同的部分名称时不会发出警告.
【问题讨论】:
-
无法在 Ubuntu 14.04x64 上的 Doxygen 1.8.6 中重现此问题。您使用哪个版本的 Doxygen?
-
我用
v1.8.4(=> 没有错误)和v1.8.7(=> 存在错误)进行了测试 -
等等。 1.8.4 不 包含错误,而 1.8.7 包含?好吧,那么它可能是1.8.7引入的缺陷,除非1.8.6。也不会产生您想要的输出。检查 1.8.7 更新日志,也许有提示。
-
是的,我确认:
1.8.4不包含错误。我会检查更新日志。 -
在我看来问题已经在 1.8.8 版本中解决了