doxygen - 在 C++ 中注释代码区域以进行 Doxygen 识别

Question

有没有办法将 Doxygen 可以理解的注释块添加到代码区域（由#pragma 区域描述）？

换句话说，我想在一组函数之前添加一个 Doxygen 可以识别的注释：

/**********************//**
* \some-doxygen-tag-here ?
**************************/
#pragma region Demo Functions
.....
.....
#pragma endregion

Answer 1

Doxygen 模块组可以在这里提供帮助。组可以有文档，您可以标记组的开始和结束。组在输出文档中称为模块（不确定是否可以轻松更改）。

/** @defgroup demofuns Demo Functions
 *  Documentation of the following code block, i. e. group.
 *  @{
 */
#pragma region Demo Functions
.....
.....
#pragma endregion
/** @} */ // end of demofuns

请参阅http://doxygen.org/manual/grouping.html。