Develop and Download Open Source Software

category（Tag） tree

• root

======================================================================
名前: MergeDoc
種類: Java アプリケーション
動作環境: JRE 1.4 以上
ライセンス: CPL v1.0
======================================================================

Eclipse の JDT は日本語化しても Java 標準 API のメソッドなどにマウスを
合わせたときにホバー表示される説明は日本語化されません。これは Eclipse
が JDK 付属の Java ソースから Javadoc コメントを取得し表示しているため
です。MergeDoc は日本語のホバー表示を可能にするために Java ソースと
日本語 Javadoc API ドキュメントをマージするためのツールです。


動作確認済みの実行環境と Java ソースのバージョン

  一応動作が確認できている環境は下記のとおりです。私が確認したものと、
  使っていただいている方の情報をもとにしています。

    OS         JRE       Javaソース  Javadoc
    -----------------------------------------------------------
    Win2K(SP3) 1.4.2_01  1.2.2_008   jdk1_2update-doc-ja
    Win2K(SP3) 1.4.2_01  1.3.1_03    j2sdk-1_3_0-update1-doc-ja
    Win2K(SP4) 1.4.2     1.4.1_04    j2sdk-1.4.0-doc-ja
    Win2K(SP3) 1.4.2_01  1.4.2_01    j2sdk-1.4.0-doc-ja
    WinXP(SP1) 1.4.2_01  1.4.2_01    j2sdk-1.4.0-doc-ja

  Servlet/JSP API は日本語化した Java ソース（Tomcat）が Ja-Jakarta
  で配布されているので MergeDoc は不要です。このファイルを Eclipse の
  該当 Jar に添付することで日本語表示されます。Eclipse のテキスト・フ
  ァイル・エンコードが EUC でない場合は事前に文字コード変換が必要です。


インストール

  mergedoc.zip を適当な場所に解凍してください。


アンインストール

  ディレクトリごと削除してください。


起動方法

  Windows で JAR ファイルに JRE/JDK 1.4 以上の javaw などが関連付いて
  いる場合は mergedoc.jar をダブルクリックすることで起動できます。
  それ以外の場合は以下のようなコマンドで起動してください。

    java -jar mergedoc.jar

  mergedoc.bat は Windows 用のサンプル起動ファイルです。必要に応じて
  エディタなどで JAVA_HOME を編集してください。


  起動オプション

    -Dtarget.directory=ディレクトリ名

    ターゲットディレクトリに入力ソースアーカイブファイルがある有効なデ
    ィレクトリを指定することで設定画面にデフォルトのファイル名が初期値
    としてセットされます。

    例）java -jar -Dtarget.directory=C:\j2sdk1.3 mergedoc.jar


操作方法

  1. 起動後の設定画面で設定を行い実行ボタンを押下。

       各項目の説明

       - Javadoc API 参照ディレクトリ

           日本語 Javadoc 標準 API 仕様を格納しているディレクトリを指定。
           例）C:\j2sdk1.3\docs\ja\api

       - 入力ソースアーカイブファイル

           Java 標準 API ソースアーカイブファイルを指定。
           例）C:\j2sdk1.3\src.jar

       - 出力ソースアーカイブファイル

           ソースを出力する新しいアーカイブファイルを指定。
           例）C:\j2sdk1.3\srcja.zip

       - 出力エンコーディング

           出力時の文字エンコーディングを指定。
           デフォルトを指定した場合はデフォルトエンコーディングが使用さ
           れます。Eclipse のテキスト・ファイル・エンコードに合わせてく
           ださい。

  2. Eclipse のパッケージエクスプローラから JRE システム・ライブラリー
     内の rt.jar を右クリックしてプロパティを開き Java ソースの添付でロ
     ケーションパスに MergeDoc で作成したソースアーカイブファイルを指定。