Big Sky

最近、Javaのお仕事をしているのですが、ドキュメントの生成にはもちろんjavadocを使ってます。

javadocではコメントに記述している引数が、実際のメソッド引数にない場合は警告を出してくれます。

ただ、開発者がよくやるのは、メソッドの引数を増やし、その引数のコメントを書き忘れるって行動。

この場合、javadocは警告してくれません。
(実はオプションであったりして...)


で、先日気づいたのですが、ドキュメント生成ツールであるDoxygenがこの記入忘れのコメントを警告で出してくれるという事実。

これは使える...