pkgsrc/doc/guide/files/tools.xml 1.4

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

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

pkgsrc/doc/guide/files/tools.xml 1.4

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

原文は
http://cvsweb.NetBSD.org/bsdweb.cgi/%7Echeckout%7E/pkgsrc/doc/guide/files/tools.xml?rev=1.4&content-type=text/plain
http://cvsweb.NetBSD.org/bsdweb.cgi/%7Echeckout%7E/htdocs/Documentation/pkgsrc/tools.html?rev=1.7&content-type=text/html
で、訳文は
http://www.na.rim.or.jp/%7Ekano/tmp/pkgsrc/doc/guide/files/tools.xml
http://www.na.rim.or.jp/%7Ekano/tmp/Documentation/pkgsrc/tools.html
に置いてあります。

以下は原文との差分です。

--- tools.xml.orig	2006-09-13 01:48:45.000000000 +0900
+++ tools.xml	2006-10-21 19:18:44.000000000 +0900
@@ -1,72 +1,75 @@
 <!-- $NetBSD: tools.xml,v 1.4 2006/09/10 19:32:55 wiz Exp $ -->
+<!-- Based on english version: -->
+<!-- NetBSD: tools.xml,v 1.4 2006/09/10 19:32:55 wiz Exp   -->
 
 <chapter id="tools">
-<title>Tools needed for building or running</title>
+<title>構築や実行のために必要なツール</title>
 
-<para>The <varname>USE_TOOLS</varname> definition is used both internally
-by pkgsrc and also for individual packages to define what commands
-are needed for building a package (like <varname>BUILD_DEPENDS</varname>)
-or for later run-time of an installed packaged (such as
-<varname>DEPENDS</varname>).
-If the native system provides an adequate tool, then in many cases, a pkgsrc
-package will not be used.</para>
+<para><varname>USE_TOOLS</varname> 定義は、
+パッケージを構築するためにどのコマンドが必要か (<varname>BUILD_DEPENDS</varname> のように)、
+あるいは、インストールしたパッケージを実行するためにどのコマンドが必要か (<varname>DEPENDS</varname>
+のように) を定義するために、
+pkgsrc 内部で使われており、また、個々のパッケージ用としても使われています。
+適当なツールがシステムに標準で附属していれば、多くの場合は
+pkgsrc のパッケージは使われません。</para>
 
-<para>When building a package, the replacement tools are
-made available in a directory (as symlinks or wrapper scripts)
-that is early in the executable search path. Just like the buildlink
-system, this helps with consistent builds.</para>
+<para>パッケージを構築するときは、実行検索パスの前のほうにあるディレクトリーに、
+代替ツールが (シンボリックリンクまたはラッパースクリプトとして) 用意されます。
+buildlink システムと同様に、
+こうすることで、首尾一貫した構築ができるようになります。</para>
 
-<para>A tool may be needed to help build a specific package. For example,
-perl, GNU make (gmake) or yacc may be needed.</para>
+<para>あるツールは、パッケージの構築を補助するために必要となることがあります。
+たとえば、perl, GNU make (gmake), yacc はこのために必要になることがあります。</para>
 
-<para>Also a tool may be needed, for example, because the native system's supplied
-tool may be inefficient for building a package with pkgsrc.
-For example, a package may need GNU awk, bison (instead of
-yacc) or a better sed.</para>
+<para>また、あるツールは、たとえば、システム標準附属のツールでは
+pkgsrc によるパッケージの構築用としては使い物にならないために、
+必要となることがあります。
+たとえば、パッケージが GNU awk, (yacc ではなく) bison や、
+より優れた sed を必要とすることがあります。</para>
 
-<para>The tools used by a package can be listed by running
-<command>make show-tools</command>.</para>
+<para>パッケージが使うツールの実体は、
+<command>make show-tools</command> を実行すると一覧表示されます。</para>
 
 <sect1 id="pkgsrc-tools">
-<title>Tools for pkgsrc builds</title>
+<title>pkgsrc 構築用のツール</title>
 
-<para>The default set of tools used by pkgsrc is defined in
-<filename>bsd.pkg.mk</filename>. This includes standard Unix tools,
-such as: <command>cat</command>, <command>awk</command>,
-<command>chmod</command>, <command>test</command>, and so on.
-These can be seen by running:
-<command>make show-var VARNAME=USE_TOOLS</command>.</para>
+<para>pkgsrc が標準状態で使うツール一式は、
+<filename>bsd.pkg.mk</filename> で定義されています。ここには、
+<command>cat</command>, <command>awk</command>,
+<command>chmod</command>, <command>test</command>
+などのような標準的な Unix のツールが含まれています。
+これらは 
+<command>make show-var VARNAME=USE_TOOLS</command> を実行すると見ることができます。</para>
 
-<para>If a package needs a specific program to build
-then the <varname>USE_TOOLS</varname> variable can be used
-to define the tools needed.</para>
+<para>個々のパッケージの構築のためにあるプログラムが必要な場合は、
+<varname>USE_TOOLS</varname> 変数を使って
+必要なツールを定義することができます。</para>
 
 </sect1>
 
 <sect1 id="package-tools">
-<title>Tools needed by packages</title>
+<title>パッケージが必要とするツール</title>
 
-<para>In the following examples, the :pkgsrc means to use the pkgsrc version
-and not the native version for a build dependency.
-And the :run means that it is used for a
-run-time dependencies also (and becomes a DEPENDS).
-The default is a build dependency which can be set with
-:build. (So in this example, it is the same as gmake:build
-and pkg-config:build.)</para>
+<para>以下の例では、:pkgsrc は、構築時依存性として、
+ネイティブのバージョンではなく pkgsrc のバージョンを使うことを意味します。
+また、:run は、実行時依存性としても使うことを意味します (ので、DEPENDS になります)。
+このようなものを付けない場合は、構築時依存性を意味します。これは
+:build を明示的に使って設定することもできます。 (このため、以下の例のものは、それぞれ gmake:build
+および pkg-config:build と同じことです。)</para>
 
 <programlisting>
 USE_TOOLS+=     mktemp:pkgsrc
 USE_TOOLS+=     gmake perl:run pkg-config
 </programlisting>
 
-<para>When using the tools framework, a
-<varname>TOOLS_PATH.foo</varname> variable is defined
-which contains the full path to the appropriate tool. For example,
-<varname>TOOLS_PATH.bash</varname> could be <quote>/bin/bash</quote>
-on Linux systems.</para>
+<para>このツールの枠組を使う時には、
+<varname>TOOLS_PATH.foo</varname> 変数が、
+適切なツールへのフルパスとして定義されます。
+たとえば、<varname>TOOLS_PATH.bash</varname> は Linux システム上では
+<quote>/bin/bash</quote> になったりするでしょう。</para>
 
-<para>If you always need a pkgsrc version of the
-tool at run-time, then just use <varname>DEPENDS</varname> instead.
+<para>実行時に常に pkgsrc バージョンのツールが必要となる場合は、
+この枠組ではなく、単に <varname>DEPENDS</varname> を使ってください。
 <!-- jlam said: This is not to
 say that we can't extend the tools framework to do that, but it hasn't been
 something that's come up frequently enough to make it worthwhile to do.
@@ -74,12 +77,12 @@
 
 </sect1>
 <sect1 id="platform-tools">
-<title>Tools provided by platforms</title>
+<title>プラットフォーム附属のツール</title>
 
-<para>When improving or porting pkgsrc to a new platform, have a look
-at (or create) the corresponding platform specific make file fragment under
-<filename>pkgsrc/mk/tools/tools.${OPSYS}.mk</filename> which defines
-the name of the common tools. For example:</para>
+<para>pkgsrc の改良、あるいは新プラットフォームへの移植をする時には、
+<filename>pkgsrc/mk/tools/tools.${OPSYS}.mk</filename> 以下にある、
+対象プラットフォーム用の make file の断片を見て (あるいは作って) ください。
+このファイルでは、たとえば以下のように、共通的に使うツールの名前を定義しています。</para>
 
 <programlisting>
 .if exists(/usr/bin/bzcat)