Javaのコメント記述

Javaを使った開発案件が少しずつ発生しているため、作ってみたもののいろいろ不明な点が多く、 悪戦苦闘中です。そんなわけで、基礎からまとめていこうと思っております。

Hello World!は終わったので、次はコメントです(笑)

Javaでのコメントの書き方

Javaプログラムでコメントを書くには、次の3つの方法があります。

1.複数行のコメント

/* コメント1
コメント2
コメント3 */

/**/の間がコメントとされ、複数行のコメントを作成できます。

2.単一行コメント

// コメント

//で始まる場合、行末までがコメントとなります。

3.ドキュメントに出来るコメント

/** コメント1
コメント2
コメント3 */

Javaでプログラムを行う場合、javadocといわれるドキュメントに出くわすことがあります。

上記のコメント形式で作成されたコメントは、javadocツールを使うことによりドキュメント化することができます。

参考

一例ですが、javadocツールでは、次のようなコマンドでドキュメントを生成してくれます。

javadoc -public -d doc -sourcepath src net.bnote.hoge net.bnote.hogehoge