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

Macros/variables/etc 内部函数体是 outside the scope of Doxygen，因此此时没有为它们生成文档。

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

Why macro defined within a C function is not documented by Doxygen?

c

doxygen