c++ - 用于记录具有可变参数的重载函数的 Doxygen

Question

是否可以让 doxygen 为这样的代码创建适当的文档:

void Print(const char* pszFormat, ...);
void Print(const wchar_t* pszFormat, ...);

这段代码有两个问题。首先，我不能从代码的其他部分引用这两个函数。 对于 \ref Print(const char*, ...); 和 \ref Print(const wchar_t*, ...); 仅链接到上述声明之一生成。

变量参数也以必须描述的预定义格式放置。尝试使用 '\param' 标签会导致在函数声明中找不到参数的警告。由于我有多个这样的功能，如果可能的话，我想摆脱专门针对这种情况的警告。

提前致谢。

Answer 1

如果您按字面意思将参数指定为...，它将被 Doxygen 获取。例如。如下:\param[in] ... 格式规范的参数。这将正确显示在您生成的文档中。

虽然没有关于 const char* 和 const wchar_t* 消歧的线索。