为什么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

函数体内的宏/变量/ etc是outside the scope of Doxygen，因此目前没有为它们生成文档。