如何定义自己的Doxygen注释风格？

Question

我想知道是否有可能定义自己的doxygen注释样式。通常的样式类似于这样（类似于Javadoc）：

/**
*
*   Descriptions and stuff
*
*/

或者（使用Qt时）：

/*!
*
*   Descriptions and stuff
*
*/

我更倾向于类似于以下的方式

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

但是doxygen解析器不允许这种语法。因此，我的问题是，是否有一种方法可以定义自己的注释风格。

- Exa

Answer 1

我认为你不能定义自己的注释样式，但是通过对格式进行一些微小的更改，它可能会匹配。

请参阅Doxygen文档中有关文档块的页面：

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

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

请注意，使用2个斜杠可以结束普通注释块并开始特殊注释块。

或者

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

- tomlogic

---

是的，我已经尝试了第一个，并且发现它非常好，因为它比第二个例子更令人愉悦。我只是想可能有一种方式可以自定义样式，无论如何还是谢谢 :) - Exa