ということで、完了しました。 成果物は以下からどうぞ。 https://megascus.github.io/servlet-spec/docs/apidocs/ 今まで英語を読むだけならできると思ってたけどぜんぜん読めてなかったんだなぁという。。。。 ちょっと休んだらもういくつかを勉強もかねて翻訳しても良いのかもしれないと思った。
Javaのアプリケーションを作成する時に、メンテナンスなどを考えて各プログラムの仕様書を作成しなければいけない場合があります。ソースコードに含まれるクラスや、クラスに含まれるメソッドなどを後から調べて仕様書を作成するのは大変です。 JavadocはJDKに標準で含まれているプログラムで、ソースコードに含まれるクラスやメソッドのコメントから自動で仕様書を作成してくれる便利なツールです。ここではJavadocの記述方法を中心に使い方を確認していきます。 Javadocに準拠したコメントの記述方法を学習することで、Javaのプログラミングにおけるコメントの記述方法の標準を学習することもできます。 Javadocで生成されるドキュメント Javadocの対象となるコメントの記述方法 ドキュメントの作成
Javaの特殊なコメント。 コメントの書き方がルール化され、それを元に説明書を作成することが出来る。 クラス・メソッド・フィールド(変数)にJavadocコメント(説明)を付けられるので、それらの説明が見られることになる。 Javadocと言った場合、「Javadocコメントの書き方」と、それを元に生成された「API仕様(HTML文書)」のいずれかを指すことが多い。 後者は、Javaの(標準ライブラリーの)API仕様が有名。→Javadocの読み方(入門者向け) Javadocの生成方法 Javadoc生成用のコマンドを使って、JavaのソースファイルからHTMLを生成する。 javadocコマンド … これが一番基本 Eclipseを使ったJavadoc生成 … お手軽に作りたいなら、これが一番楽 Antのjavadocタスク(javadocタグ) … 何度も自動生成したいなら、これが一
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く