Eclipseで、クラスを新規作成する時に付いてくるコメント

Eclipseで、クラスを新規作成する時に付いてくるコメント
クラスを新規作成すると、自動的に下記のようなコメントが
書かれてきますが、いつもいちいち行削除しています。
一般的には、このままにしておくものなのでしょうか。
それとも、消した方が良いのでしょうか。
宜しく御願い申し上げます。

public class Sample {
/**
* @param args
*/
public static void main(String[] args) {
// TODO 自動生成されたメソッド・スタブ
}
}

No.1 回答者： SaKaKashi 回答日時： 2010/05/08 01:48

ちゃんと記述すればJavadocでドキュメントが出来ます。

この回答へのお礼

御回答ありがとうございました。
「ちゃんと記述する」とは何をしたら良いかわかりませんでした。
せっかく回答をして下さったのにすみません。
でもありがとうございました。

お礼日時：2010/05/10 10:55

No.2 回答者： buriburi3 回答日時： 2010/05/08 03:20

普通はもっと書き足してJavaDocが生成されるようにする。

http://ja.wikipedia.org/wiki/Javadoc

この回答へのお礼

御回答ありがとうございました。
知らない単語が多く、文章を理解することが出来ませんでした。
でも、勉強を続けていけばこういった説明がわかるように
なる事を期待してます。
ありがとうございました。

お礼日時：2010/05/10 11:01

No.3 ベストアンサー 回答者： hoge_piyo 回答日時： 2010/05/08 05:21

eclipseのバージョンやエディションによって多少違うかもしれませんが・・・

必要ないなら、クラスを追加するときの最後の
「コメントを追加しますか？」
というチェックボックスを外せばいいだけです。

また
ウインドウ→設定→Java→コード・スタイル→コード・テンプレート→コメント

を編集すれば、生成されるコメントを変えることができます。
自動でファイルを生成した時点で、作成した日付や作者を注入したりすることもできます。しかも、クラスや、ファイルの先頭、コンストラクタ、オーバーライドする関数、getter、setterなどと、種類ごとに設定しておくことができ、ファイルの生成時意外も、あとからコメントを注入したい箇所で
「スラッシュ＋アスタリスク＋アスタリスク＋Enter」
を入力するだけで、それらのコメントのテンプレートが自動で注入されるようになります。
意外と使いこなすと便利な機能なので、使用する事をおすすめします。(わたしの場合個人でプログラムさくせいするときも使ってます)

他にもeclipseは、
import文、toStringやgetter、setter、try-catchのテンプレート、オーバーライドしなければいけない関数、を自動生成してくれる機能や、エラー箇所の修正候補の表示、自動で変更していない変数にfinalをつけるなどなど上げればキリがないですが、
使いこなすと、実際キーボードで打つのは半分以下になるので少しずついろいろな機能をためしてみるといいでしょう。

この回答へのお礼

御回答ありがとうございました。
よくわかって、ちゃんと理解出来ました。
そして、表示させたり、させなくしたりと両方出来る様になり、
とても嬉しいです。
また、コード入力が半分以下になるなんて正直驚きました。
御指導有難う御座いました。

お礼日時：2010/05/10 11:47

No.4 回答者： hoge_piyo 回答日時： 2010/05/08 05:31

すいませんもう一点補足・・・

それらのコメントのテンプレートの設定ファイルや、
フォーマットの設定ファイル(メソッドの中括弧の前に改行するのか、後に改行するか、インデントはいくつかなどをかなり細かく設定できる)
などは、基本的にすべてxmlファイルとしてエクスポート＆インポートができるので、
複数人で開発する場合、それらのファイルを共有するようにすれば、コーディングスタイルを共有化することができます。

この回答へのお礼

補足をどうもありがとうございます。
実は、中括弧の改行の件もどうにかならないのかと思っていたので、
補足して頂けて感謝しております。ありがとうございます。

お礼日時：2010/05/10 11:54