この記事の要約:Javaのドキュメンテーションコメント(doc comments)は、プログラマ向けの参照ドキュメントをコードに直接関連付ける機構です。本章では、docコメントの構文(/** ... */)と、外部ツール(javadoc)がHTML形式のドキュメントを生成する仕組み ...
Javaを使ったシステム開発を学ぶ上で、プログラムの動きそのものと同じくらい重要になるのが「コメント」の記述です。 ソースコードはコンピュータを動かすための命令書であると同時に、一緒に働く他の開発者や、数ヶ月後の「未来の自分」が読むため ...