doxygen - 文書化されていない関数パラメーターを表示

Question

C++ コードの HTML ドキュメントを生成するために doxygen を使用しています。残念ながら、doxygen はメソッドの説明に文書化されていないメソッド パラメータを示していません。たとえば、次のように

/**
 * Some method
 * @param p1 Some param
 */
void method(const std::string& p1, const std::string& p2);

メソッドの説明にはコメントとパラメーターp1が表示されますが、表示されませんp2。

明示的に文書化されていない場合でも、メソッドの説明にすべてのパラメーターをリストするように doxygen を構成するにはどうすればよいですか?

Answer 1

これは不可能です。

ただし、Doxygen は、パラメーターのドキュメントが不完全、間違っている、または欠落している場合に警告することができます。

関連する設定は次のとおりです。

WARNINGS          = YES
WARN_IF_DOC_ERROR = YES
WARN_NO_PARAMDOC  = YES