[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/build.xml: 1.16 -> 1.18
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/build.xml: 1.16 -> 1.18
> revision 1.28
> date: 2006/06/26 23:28:51; author: rillig; state: Exp; lines: +8 -4
> INSTALLATION_DIRS creates directories with the correct ownership.
> ----------------------------
> revision 1.27
> date: 2006/04/21 07:54:12; author: rillig; state: Exp; lines: +11 -8
> Specified the structure and interpretation of the WRAPPER_REORDER_CMDS
> variable.
火曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- build.xml.orig 2006-10-22 19:40:55.000000000 +0900
+++ build.xml 2006-10-22 19:40:55.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: build.xml,v 1.16 2005/11/03 19:29:54 rillig Exp $ -->
+<!-- $NetBSD: build.xml,v 1.18 2006/01/07 21:42:34 rillig Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: build.xml,v 1.16 2005/11/03 19:29:54 rillig Exp -->
+<!-- NetBSD: build.xml,v 1.18 2006/01/07 21:42:34 rillig Exp -->
<chapter id="build">
<title>構築の手順</title>
@@ -13,18 +13,16 @@
<varname>build</varname>, <varname>install</varname>) にわかれており、
そのすべてを以下の各節で説明します。それぞれの段階は、<varname>pre-</varname>,
<varname>do-</varname>, <varname>post-</varname>
-のいずれかが stage 名の前についた、いわゆる<emphasis>期 (stage)</emphasis>
+のいずれかが相名の前についた、いわゆる<emphasis>期 (stage)</emphasis>
にわかれます。(たとえば、
<varname>pre-configure</varname>, <varname>post-build</varname> などです。)
実際に何かがおこなわれるのは、ほとんどが <varname>do-*</varname> 期においてです。</para>
- <para>プログラムを構築するための基本的な手順は常に同じです。最初に、プログラムの
- ソースファイル(<emphasis>distfile</emphasis>)をローカルシステムへ持ってきて展開します。&os;
- 上でコンパイルするためのいくつかのパッチを適用した後に、ソフトウェアを設定
- し、構築(通常、コンパイルすることによって)します。最後に作成されたバイナリー
- 等を、システムにインストールします。これはまさに&os;パッケージシステム
- によって実行される手順です。この手順は、中心となるMakefile、
- <filename>pkgsrc/mk/bsd.pkg.mk</filename>の中で一連のターゲットとして実装されています</para>
+<para>プログラムを構築するための基本的な手順は常に同じです。最初に、プログラムの
+ソースファイル(<emphasis>distfile</emphasis>)をローカルシステムへ持ってきて展開します。
+コンパイルするための pkgsrc 独自のパッチを適用した後に、ソフトウェアを設定
+し、構築(通常、コンパイルすることによって)します。最後に作成されたバイナリー
+等を、システムにインストールします。</para>
</sect1>
@@ -152,34 +150,34 @@
<para>ディレクトリーを指す変数のなかには、相対パス名を値に持つものがあります。
このような相対パス名の基点となるディレクトリーは、おもに二つあります。
一つは <varname>PKGSRCDIR/PKGPATH</varname> で、pkgsrc 特有のディレクトリー用です。
-もう一つは <varname>WRKSRC</varname> で、パッケージそのものの内部にあるディレクトリー用です。
-以下、変数名の後のカッコ内に記した許可属性は、
-パッケージの Makefile でその変数を変更可能かどうかを表しています。</para>
+もう一つは <varname>WRKSRC</varname> で、パッケージそのものの内部にあるディレクトリー用です。</para>
<variablelist>
-<varlistentry><term><varname>PKGSRCDIR</varname> (読み出し専用)</term>
+<varlistentry><term><varname>PKGSRCDIR</varname></term>
<listitem><para>絶対パス名で、
pkgsrc のルートディレクトリーを指します。
通常は、この変数を使う必要はありません。</para></listitem></varlistentry>
-<varlistentry><term><varname>PKGPATH</varname> (読み出し専用)</term>
+<varlistentry><term><varname>PKGPATH</varname></term>
<listitem><para><varname>PKGSRCDIR</varname>
を基点とした相対パス名で、
当該パッケージを指します。</para></listitem></varlistentry>
-<varlistentry><term><varname>WRKDIR</varname> (読み出し専用)</term>
+<varlistentry><term><varname>WRKDIR</varname></term>
<listitem><para>絶対パス名で、全作業がおこなわれるディレクトリーを指します。
+distfile はこのディレクトリーに展開されます。
一般的に、このディレクトリーには、
<emphasis>buildlink</emphasis> や
<emphasis>wrappers</emphasis> など、
-pkgsrc の各種基盤が使う一時ディレクトリーが含まれます。</para></listitem></varlistentry>
+pkgsrc の各種基盤が使う一時ディレクトリーも含まれます。</para></listitem></varlistentry>
-<varlistentry><term><varname>WRKSRC</varname> (読み書き可能)</term>
+<varlistentry><term><varname>WRKSRC</varname></term>
<listitem><para>絶対パス名で、distfile が展開されるディレクトリーを指します。
普通は、<varname>WRKDIR</varname> 直下のサブディレクトリーであり、
多くの場合は、このディレクトリーにおける、
-唯一の隠されていないディレクトリーエントリーです。</para></listitem></varlistentry>
+唯一の隠されていないディレクトリーエントリーです。この変数は、パッケージの
+<filename>Makefile</filename> で変更することができます。</para></listitem></varlistentry>
</variablelist>
</sect1>
Index: build.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/build.xml,v
retrieving revision 1.16
retrieving revision 1.18
diff -u -r1.16 -r1.18
--- build.xml 3 Nov 2005 19:29:54 -0000 1.16
+++ build.xml 7 Jan 2006 21:42:34 -0000 1.18
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.16 2005/11/03 19:29:54 rillig Exp $ -->
+<!-- $NetBSD: build.xml,v 1.18 2006/01/07 21:42:34 rillig Exp $ -->
<chapter id="build">
<title>The build process</title>
@@ -12,19 +12,17 @@
<varname>build</varname>, <varname>install</varname>), all of which are
described in the following sections. Each phase is splitted into
so-called <emphasis>stages</emphasis>, which take the name of the
-containing stage, prefixed by one of <varname>pre-</varname>,
+containing phase, prefixed by one of <varname>pre-</varname>,
<varname>do-</varname> or <varname>post-</varname>. (Examples are
<varname>pre-configure</varname>, <varname>post-build</varname>.) Most
of the actual work is done in the <varname>do-*</varname> stages.</para>
- <para>The basic steps for building a program are always the same. First the
- program's source (<emphasis>distfile</emphasis>) must be brought to the
- local system and then extracted. After any patches to compile properly
- on &os; are applied, the software can be configured, then built
- (usually by compiling), and finally the generated binaries, etc. can be
- put into place on the system. These are exactly the steps performed by
- the &os; package system, which is implemented as a series of targets
- in a central Makefile, <filename>pkgsrc/mk/bsd.pkg.mk</filename>.</para>
+<para>The basic steps for building a program are always the same. First
+the program's source (<emphasis>distfile</emphasis>) must be brought to
+the local system and then extracted. After any pkgsrc-specific patches
+to compile properly are applied, the software can be configured, then
+built (usually by compiling), and finally the generated binaries, etc.
+can be put into place on the system.</para>
</sect1>
@@ -159,33 +157,33 @@
are two common base directories for these relative directories:
<varname>PKGSRCDIR/PKGPATH</varname> is used for directories that are
pkgsrc-specific. <varname>WRKSRC</varname> is used for directories
-inside the package itself. The permissions after each variable indicate
-whether the variable may be changed by the package Makefile.</para>
+inside the package itself.</para>
<variablelist>
-<varlistentry><term><varname>PKGSRCDIR</varname> (read-only)</term>
+<varlistentry><term><varname>PKGSRCDIR</varname></term>
<listitem><para>This is an absolute pathname that points to the pkgsrc
root directory. Generally, you don't need
it.</para></listitem></varlistentry>
-<varlistentry><term><varname>PKGPATH</varname> (read-only)</term>
+<varlistentry><term><varname>PKGPATH</varname></term>
<listitem><para>This is a pathname relative to
<varname>PKGSRCDIR</varname> that points to the current
package.</para></listitem></varlistentry>
-<varlistentry><term><varname>WRKDIR</varname> (read-only)</term>
+<varlistentry><term><varname>WRKDIR</varname></term>
<listitem><para>This is an absolute pathname pointing to the directory
-where all work takes place. This directory typically contains temporary
-directories used by the various pkgsrc frameworks, like
-<emphasis>buildlink</emphasis> or the
-<emphasis>wrappers</emphasis>.</para></listitem></varlistentry>
+where all work takes place. The distfiles are extraced to this
+directory. It also contains temporary directories and log files used by
+the various pkgsrc frameworks, like <emphasis>buildlink</emphasis> or
+the <emphasis>wrappers</emphasis>.</para></listitem></varlistentry>
-<varlistentry><term><varname>WRKSRC</varname> (read-write)</term>
+<varlistentry><term><varname>WRKSRC</varname></term>
<listitem><para>This is an absolute pathname pointing to the directory
where the distfiles are extracted. It is usually a direct subdirectory
of <varname>WRKDIR</varname>, and often it's the only directory entry
-that isn't hidden.</para></listitem></varlistentry>
+that isn't hidden. This variable may be changed by a package
+<filename>Makefile</filename>.</para></listitem></varlistentry>
</variablelist>
</sect1>