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

【问题标题】：Commenting a region of code in C++ for Doxygen recognition在 C++ 中注释代码区域以进行 Doxygen 识别
【发布时间】：2013-03-10 23:35:59
【问题描述】：

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

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

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

【问题讨论】：

标签： doxygen

【解决方案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。

【讨论】：