显示未记录的函数参数 我使用DoXEGEN来生成C++代码的HTML文档。不幸的是,doxygen在方法描述中没有显示未记录的方法参数。例如,使用以下 /** * Some method * @param p1 Some param */ void method(const std::string& p1, const std::string& p2);

显示未记录的函数参数 我使用DoXEGEN来生成C++代码的HTML文档。不幸的是,doxygen在方法描述中没有显示未记录的方法参数。例如,使用以下 /** * Some method * @param p1 Some param */ void method(const std::string& p1, const std::string& p2);,doxygen,Doxygen,方法说明将显示注释和参数p1,但不显示p2 如何配置doxygen以列出方法描述中的所有参数,即使没有明确记录?这是不可能的 不过,Doxygen可以警告您参数文档不完整、错误或缺失 相关设置包括: WARNINGS = YES WARN_IF_DOC_ERROR = YES WARN_NO_PARAMDOC = YES 恐怕这是不可能的(我可能错了)。参数p2出现在doxygen文档中的方法签名中,这还不够吗?如果您希望它也出现在参数列表中,我认为您必须对其进行记录(您可

方法说明将显示注释和参数
p1
,但不显示
p2

如何配置doxygen以列出方法描述中的所有参数,即使没有明确记录?

这是不可能的

不过,Doxygen可以警告您参数文档不完整、错误或缺失

相关设置包括:

WARNINGS          = YES
WARN_IF_DOC_ERROR = YES
WARN_NO_PARAMDOC  = YES

恐怕这是不可能的(我可能错了)。参数
p2
出现在doxygen文档中的方法签名中,这还不够吗?如果您希望它也出现在参数列表中,我认为您必须对其进行记录(您可以将文档留空,例如,仅使用
\param p2
)。在我看来,当所有参数都列出且未记录的参数都有空白注释(如JavaDoc中)时,它看起来更加一致。记录所有参数当然可以解决这个问题,但我可以直接写评论。;)