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] ... Arguments for format specification。这将正确显示在您生成的文档中。

没有关于 the andthough 消歧义的const char*线索const wchar_t*。