comments - 如何定义自己的 doxygen 评论样式？

Question

我想知道是否可以定义自己的 doxygen 注释样式。通常的风格是这样的(类似 Javadoc):

/**
*
*   Descriptions and stuff
*
*/

或(使用 Qt 时):

/*!
*
*   Descriptions and stuff
*
*/

我更喜欢类似的东西

/*!===============================================================
*
*   Descriptions and stuff
*
================================================================*/

但是 doxygen 解析器不允许这种语法。所以我的问题是，如果有办法到 定义自己的评论样式 .

Answer 1

我不认为您可以定义自己的评论样式，但是对格式进行一些细微的更改，它可能会匹配。

在 documentation blocks 上查看此页面在 Doxygen 文档中:

有些人喜欢让他们的注释块在文档中更明显。为此，您可以使用以下内容:

/********************************************//**
 *  ... text
 ***********************************************/

(注意用 2 个斜杠结束普通注释块并开始一个特殊注释块)。

或者

/////////////////////////////////////////////////
/// ... text ...
/////////////////////////////////////////////////