Configure.help 日本語訳ファイル作業キット

1. このアーカイブの中に含まれているもの
---------------------------------------

  - conf22, JF 作成の 2.4.x の翻訳ファイル

      TRANS-Configure.help-2.4.*/   ディレクトリに項目ごとに
                                    分割して収めてあります

  - Original の Configure.help-2.4.0 と、そこから各バージョン
    へのパッチ

  - 上記ファイル群から暫定翻訳版を機械的に生成するスクリプト群


2. 使い方 その1
----------------

  単純に make すると Configure.help-$(VERSION).ja.gz が生成されます。

3. 使い方 その2
----------------

  翻訳作業の補助にも使うことができます。(本来はこちらがメインの用途)

* 3-1. 基本編

  翻訳版ファイルを生成する merge_trans.pl は新しいバージョンの
ディレクトリに翻訳を見つけると、そのファイルは新しいバージョン
に対応したものであると見なします。
したがって、最新版に追従するべく翻訳作業を進める場合、

     TRANS-Configure.help-$(VERSION)/CONFIG_*

というファイル名で追加していけばよいことになります。

  
* 3-2.  ステータスを見る

  どの翻訳が必要なのか知りたい場合は、make status を実行します。
結果は標準出力に表示されます。make すると Configure-Status*.html
というファイルが作成されますが、これは同じ情報をより詳細にした
HTML 版です。この表の見方は同じく make で生成される guidance.html
ファイルに記述されています。

* 3-3.  予約

  make status の表示結果で、人名か (nobody) という文字列が付加さ
れている場合は、その項目の翻訳予約状況を示しています。

  予約は Reserved.list というファイルに記入します。予約したい
項目の最後に、名前を記入してください。

* 3-4.  翻訳を更新する場合のヒント

  まず、バージョン間の差異を目視で確認する必要があります。

  前のバージョンの翻訳が存在していて、内容の更新に追従するには:

   [方法1] 素直に diff を使う
    % diff -u CONFIG-Configure.help-2.4.0/CONFIG_FXIMA \
              CONFIG-Configure.help-2.4.2/CONFIG_FXIMA

   [方法2] 素直に GNU wdiff を使う (こちらの方がわかりやすい):

    % wdiff CONFIG-Configure.help-2.4.0/CONFIG_FXIMA \
            CONFIG-Configure.help-2.4.2/CONFIG_FXIMA

   [方法2] 不精な人は、このアーカイブに付属する chdiff.pl を使う
           (この方法では確認の必要なバージョンを自動的に探し出して
	    wdiff (なければ diff) で表示します)

    % ./chdiff.pl CONFIG_FXIMA      (wdiff を使って表示)
    % ./chdiff.pl -d CONFIG_FXIMA   (diff を使って表示)

いずれにしても各項目毎に目視で差異を確認し、
TRANS-Configure.help-2.4.0/CONFIG_FXIMA ファイルに手を加え、
その結果を TRANS-Configure.help-2.4.2/CONFIG_FXIMA に保存します。
その後、make clean && make すると、新しい内容が翻訳暫定版に反映され
ます。

  新規に追加された項目の場合は、単純に原文を翻訳して、対応する翻訳
のディレクトリに追加するだけです。

* 3-5.  リンク指示ファイル (USE 文)

  もし、複数のバージョンの翻訳ディレクトリに同じ翻訳ファイルを入れる
必要があるときは、一つにだけ翻訳ファイルを入れ、残りはリンク指示ファ
イルにできます。リンク指示ファイルは、行頭からスペースを明けずに、
"USE $(VERSION)" と記します。例えば以下のような指示:

USE 2.4.0

を TRANS-Configure.help-2.4.2/CONFIG_FXIMA に書いた場合、2.4.0 の
翻訳ファイルの内容が 2.4.2 のディレクトリにあるのと同じように扱わ
れます。これによって、もしリポジトリの翻訳を更新する必要に迫られた
場合でも、ひとつのファイルを更新するだけなので、作業が簡単になります。

4. Configure.help 翻訳作業手順
------------------------------

  最新の情報は以下の一次情報源を参照してください。
  http://www.linux.or.jp/JF/workshop/guidance-procedure.html#CH-trans

    1. Configure.help 翻訳作業の進行状況表を見て、翻訳する項目を選ぶ。

     * 翻訳作業の進行状況表を見る
        -> http://www.linux.or.jp/JF/JFdocs/Configure.help/ からたどる.
       ちょっとややこしいですが、予約する前に、その項目のどのバージョン
       の翻訳が必要とされているのか、確認してください。そのための解説が
       以下の文書です。この翻訳進行状況表の見方の解説は:
        -> http://www.linux.or.jp/JF/JFdocs/Configure.help/guidance.html
       にあります。

     * 自分の手元で確認する
       後述する "Configure.help 翻訳作業キット" の最新のものを入手すると、
       どの項目が未作業になっているのか、手元で確認できます。
        -> % make db (最初の一回だけ必要)
           % make status

    2. JF-MLで翻訳作業の予約をする。
       予約メールを流す際には、

         Subject: [CH:RESERVE] CONFIG_XXXXXXX

       という風に、一目でわかるようにしてください。 この予約は
       Configure.help 翻訳作業の進行状況にも反映されます。

    3. 原文、暫定翻訳文など作業に必要なファイルを入手する。
       これにはいくつかの方法があります。

          + CVS リポジトリから入手する. (一番お勧めです)

          + "Configure.help 翻訳作業キット" を手にいれる. (必要なファ
            イルが全てセットになっているので、手っとりばやいです)
             -> http://www.linux.or.jp/JF/JFdocs/Configure.help/kit/CH-kit-2.4.tar.gz

            この場合はアーカイブを展開したディレクトリにある README も読ん
            でください。

          + 原文はカーネルソースから、暫定翻訳文は JF の Configure.help
            のページから入手する. (ちょっと面倒です)

    4. ひたすら翻訳.

    5. JF-ML にドラフトを流す。
       ドラフトを流す際には、

         Subject: [CH:DRAFT] CONFIG_XXXXXXX 2.4.2

       という風に、翻訳元のバージョンまで一目でわかるようにしてください。
       ** ただし、Configure.help 翻訳作業に関しては、このドラフト段階は
       スキップすることが 認められています。 いきなり次の決定稿を流す段
       階に進んでもかまいません。

    6. JF-ML に決定稿を流す。
       決定稿(リリース版)を流す際には、

         Subject: [CH:FINAL] CONFIG_XXXXXXX 2.4.2

       という風に、翻訳元のバージョンまで一目でわかるようにしてください。

    7. Committer が CVS リポジトリに登録

   これで作業は終りです。

$Id: README,v 1.3 2003/01/29 21:02:24 mdk Exp $
