Doxygen不會擴展宏

Question

這似乎是一個非常微不足道的任務，但我無法讓Doxygen擴展宏。 我使用的是版本1.6.3,1.7.4,1.7.6和1.8.6。 我也在Google上進行了大量搜索，但仍然失敗了。

我有一個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";