Ｅｃｌｉｐｓｅで生成したＪａｖａＤｏｃのレイアウトについて

質問

４０クラスほどＪａｖａＤｏｃを生成したところ、１クラスだけ若干レイアウトが異なります。
何度再生成しても同じ結果になります。

■Ｊａｖａソース
/**
* １行目のコメント<br>
* ２行目のコメント<br>
*/
public void sample() {
System.out.println("サンプル");
}

【通常のＪａｖａＤｏｃ】
==メソッドの概要==
-メソッド名
-１行目のコメント
==メソッドの詳細==
-メソッド名
-１行目のコメント
-２行目のコメント

【問題になってるＪａｖａＤｏｃ】
==メソッドの概要==
-メソッド名
-１行目のコメント
-２行目のコメント
==メソッドの詳細==
-メソッド名
-１行目のコメント
-２行目のコメント

このように、通常のＪａｖａＤｏｃはメソッドの概要のところに２行目のコメントは表示されませんが、問題となってるＪａｖａＤｏｃでは表示されてしまいます。

他のクラスと異なる箇所があるのかと思い、よく見比べましたがわかりませんでした。

原因のわかる方がいらっしゃいましたら、ご回答よろしくお願いします。

回答No.2

pcbeginner · ベストアンサー

うろ覚えで申し訳ありませんが、
javadocでは「.」(ピリオド)までを「1文」としていたと記憶しています。
ですので、
/**
* 1行目のコメント.<br>
* 2行目のコメント.<br>
*/
とすれば良かったような…。

お礼

ご回答ありがとうございます。
pcbeginnerさんのおっしゃる通りでした。
「.」または「。」までを一文としているようです。
解決しました。ありがとうございます。

回答No.1

rinkun

1行目最後の文字によって2行目まで含めて1行目とみなされているのでしょう。
JavaDocの行分けのルールはイマイチ分かりません。特に日本語が入った場合は。ただ別の行と確実に分かるように空行を入れるなどすれば分けられると思います。
# <br>じゃなく<p>なら良いかも

お礼

ご回答ありがとうございます。
<p>で試したところ、やはり同じ結果になってしまいました。