【问题标题】:Doxygen strip closing instructions of comments in code block in markdownMarkdown 中代码块中注释的 Doxygen 条关闭指令
【发布时间】:2016-11-23 14:45:42
【问题描述】:

当我尝试在 .md(markdown) 文件中包含代码块时,doxygen 会剥离 cmets 的关闭指令。如何在降价文件中插入带有 /** ... */ 指令的多行注释? STRIP_CODE_COMMENTS 参数设置为 NO

Example:
~~~~
namespace ExternalApi\Model;
/**
* Description of class
*/
class Exception extends AbstractException
{}
~~~~

氧气输出:

namespace ExternalApi\Model;
/**
* Description of class

class Exception extends AbstractException
{}

【问题讨论】:

  • 您使用的是哪个版本的 doxygen(当前版本是 1.8.12)?此评论所在的文件的扩展名是什么?如果您只是将提到的 sn-p 放在 markdown 文件中会发生什么?
  • 我使用 1.8.6(我知道,这不是实际版本,但我们需要这个版本,因为我们的旧 markdown 文件具有许多 h1 的能力),我们的文件扩展名为 .md(降价文件)。我的代码块已经放在 markdown 文件中。这是我的旧版本中的一个已知错误,还是可能存在决定这个问题的秘密选项?
  • 在我看来就像旧版本中的错误。在 1.8.12 版本中是可以的。您在使用较新版本时遇到什么问题?也许您可以为此参考现有的错误报告,或者创建一个或提交扩展请求。

标签: comments markdown doxygen


【解决方案1】:

是的,这是一个错误。 在 1.8.7 中所有的作品。 在 1.8.12 中也可以使用

【讨论】:

    猜你喜欢
    • 2014-04-29
    • 2012-11-24
    • 1970-01-01
    • 1970-01-01
    • 2014-09-23
    • 2012-09-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多