Doxygen：显示未记录方法的警告

Question

我已经用 doxygen 激活了警告

WARNINGS              = YES
WARN_IF_UNDOCUMENTED  = YES
WARN_IF_DOC_ERROR     = YES
WARN_NO_PARAMDOC      = YES

但是像这样的无证方法：

void AnimationManager::setAnimationTimeStep( double timeStep )
{
  ...
}

在 doxygen 生成期间不要抛出任何警告。 在这种情况下有什么方法可以显示警告吗？

同样的问题与无证返回，例如

/**
 * @brief brief description
 */
bool AnimationManager::hasAnimationTimeStep( )
{
  ...
}

不会对无证退货发出警告

Answer 1

如果您错过了原本预期的警告，请检查 EXTRACT_ALL 是否设置为 YES。

来自 doxyfile 的注释版本：

# Note: This will also disable the warnings about undocumented members that are
# normally produced when WARNINGS is set to YES.

使用EXTRACT ALL 可用于第一次通过或从非 doxygenned 源中提取某些内容，但总的来说，最好能够将其关闭，从而能够获得以下警告细化您实际需要记录的部分。