Eclipseでは、Javadocでジェネリック型の制約をどのように表示できますか？

Question

Eclipseでは、要素にカーソルを置くと、Javadocだけが表示され、要素の（拘束されていない）署名が表示されます。

class X <T extends Object> {}があるとします。 EclipseのJavadocジェネレータを使用すると、次のようになります。

/** 
* @param <T> 
*/ 

レンダリングされたJavadocはこのようになります。型制約情報がないことに注意してください。

EclipseでのJavadocビューアからジェネリック型の制約を表示する方法はありますか？

Answer 1

この問題を解決するためにEclipse bug/enhancementと入力しました。信じられないほど、Markus Kellerは実際に提出から3〜4時間以内にこれを実装/修正しました！

Answer 2

クラスの本体にはすでにT extends Objectと書かれていますが、javadocではその必要はありません。

（コードまたはのjavadocなどのコメント）物事を文書化、これらの2つの規則に従います。

• は自分を繰り返さないでください。これに従わないと、コメントとコードを同期させるのがずっと難しくなります。
• 明確な内容を文書化しないでください。あなたのコードの読者は、その言語を知っています。例えばキャストをしたことを説明する代わりに、WHYをキャストしました。