[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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


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

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



--- 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>
-<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
-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>
+代替ツールが (シンボリックリンクまたはラッパースクリプトとして) 用意されます。
+buildlink システムと同様に、
-<para>A tool may be needed to help build a specific package. For example,
-perl, GNU make (gmake) or yacc may be needed.</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>
+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>
+<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>
+<varname>USE_TOOLS</varname> 変数を使って
 <sect1 id="package-tools">
-<title>Tools needed by packages</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>
 USE_TOOLS+=     mktemp:pkgsrc
 USE_TOOLS+=     gmake perl:run pkg-config
-<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>
+<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 id="platform-tools">
-<title>Tools provided by platforms</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 の断片を見て (あるいは作って) ください。
 .if exists(/usr/bin/bzcat)