javadoc定数フィールド値の文字化けについて

質問

定数フィールド値にマルチバイト文字を記述すると、javadoc出力で該当の箇所が文字化けしてしまいます。
「そもそもWindowsだとUTF-8のファイルはダメ(LinuxならOK)」、「JDKのバグ(このバージョンだと大丈夫)」など、何かお気づきの点があればご教示ください。

[環境]
・OS：WindowsXP SP3
・JDK：1.5.0_17

[実行したコマンド]
javadoc -private -charset Windows-31J -encoding UTF-8 -docencoding Windows-31J -sourcepath [パス] [パッケージ]

※ やりたいことは、「UTF-8」のソースファイルから「Shift_JIS」のjavadocを作成することです。

[Javaソース]
・文字コード：UTF-8
・改行コード：LF(CRLFでも同じ)
・記述内容
　javadocコメントはマルチバイト文字で記述 -> 文字化けしない
　定数フィールド値もマルチバイト文字で記述 -> 文字化けする
　　例）
　　/** ほげ */
　　private static final String hoge = "あいうえお";
　　　-> フィールドの概要は文字化けせずに「ほげ」が出力される
　　　-> 定数フィールド値は"\u3042\u3044\u3046\u3048\u304a"が出力される

回答No.1

himajin100000 · ベストアンサー

そういう実装の仕様。
#「文字化け」ではないような気がするけど。

http://java.sun.com/j2se/1.5.0/source_license.html
から、事前に登録したIDとパスワードを用いてJRLの方を辿り、(SCSLの方はリンク切れ)
Download (JRL Source) から、jdk-1_5_0-src-jrl.zipをダウンロード。
\j2se\src\share\classes\com\sun\tools\javadoc
\j2se\src\share\classes\com\sun\tools\doclets
あたりから追うことができる。

全部読むと疲れそうなので勘で当たりを付ける。
ConstantsSummaryWriterImpl.javaが
FieldDocインターフェースのconstantValueExpressions()を呼び出す。
FieldDocインターフェースを実装ているのは多分FieldDocImplで

そのコードは大体以下のようになっていて、
http://www.java2s.com/Open-Source/Java-Document/6.0-JDK-Modules-com.sun/tools/com/sun/tools/javadoc/FieldDocImpl.java.htm
118行目から119行目、125行目、132行目と流れて166行目、171行目、177行目と読んでいけば質問者さんなら「当たり前じゃん」って思うと思う。

#自分で改変してビルドするなりご自由に。makefileなんか読んでないけど、オフィシャルなバイナリはexeだからどっかで変換しているんだろう。そこまでやるかは任せる。

お礼

さっそくのご回答、ありがとうございます。

ご教示いただいたソースを観て、そういうツクリになっていることが解りました。

やはりマルチバイト出力したいので、javadoc改を作るか、htmlをコンバートするツールを作るかを考えないといけないようですね。
1.6.0以降でできるなら入れ換えるつもりでしたが、それも駄目だと判って助かりました。

ありがとうございました。