Doxygen 不扩展宏

Question

这似乎是一项非常微不足道的任务，但我无法让 Doxygen 扩展宏。我使用了 1.6.3、1.7.4、1.7.6 和 1.8.6 版本。我也在谷歌上做了很多搜索，但仍然失败得很惨。

我有一个 c++ 文件，其中只包含以下几行（复制 Doxygen 文档）：

#define CONST_STRING const char *
 static CONST_STRING version = "2.xx";

我已按照文档进行设置：

ENABLE_PREPROCESSING   = YES
MACRO_EXPANSION        = YES

然后添加以下内容：

EXPAND_ONLY_PREDEF     = YES
EXPAND_AS_DEFINED      = CONST_STRING 

然后

SKIP_FUNCTION_MACROS   = YES (previously NO)

我从代码生成中得到的只是：

1 #define CONST_STRING const char *
2 static CONST_STRING version = "2.xx";

我做错了什么？任何建议表示赞赏。

Answer 1

是什么让你觉得你做错了什么？

您应该会在该源文件的文档页面的“变量”部分看到version。如果您启用了源代码输出，变量 version 应该超链接到该变量文档。

如果您在变量定义前加上 doxygen 注释，您的文档会看起来更好。继续这个例子，

//! Define a constant string type.
//! @deprecated Use the typedef const_string_t instead.
#define CONST_STRING const char *

//! Software version number
static CONST_STRING version = "2.xx";