[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/build.xml: 1.20 -> 1.22
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/build.xml: 1.20 -> 1.22
> revision 1.22
> date: 2006/01/27 04:06:25; author: rillig; state: Exp; lines: +41 -11
> Added a description for INSTALLATION_DIRS. Reworded the text of the
> build.install section.
> ----------------------------
> revision 1.21
> date: 2006/01/13 17:55:27; author: reed; state: Exp; lines: +4 -2
> Cross reference the "tools phase" section to
> the new tools chapter.
>
> I removed the TODO here; maybe some text should still be added
> for this chapter?
金曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- build.xml.orig 2006-10-26 07:04:04.000000000 +0900
+++ build.xml 2006-10-26 07:04:04.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: build.xml,v 1.20 2006/01/12 21:46:33 wiz Exp $ -->
+<!-- $NetBSD: build.xml,v 1.22 2006/01/27 04:06:25 rillig Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: build.xml,v 1.20 2006/01/12 21:46:33 wiz Exp -->
+<!-- NetBSD: build.xml,v 1.22 2006/01/27 04:06:25 rillig Exp -->
<chapter id="build">
<title>構築の手順</title>
@@ -290,7 +290,9 @@
<sect1 id="build.tools">
<title><emphasis>tools</emphasis> 相</title>
-<para>[TODO]</para>
+<para>この相については
+<xref linkend="tools"/> で説明しています。
+</para>
</sect1>
@@ -383,10 +385,28 @@
<title><emphasis>install</emphasis> 相</title>
<para>構築の段階が完了すると、ユーザーが構築されたプログラムやファイルを使えるようにするため、ソフトウェアをパブリックなディレ
- クトリーにインストールする必要があります。buildターゲットと同様に、
- <varname>MAKE_PROGRAM</varname>が<varname>MAKEFILE</varname>中で起動されます。ただし、<varname>INSTALL_TARGET</varname>が指定
- されます。この変数のデフォルトは<quote>install</quote>です。(もし<varname>USE_IMAKE</varname>が設定さ
- れていれば、<quote>install.man</quote>も追加されます)。</para>
+ クトリーにインストールする必要があります。</para>
+
+ <para><emphasis>install</emphasis> 相は、大雑把にいえば、
+ 以下のコードを実行するのと同じことです。これに加えて、
+ このコードの前後では、整合性の検査やパッケージの登録などをするため、
+ 多くの操作がおこなわれます。</para>
+
+<programlisting>
+ .for d in ${INSTALL_DIRS}
+ cd ${WRKSRC} && cd ${d} && env ${MAKE_ENV} \
+ ${MAKE_PROGRAM} ${INSTALL_MAKE_FLAGS} \
+ -f ${MAKEFILE} ${BUILD_TARGET}
+ .endfor
+</programlisting>
+
+ <para>各変数の意味は、<emphasis>build</emphasis>
+ 相のものと同様です。
+ <varname>INSTALL_DIRS</varname> は標準では
+ <varname>BUILD_DIRS</varname> です。<varname>INSTALL_TARGET</varname>
+ は標準では <quote>install</quote> ですが、
+ <varname>USE_IMAKE</varname> が定義されている場合は <quote>install.man</quote>
+ が追加されます。</para>
<para><emphasis>install</emphasis> 相では、以下の変数が有用です。
これらはいずれも &man.install.1; コマンドの変種であり、
@@ -395,10 +415,6 @@
用途別に特化した変種には、以下のものがあります。</para>
<variablelist>
-<!-- template:
- <varlistentry><term><varname></varname></term>
- <listitem><para></para></listitem></varlistentry>
--->
<varlistentry><term><varname>INSTALL_PROGRAM_DIR</varname></term>
<listitem><para>バイナリーを含むディレクトリー</para></listitem></varlistentry>
<varlistentry><term><varname>INSTALL_SCRIPT_DIR</varname></term>
@@ -424,6 +440,24 @@
<varlistentry><term><varname>INSTALL_MAN</varname></term>
<listitem><para>マニュアルページ</para></listitem></varlistentry>
</variablelist>
+
+ <para>これらのほか、以下の変数があります。</para>
+
+ <variablelist>
+ <varlistentry><term><varname>INSTALLATION_DIRS</varname></term>
+ <listitem><para>pkgsrc が <emphasis>install</emphasis>
+ 相の最初に作成するディレクトリーを
+ <varname>PREFIX</varname> からの相対位置表記で並べたリストです。
+ この変数が設定されている場合、
+ <varname>NO_MTREE</varname>=<quote>yes</quote>
+ が仮定されます。
+ つまり、そのパッケージは、ファイルをインストールする前に、
+ 必要なディレクトリーをすべて自力で作成すると主張していることになります。
+ 従って、この変数は、パッケージ作者の制御下にある
+ <filename>Makefile</filename> においてのみ設定するものです。</para></listitem></varlistentry>
+ </variablelist>
+
+
</sect1>
<sect1 id="build.package">
Index: build.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/build.xml,v
retrieving revision 1.20
retrieving revision 1.22
diff -u -r1.20 -r1.22
--- build.xml 12 Jan 2006 21:46:33 -0000 1.20
+++ build.xml 27 Jan 2006 04:06:25 -0000 1.22
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.20 2006/01/12 21:46:33 wiz Exp $ -->
+<!-- $NetBSD: build.xml,v 1.22 2006/01/27 04:06:25 rillig Exp $ -->
<chapter id="build">
<title>The build process</title>
@@ -306,7 +306,9 @@
<sect1 id="build.tools">
<title>The <emphasis>tools</emphasis> phase</title>
-<para>[TODO]</para>
+<para>This is covered in
+<xref linkend="tools"/>.
+</para>
</sect1>
@@ -401,12 +403,28 @@
<para>Once the build stage has completed, the final step is to
install the software in public directories, so users can access
- the programs and files. As in the build-target,
- <varname>MAKE_PROGRAM</varname> is invoked on
- <varname>MAKEFILE</varname> here, but with the
- <varname>INSTALL_TARGET</varname> instead, the latter defaulting
- to <quote>install</quote> (plus <quote>install.man</quote>, if
- <varname>USE_IMAKE</varname> is set).</para>
+ the programs and files.</para>
+
+ <para>In the <emphasis>install</emphasis> phase, a rough
+ equivalent of the following code is executed. Additionally,
+ before and after this code, much magic is performed to do
+ consistency checks, registering the package, and so on.</para>
+
+<programlisting>
+ .for d in ${INSTALL_DIRS}
+ cd ${WRKSRC} && cd ${d} && env ${MAKE_ENV} \
+ ${MAKE_PROGRAM} ${INSTALL_MAKE_FLAGS} \
+ -f ${MAKEFILE} ${BUILD_TARGET}
+ .endfor
+</programlisting>
+
+ <para>The variable's meanings are analogous to the ones in the
+ <emphasis>build</emphasis> phase.
+ <varname>INSTALL_DIRS</varname> defaults to
+ <varname>BUILD_DIRS</varname>. <varname>INSTALL_TARGET</varname>
+ is <quote>install</quote> by default, plus
+ <quote>install.man</quote> if <varname>USE_IMAKE</varname> is
+ defined.</para>
<para>In the <emphasis>install</emphasis> phase, the following
variables are useful. They are all variations of the
@@ -416,10 +434,6 @@
intended use, are:</para>
<variablelist>
-<!-- template:
- <varlistentry><term><varname></varname></term>
- <listitem><para></para></listitem></varlistentry>
--->
<varlistentry><term><varname>INSTALL_PROGRAM_DIR</varname></term>
<listitem><para>directories that contain binaries</para></listitem></varlistentry>
<varlistentry><term><varname>INSTALL_SCRIPT_DIR</varname></term>
@@ -445,6 +459,24 @@
<varlistentry><term><varname>INSTALL_MAN</varname></term>
<listitem><para>man pages</para></listitem></varlistentry>
</variablelist>
+
+ <para>Some other variables are:</para>
+
+ <variablelist>
+ <varlistentry><term><varname>INSTALLATION_DIRS</varname></term>
+ <listitem><para>A list of directories relative to
+ <varname>PREFIX</varname> that are created by pkgsrc at
+ the beginning of the <emphasis>install</emphasis> phase. If
+ this variable is set,
+ <varname>NO_MTREE</varname>=<quote>yes</quote> is
+ assumed, which means that the package claims to create
+ all needed directories itself before installing files to
+ it. Therefore this variable should only be set in
+ <filename>Makefile</filename>s that are under control of
+ the package's author.</para></listitem></varlistentry>
+ </variablelist>
+
+
</sect1>
<sect1 id="build.package">