Eclipseの変な仕様とPleiades
Eclipseには変な仕様があります。
メソッドを呼んでいるところにマウスカーソルをもっていくとJavaDocがホバー表示されるのですがたとえばrt.jarに対して日本語のJavadocとソースを両方指定しているとなぜかソースの方の英語のJavadocコメントの方を参照してしまいます。
MergeDocを使って日本語コメント入りのソースを事前に作っておくという手もありますが、あちこちに日本語コメント入りソースを持ち運ぶのも面倒なのでeclipse3.3まではeclipseのソースをいじっていました。
3.4+pleiadesにしてみたら変更なしで日本語のホバーになりました。AOPを使って参照順を変えているそうです。やりますねPleiades。