C++ Doxygen中预处理器定义的组级文档

我有一个C/C++头文件，它定义了多组预处理器符号。这些组中的每个组在组级别都应有自己的文档，组中的每个符号都应有一行文档

我使用defgroup/addtogroup建立了组，每个组都很好地显示在Modules选项卡中，其中包含所需的符号

我无法实现的是集团层面的文档编制。无论我尝试了什么，都会显示组级别的文档，但是作为组的第一个符号的文档

例如：

/**
 * @defgroup group-1 Preprocessor symbols group 1
 * @{
 */
/**
 * @brief Brief description of group 1.
 *
 * Long description of group 1.
 */
#define GROUP1_SYM1 1  ///< Meaning of symbol 1
#define GROUP1_SYM2 2  ///< Meaning of symbol 2
/**
 * @}
 */

/**
*@defgroup group-1预处理器符号组1
* @{
*/
/**
*@第1组的简要说明。
*
*第1组的详细说明。
*/
#定义符号1的含义
#定义符号2的含义
/**
* @}
*/

在输出中，组的模块页面有一个空的“详细说明”部分，“宏定义文档”部分中的组1_SYM1条目包含：

Brief description of group 1. Long description of group 1. Meaning of symbol 1 第1组的简要说明。 第1组的详细说明。 符号1的含义 我想实现的是，简短描述显示在组的模块页面顶部，长描述显示在“详细描述”部分，每个符号的描述只有代码中规定的一行描述

我还尝试在

#define

语句组周围添加

{

和

}

，但这并没有改变任何事情

我做了回顾，但虽然它展示了如何对预处理器符号定义进行分组，但它没有组级描述（组标题除外）

---

我在Ubuntu 14.04上使用的是doxygen 1.8.6。

将组的文档放在组定义中，而不是放在成员列表的下面：

/**
 * @defgroup group-1 Preprocessor symbols group 1
 * 
 * @brief Brief description of group 1.
 *
 * Long description of group 1.
 */

/**
 * @addtogroup group-1
 * @{
 **/

---

将组的文档放在组定义中，而不是放在成员列表的下面：

/**
 * @defgroup group-1 Preprocessor symbols group 1
 * 
 * @brief Brief description of group 1.
 *
 * Long description of group 1.
 */

/**
 * @addtogroup group-1
 * @{
 **/

---

完全相同的问题。我找不到实现这一点的Doxygen语法。这应该是Doxygen的一个基本操作，因为我相信我们不是唯一使用这种编码方式的可怜的灵魂。完全相同的问题。我找不到实现这一点的Doxygen语法。这应该是Doxygen的一个基本操作，因为我相信我们不是唯一使用这种编码方式的可怜的灵魂。完全相同的问题。我找不到实现这一点的Doxygen语法。这应该是Doxygen中的一个基本操作，因为我确信我们不是唯一使用这种编码方式的可怜的灵魂。