pkgsrc/doc/guide/files/binary.xml: 1.17 -> 1.18

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

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

pkgsrc/doc/guide/files/binary.xml: 1.17 -> 1.18

> revision 1.18
> date: 2005/12/04 17:05:22;  author: rillig;  state: Exp;  lines: +24 -1
> Added documentation for the make(1) variables that are most likely to be
> overridden in a user's mk.conf file.

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

以下、訳と原文それぞれの新旧の差分です。

--- binary.xml.orig	2006-10-20 00:47:24.000000000 +0900
+++ binary.xml	2006-10-20 00:47:24.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: binary.xml,v 1.17 2005/11/29 09:58:27 rillig Exp $ -->
+<!-- $NetBSD: binary.xml,v 1.18 2005/12/04 17:05:22 rillig Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: binary.xml,v 1.17 2005/11/29 09:58:27 rillig Exp   -->
+<!-- NetBSD: binary.xml,v 1.18 2005/12/04 17:05:22 rillig Exp   -->
 
 <chapter id="binary">
   <title>バイナリーパッケージを作る</title>
@@ -98,6 +98,29 @@
     PKG_DEVELOPER?= yes
     _ACCEPTABLE=    yes
 </programlisting>
+
+	<para>バルクビルド用として、特に有用なオプションが、
+	<filename>mk/bulk/bsd.bulk-pkg.mk</filename>
+	の冒頭にいくつかあります。そのなかでも最も有用な部類のものを、
+	ここで簡単に説明します。</para>
+
+	<itemizedlist>
+
+	<listitem><para>遅いマシンを使っている場合は、
+	<varname>USE_BULK_BROKEN_CHECK</varname> を
+	<quote>no</quote> に設定するとよいでしょう。</para></listitem>
+
+	<listitem><para>読み出し専用の pkgsrc ツリーを使ってバルクビルドをする場合は、
+	ログファイルが作られるディレクトリーとして <varname>BULKFILESDIR</varname>
+	を設定する必要があります。そうしないと、
+	pkgsrc ディレクトリー内にログファイルが作られます。</para></listitem>
+
+	<listitem><para>このほか、重要な変数として
+	<varname>BULK_PREREQ</varname> があります。
+	これは、他のパッケージを構築する際には常に使える状態になっているべきパッケージを
+	並べたリストです。</para></listitem>
+
+	</itemizedlist>
       </sect3>
 
       <sect3 id="pre-build.local">
Index: binary.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/binary.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- binary.xml	29 Nov 2005 09:58:27 -0000	1.17
+++ binary.xml	4 Dec 2005 17:05:22 -0000	1.18
@@ -1,4 +1,4 @@
-<!-- $NetBSD: binary.xml,v 1.17 2005/11/29 09:58:27 rillig Exp $ -->
+<!-- $NetBSD: binary.xml,v 1.18 2005/12/04 17:05:22 rillig Exp $ -->
 
 <chapter id="binary">
   <title>Creating binary packages</title>
@@ -99,6 +99,29 @@
     PKG_DEVELOPER?= yes
     _ACCEPTABLE=    yes
 </programlisting>
+
+	<para>Some options that are especially useful for bulk builds
+	can be found at the top lines of the file
+	<filename>mk/bulk/bsd.bulk-pkg.mk</filename>. The most useful
+	options of these are briefly described here.</para>
+
+	<itemizedlist>
+
+	<listitem><para>If you are on a slow machine, you may want to
+	set <varname>USE_BULK_BROKEN_CHECK</varname> to
+	<quote>no</quote>.</para></listitem>
+
+	<listitem><para>If you are doing bulk builds from a read-only
+	copy of pkgsrc, you have to set <varname>BULKFILESDIR</varname>
+	to the directory where all log files are created. Otherwise the
+	log files are created in the pkgsrc directory.</para></listitem>
+
+	<listitem><para>Another important variable is
+	<varname>BULK_PREREQ</varname>, which is a list of packages that
+	should be always available while building other
+	packages.</para></listitem>
+
+	</itemizedlist>
       </sect3>
 
       <sect3 id="pre-build.local">