c - 为什么 Doxygen 没有记录在 C 函数中定义的宏？

Question

我在名为 foo.c 的文件中有以下代码。

/** @file */
#include <stdio.h>

/** Prints hello */
#define hello() printf("hello, ")

int main()
{
    /** Prints world */
    #define world() printf("world\n")
    hello();
    world();
}

我在同一目录中有一个名为 Doxyfile 的文件。

PROJECT_NAME = Foo
JAVADOC_AUTOBRIEF = YES

当我运行 doxyfile 命令时，我得到一个如下所示的文档。

为什么没有为 world() 宏生成文档？我如何才能确保为 world() 宏生成文档而不将其带出函数 main()？

Answer 1

函数体内的宏/变量/等是outside the scope of Doxygen因此此时没有为他们生成文档。