c++ - doxygen - 如何多行文件文档枚举？

Question

我正在使用 doxygen 记录一些像这样的 C++ 枚举:

/** Members */
enum {
  MEMBER_ONE, /*!< This is member one */
  MEMBER_TWO  /*!< This is member two */
} members;

文档看起来不错，但问题是带有文档超链接的代码(我说的是文件文档中的部分，如下所示:

File Documentation

file1.h

enum { MEMBER_ONE, MEMBER_TWO };

枚举源代码的所有成员之间没有任何换行符。有什么方法可以强制 doxygen 尊重换行符或插入它们？将
放在注释中仅适用于文档本身

Answer 1

Doxygen 重新格式化枚举的值，但您可以通过 ENUM_VALUES_PER_LINE 配置选项控制一行中出现的元素数量。因此，您可以将其设置为 1，以便每行获取一个项目，就像在原始源代码中一样。