爲什麼在C函數中定義的宏沒有被Doxygen記錄下來？

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，因此目前沒有爲它們生成文檔。