【发布时间】: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 版本中是可以的。您在使用较新版本时遇到什么问题?也许您可以为此参考现有的错误报告,或者创建一个或提交扩展请求。