【问题标题】:Doxygen: multiple use of section label bug?Doxygen:多次使用部分标签错误?
【发布时间】: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 HeaderDEF 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 版本中解决了

标签: markdown doxygen


【解决方案1】:

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

Bug description -- fix

【讨论】:

    猜你喜欢
    • 2021-10-04
    • 2011-10-24
    • 2018-07-02
    • 2012-05-11
    • 2012-08-10
    • 2014-10-07
    • 2018-06-11
    • 2020-05-01
    • 1970-01-01
    相关资源
    最近更新 更多