最近、Javaのお仕事をしているのですが、ドキュメントの生成にはもちろんjavadocを使ってます。
javadocではコメントに記述している引数が、実際のメソッド引数にない場合は警告を出してくれます。
ただ、開発者がよくやるのは、メソッドの引数を増やし、その引数のコメントを書き忘れるって行動。
この場合、javadocは警告してくれません。
(実はオプションであったりして...)
で、先日気づいたのですが、ドキュメント生成ツールであるDoxygenがこの記入忘れのコメントを警告で出してくれるという事実。
これは使える...