[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/build.xml: 1.42 -> 1.44
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/build.xml: 1.42 -> 1.44
> revision 1.44
> date: 2007/03/03 13:27:03; author: kano; state: Exp; lines: +2 -2
> NO_BUILD is for build phase, not for configure phase
> ----------------------------
> revision 1.43
> date: 2007/03/02 09:38:21; author: wiz; state: Exp; lines: +38 -2
> Document PKG_VERBOSE, PATCH_DEBUG, that one should not
> override foo but do-foo, mirror-distfiles, SCRIPTS_ENV, NO_CONFIGURE,
> NO_BUILD, NO_INSTALL, and NO_PACKAGE.
月曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- build.xml.orig 2007-03-03 22:40:47.000000000 +0900
+++ build.xml 2007-03-03 22:40:47.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: build.xml,v 1.42 2006/12/15 13:22:14 martti Exp $ -->
+<!-- $NetBSD: build.xml,v 1.44 2007/03/03 13:27:03 kano Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: build.xml,v 1.42 2006/12/15 13:22:14 martti Exp -->
+<!-- NetBSD: build.xml,v 1.44 2007/03/03 13:27:03 kano Exp -->
<chapter id="build">
<title>構築の手順</title>
@@ -18,12 +18,20 @@
<varname>pre-configure</varname>, <varname>post-build</varname> などです。)
実際に何かがおこなわれるのは、ほとんどが <varname>do-*</varname> 期においてです。</para>
+ <para>標準的なターゲット (<varname>fetch</varname>
+ など) は、決して上書きしないでください。変更する必要がある場合は、
+ 対応する <varname>do-*</varname> ターゲットを上書きしてください。</para>
+
<para>プログラムを構築するための基本的な手順は常に同じです。最初に、プログラムの
ソースファイル(<emphasis>distfile</emphasis>)をローカルシステムへ持ってきて展開します。
コンパイルするための pkgsrc 独自のパッチを適用した後に、ソフトウェアを設定
し、構築(通常、コンパイルすることによって)します。最後に作成されたバイナリー
等を、システムにインストールします。</para>
+ <para>それぞれの段階で何が起きているかを、もっと詳しく把握するために、
+ <varname>PKG_VERBOSE</varname> 変数を設定することができます。
+ または、<emphasis>patch</emphasis> の段階における詳細に関心があるだけなら、
+ <varname>PATCH_DEBUG</varname> 変数を設定することもできます。</para>
</sect1>
<sect1 id="build.prefix">
@@ -163,6 +171,10 @@
pkgsrc のルートディレクトリーを指します。
通常は、この変数を使う必要はありません。</para></listitem></varlistentry>
+ <varlistentry><term><varname>PKGDIR</varname></term>
+ <listitem><para>当該パッケージを指す
+ 絶対パス名です。</para></listitem></varlistentry>
+
<varlistentry><term><varname>PKGPATH</varname></term>
<listitem><para><varname>PKGSRCDIR</varname>
を基点とした相対パス名で、
@@ -334,6 +346,13 @@
<varname>MASTER_SORT_AWK</varname>か
<varname>MASTER_SORT_REGEX</varname>を設定して、ユーザー
が入れ換えることができます。</para>
+
+ <para>the NetBSD Foundation が運営している distfile
+ のミラーサイトでは、自由に配布可能な distfile
+ をミラーするために <emphasis>mirror-distfiles</emphasis>
+ ターゲットを使っています。<varname>NO_SRC_ON_FTP</varname>
+ を (たいていは <quote>${RESTRICTED}</quote> に)
+ 設定しているバッケージの distfile はミラーされません。</para>
</sect2>
</sect1>
@@ -515,8 +534,12 @@
<para>もし、プログラムがコンフィギュレーションのために <filename>Imakefile</filename> を使用するので
あれば、<varname>USE_IMAKE</varname> を <quote>yes</quote> に設定することにより、適切な手順が実行されます。
(もし、<varname>${X11PREFIX}</varname> にインストールされるパッケージが欲しいだけで、xmkmfを実
- 行したくない場合、かわりに<varname>USE_X11BASE</varname>を使用してください。)</para>
+ 行したくない場合、かわりに<varname>USE_X11BASE</varname>を使用してください。)
+ <varname>SCRIPTS_ENV</varname> に変数を設定すると、
+ その変数を xmkmf の環境変数に追加することができます。</para>
+ <para>configure の段階ですることが何もない場合は、
+ <varname>NO_CONFIGURE</varname> を <quote>yes</quote> に設定します。</para>
</sect1>
<sect1 id="build.build">
@@ -552,6 +575,8 @@
<varname>MAKE_FILE</varname> の標準の値は <quote>Makefile</quote> であり、
<varname>BUILD_TARGET</varname> の標準の値は <quote>all</quote> です。</para>
+ <para>build の段階ですることが何もない場合は、
+ <varname>NO_BUILD</varname> を <quote>yes</quote> に設定します。</para>
</sect1>
<sect1 id="build.test">
@@ -653,6 +678,11 @@
適切な所有者・所有グループのもとに作成されます。</para></listitem></varlistentry>
</variablelist>
+
+ <para>稀な場合として、パッケージが何もインストールしないような場合は、
+ <varname>NO_INSTALL</varname> を <quote>yes</quote> に設定します。
+ これはほとんどの場合、<filename>regress</filename>
+ カテゴリーのパッケージに関するものです。</para>
</sect1>
<sect1 id="build.package">
@@ -671,6 +701,12 @@
<filename>${PACKAGES}/<replaceable>category</replaceable></filename>
にシンボリックリンクが作られます。<varname>PACKAGES</varname>
は標準では <filename>pkgsrc/packages</filename> になります。</para>
+
+ <para>バイナリーパッケージを作るべきでない場合は、
+ <varname>NO_PACKAGE</varname> を <quote>yes</quote> に設定します。
+ これは、構築したマシン上でしかパッケージが有用でないなど、
+ 稀な状況下でのみおこなうものですが、たとえそのような場合でも、
+ バイナリーパッケージが有用ということはありえます。</para>
</sect1>
<sect1 id="build.clean">
Index: build.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/build.xml,v
retrieving revision 1.42
retrieving revision 1.44
diff -u -r1.42 -r1.44
--- build.xml 15 Dec 2006 13:22:14 -0000 1.42
+++ build.xml 3 Mar 2007 13:27:03 -0000 1.44
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.42 2006/12/15 13:22:14 martti Exp $ -->
+<!-- $NetBSD: build.xml,v 1.44 2007/03/03 13:27:03 kano Exp $ -->
<chapter id="build">
<title>The build process</title>
@@ -17,6 +17,10 @@
<varname>pre-configure</varname>, <varname>post-build</varname>.) Most
of the actual work is done in the <varname>do-*</varname> stages.</para>
+ <para>Never override the regular targets (like
+ <varname>fetch</varname>), if you have to, override the
+ <varname>do-*</varname> ones instead.</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
@@ -24,6 +28,10 @@
built (usually by compiling), and finally the generated binaries, etc.
can be put into place on the system.</para>
+ <para>To get more details about what is happening at each step,
+ you can set the <varname>PKG_VERBOSE</varname> variable, or the
+ <varname>PATCH_DEBUG</varname> variable if you are just interested
+ in more details about the <emphasis>patch</emphasis> step.</para>
</sect1>
<sect1 id="build.prefix">
@@ -178,6 +186,10 @@
root directory. Generally, you don't need
it.</para></listitem></varlistentry>
+ <varlistentry><term><varname>PKGDIR</varname></term>
+ <listitem><para>This is an absolute pathname that points to the
+ current package.</para></listitem></varlistentry>
+
<varlistentry><term><varname>PKGPATH</varname></term>
<listitem><para>This is a pathname relative to
<varname>PKGSRCDIR</varname> that points to the current
@@ -360,6 +372,13 @@
<varname>MASTER_SORT_RANDOM</varname>, and
<varname>MASTER_SORT_AWK</varname> or
<varname>MASTER_SORT_REGEX</varname>.</para>
+
+ <para>The distfiles mirror run by the NetBSD Foundation uses the
+ <emphasis>mirror-distfiles</emphasis> target to mirror the
+ distfiles, if they are freely distributable. Packages setting
+ <varname>NO_SRC_ON_FTP</varname> (usually to
+ <quote>${RESTRICTED}</quote>) will not have their distfiles
+ mirrored.</para>
</sect2>
</sect1>
@@ -558,8 +577,12 @@
setting <varname>USE_IMAKE</varname> to
<quote>yes</quote>. (If you only want the package installed in
<varname>${X11PREFIX}</varname> but xmkmf not being run, set
- <varname>USE_X11BASE</varname> instead.)</para>
+ <varname>USE_X11BASE</varname> instead.) You can add variables to
+ xmkmf's environment by adding them to the
+ <varname>SCRIPTS_ENV</varname> variable.</para>
+ <para>If there is no configure step at all, set
+ <varname>NO_CONFIGURE</varname> to <quote>yes</quote>.</para>
</sect1>
<sect1 id="build.build">
@@ -595,6 +618,8 @@
<quote>Makefile</quote>, and <varname>BUILD_TARGET</varname>
defaults to <quote>all</quote>.</para>
+ <para>If there is no build step at all, set
+ <varname>NO_BUILD</varname> to <quote>yes</quote>.</para>
</sect1>
<sect1 id="build.test">
@@ -707,6 +732,11 @@
name.</para></listitem></varlistentry>
</variablelist>
+
+ <para>In the rare cases that a package shouldn't install anything,
+ set <varname>NO_INSTALL</varname> to <quote>yes</quote>. This is
+ mostly relevant for packages in the <filename>regress</filename>
+ category.</para>
</sect1>
<sect1 id="build.package">
@@ -724,6 +754,12 @@
one for each category in the <varname>CATEGORIES</varname>
variable. <varname>PACKAGES</varname> defaults to
<filename>pkgsrc/packages</filename>.</para>
+
+ <para>If there should be no binary package, set
+ <varname>NO_PACKAGE</varname> to <quote>yes</quote>.
+ This should only be used in rare cases, like when a package
+ definitely is only usable on the machine where it is built and even
+ then, a binary package can be useful.</para>
</sect1>
<sect1 id="build.clean">