Documentation/pkgsrc/features/chapter.xml: 1.12 -> 1.13

[kano@na.rim.or.jp (OKANO Takayoshi)]

以下のページの更新をしました。ツッコミをお願いします。

Documentation/pkgsrc/features/chapter.xml: 1.12 -> 1.13

金曜日までに異議がなければ、 commit します。

> revision 1.13
> date: 2003/06/23 07:05:50;  author: grant;  state: Exp;  lines: +47 -68
> sync with packages.txt after introduction of USE_NEW_TEXINFO.

info に関する節は完全に書きかわっているので、
この部分の原文と訳の差分をつけます。

訳と原文それぞれの、新旧の差分の全文は
http://www.na.rim.or.jp/%7Ekano/tmp/Documentation/pkgsrc/features/diff-ja.txt
http://www.na.rim.or.jp/%7Ekano/tmp/Documentation/pkgsrc/features/diff-en.txt
です。

 <para>
-Some packages install info files or use the <quote>makeinfo</quote>
-or <quote>install-info</quote> commands. Each info file:
+パッケージによっては、infoファイルをインストールしたり、<quote>makeinfo</quote>または
+<quote>install-info</quote>コマンドを使ったりします。各 info ファイルは、
 <itemizedlist>
-<listitem>is considered to be installed in the directory
-          <filename>${PREFIX}/${INFO_DIR}</filename>,</listitem>
-<listitem>is registered in the Info directory file
-          <filename>${PREFIX}/${INFO_DIR}/dir</filename>,</listitem>
-<listitem>and must be listed as a filename in the
-          <varname>INFO_FILES</varname> variable in the package
-          Makefile.</listitem>
+<listitem><filename>${PREFIX}/${INFO_DIR}</filename>
+          ディレクトリーにインストールされるものとして扱われます。</listitem>
+<listitem>Info ディレクトリーファイル
+          <filename>${PREFIX}/${INFO_DIR}/dir</filename> に登録されます。</listitem>
+<listitem>パッケージの Makefile で、
+          <varname>INFO_FILES</varname> 変数に、
+          ファイル名の形で列挙する必要があります。</listitem>
 </itemizedlist>
 </para>
 
 <para>
-<varname>INFO_DIR</varname> defaults to <quote>info</quote> and can be
-overridden in the package Makefile. <filename>INSTALL</filename> and
-<filename>DEINSTALL</filename> scripts will be generated for handling
-registration of the info files in the Info directory file. The command
-<quote>install-info</quote> used for the info files registration is
-either provided by the system, or by a special purpose package
-automatically added as dependency if needed.
+<varname>INFO_DIR</varname> のデフォルトは <quote>info</quote> ですが、
+パッケージの Makefile で上書きすることができます。 info ファイルを
+Info ディレクトリーファイルに登録するために、<filename>INSTALL</filename> および
+<filename>DEINSTALL</filename> スクリプトが作られます。
+info ファイルの登録用の <quote>install-info</quote> コマンドは、
+システム附属のものが使われるか、
+または、必要があればそれ用のパッケージが自動的に追加されて使われます。
 </para>
 
 <para>
-A package which need the <quote>makeinfo</quote> command at build
-time must define the variable <varname>USE_MAKEINFO</varname> in its
-Makefile. If a minimum version of the <quote>makeinfo</quote> command
-is needed it should be noted with the <varname>TEXINFO_REQD</varname>
-variable in the package Makefile. By default, a minimum version of 3.12
-is required. If the system does not provide a <quote>makeinfo</quote>
-command or if it does not match the required minimum, a build dependency
-on the <pkg>devel/gtexinfo</pkg> package is added automatically.
+構築時に <quote>makeinfo</quote> コマンドが必要なパッケージは、
+Makefile で <varname>USE_MAKEINFO</varname> 変数を定義する必要があります。
+あるバージョン以上の<quote>makeinfo</quote>コマンドが必要な場合は、
+パッケージの Makefile で <varname>TEXINFO_REQD</varname> 変数を必要な最低バージョンに設定します。
+デフォルトでは、 3.12 が最低限必要なバージョンとなります。
+<quote>makeinfo</quote> コマンドがシステムにないか、
+最低限必要なバージョンを満たさない場合は、<pkg>devel/gtexinfo</pkg>
+パッケージへの構築時の依存関係が自動的に追加されます。
 </para>
 
 <para>
-The installation process of the software provided by the package must not
-use <quote>install-info</quote>, as the registration of info files
-is the task of the package INSTALL sript, and it must use
-the right <quote>makeinfo</quote>.
+パッケージで提供されるソフトウェアのインストール過程では、
+<quote>install-info</quote> を使ってはいけません。
+info ファイルの登録は INSTALL スクリプトの仕事であって、
+<quote>makeinfo</quote> を適切に使う必要があるからです。
 </para>
 
 <para>
-If the package use buildlink2 framework no special action should be needed
-to achieve this goal.
+パッケージが buildlink2 の枠組を使っている場合は、
+以上の方針を満たすために特別な操作を追加する必要はないはずです。
 </para>
 
 <para>
-If the package does not use the buildlink2 framework patch files are likely
-to be needed so the build and installation process of the software
-picks up the <emphasis>possibly dummy</emphasis> values of
-<varname>INSTALL_INFO</varname> and <varname>MAKEINFO</varname>
-variables.
+パッケージが buildlink2 の枠組を使っていない場合は、
+ソフトウェアの構築およびインストールの過程で
+<varname>INSTALL_INFO</varname> および <varname>MAKEINFO</varname>
+変数値 (<emphasis>ダミーの場合もあります</emphasis>) を拾うようにするための
+パッチファイルがおそらく必要になるでしょう。
 </para>
 
 <note>
-Temporarily, the variable <varname>USE_NEW_TEXINFO</varname> must be
-defined in the package Makefile. Previously, info files,
-<quote>install-info</quote> and <quote>makeinfo</quote>
-were handled somewhat differently and the two ways will coexist for
-a short period of time until all older packages are updated.
+現在、一時的な措置として、パッケージの Makefile で <varname>USE_NEW_TEXINFO</varname>
+を定義する必要があります。以前は、info ファイル、
+<quote>install-info</quote> および <quote>makeinfo</quote>
+は現在とは異なる方法で扱われており、古い方法を使ったパッケージがすべて更新されるまでの間は、
+新旧の 2 方式が共存することになります。
 </note>