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

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



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

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

> revision 1.17
> date: 2005/11/29 09:58:27;  author: rillig;  state: Exp;  lines: +20 -16
> Reordered the configuration files for bulk builds. Since the
> build.conf file contains a setting for choosing another mk.conf file,
> it should come first. Updated the wording of the text.

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

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

--- binary.xml.orig	2006-10-17 22:55:19.000000000 +0900
+++ binary.xml	2006-10-17 22:55:19.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: binary.xml,v 1.16 2005/10/23 11:25:58 rillig Exp $ -->
+<!-- $NetBSD: binary.xml,v 1.17 2005/11/29 09:58:27 rillig Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: binary.xml,v 1.16 2005/10/23 11:25:58 rillig Exp   -->
+<!-- NetBSD: binary.xml,v 1.17 2005/11/29 09:58:27 rillig Exp   -->
 
 <chapter id="binary">
   <title>バイナリーパッケージを作る</title>
@@ -51,9 +51,12 @@
 
     <para>この章では、コンパイル済みバイナリーパッケージを全部揃えたい人のために、そ
       の方法を説明します。バルクビルドを行うと、その時点でシステムにインストール
-      されているパッケージをすべて削除しますので注意してください! バルクビルドを
-      行うマシンかその近くのNFSサーバーをFTPサーバーに設定することで、構築したパッ
-      ケージをみんなが使えるようにできます。さらなる情報は
+      されているパッケージをすべて削除しますので注意してください!</para>
+
+      <para>バルクビルドを行うマシンかその近くのNFSサーバーをFTPサーバーに設定することで、
+      構築したパッケージを他のマシンが使えるようになります。こうすると、
+      他のマシンはバイナリーパッケージをインストールするだけですむので、
+      時間を節約することができます。さらなる情報は
       &man.ftpd.8;をご覧ください。
       リモートNFSサーバーのストレージを使っている場合、実際のコンパイルがNFSスト
       レージ上で行われると非常に遅くなるので、そうなっていないことを確認してくだ
@@ -62,6 +65,19 @@
     <sect2 id="binary.configuration">
       <title>設定</title>
 
+      <sect3 id="binary.bulk.build.conf">
+	<title><filename>build.conf</filename></title>
+
+        <para><filename>build.conf</filename> ファイルは、
+        バルクビルドの主たる設定ファイルです。pkgsrc ツリーを最新に保つ方法、
+        distfile のダウンロード方法、パッケージの構築方法や、
+        報告の作成方法を設定することができます。註釈つきの設定例が
+        <filename>pkgsrc/mk/bulk/build.conf-example</filename> にあります。
+        これを使うには、<filename>build.conf-example</filename> を
+        <filename>build.conf</filename> にコピーし、
+        このファイル中のコメントに従って編集します。</para>
+      </sect3>
+
       <sect3 id="binary.mk.conf">
 	<title>/etc/mk.conf</title>
 
@@ -84,18 +100,6 @@
 </programlisting>
       </sect3>
 
-      <sect3 id="build.conf">
-	<title><filename>build.conf</filename></title>
-
-	<para><filename>pkgsrc/mk/bulk</filename>ディレクトリーの
-	  <filename>build.conf-example</filename>を
-	  <filename>build.conf</filename> にコピー
-	  し、このファイル中のコメントに従って編集します。このファイルは、構築後に作
-	  られるログファイルをどこに置くか、構築の報告メールをどこに出すか、pkgsrcツリーの
-	  場所はどこか、および、どのユーザーに&man.su.8;して<command>cvs update</command>をおこなうか、を決め
-	  る設定ファイルです。</para>
-      </sect3>
-
       <sect3 id="pre-build.local">
 	<title><filename>pre-build.local</filename></title>
 
Index: binary.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/binary.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- binary.xml	23 Oct 2005 11:25:58 -0000	1.16
+++ binary.xml	29 Nov 2005 09:58:27 -0000	1.17
@@ -1,4 +1,4 @@
-<!-- $NetBSD: binary.xml,v 1.16 2005/10/23 11:25:58 rillig Exp $ -->
+<!-- $NetBSD: binary.xml,v 1.17 2005/11/29 09:58:27 rillig Exp $ -->
 
 <chapter id="binary">
   <title>Creating binary packages</title>
@@ -51,9 +51,12 @@
     <para>If you want to get a full set of precompiled binary
       packages, this section describes how to get them. Beware that
       the bulk build will remove all currently installed packages from
-      your system! Having an FTP server configured either on the
+      your system!</para>
+
+      <para>Having an FTP server configured either on the
       machine doing the bulk builds or on a nearby NFS server can help
-      to make the packages available to everyone. See &man.ftpd.8; for
+      to make the packages available to other machines that can then
+      save time by installing only the binary packages. See &man.ftpd.8; for
       more information. If you use a remote NFS server's storage, be
       sure to not actually compile on NFS storage, as this slows
       things down a lot.</para>
@@ -61,6 +64,20 @@
     <sect2 id="binary.configuration">
       <title>Configuration</title>
 
+      <sect3 id="binary.bulk.build.conf">
+	<title><filename>build.conf</filename></title>
+
+        <para>The <filename>build.conf</filename> file is the main
+        configuration file for bulk builds. You can configure how your
+        copy of pkgsrc is kept up to date, how the distfiles are
+        downloaded, how the packages are built and how the report is
+        generated. You can find an annotated example file in
+        <filename>pkgsrc/mk/bulk/build.conf-example</filename>. To use
+        it, copy <filename>build.conf-example</filename> to
+        <filename>build.conf</filename> and edit it, following the
+        comments in that file.</para>
+      </sect3>
+
       <sect3 id="binary.mk.conf">
 	<title>/etc/mk.conf</title>
 
@@ -84,19 +101,6 @@
 </programlisting>
       </sect3>
 
-      <sect3 id="build.conf">
-	<title><filename>build.conf</filename></title>
-
-	<para>In <filename>pkgsrc/mk/bulk</filename>, copy
-	  <filename>build.conf-example</filename> to
-	  <filename>build.conf</filename> and
-	  edit it, following the comments in that file. This is the config
-	  file that determines where log files are generated after the build,
-	  where to mail the build report to, where your pkgsrc tree is
-	  located and the user to which user to &man.su.8; to do a
-	  <command>cvs update</command>.</para>
-      </sect3>
-
       <sect3 id="pre-build.local">
 	<title><filename>pre-build.local</filename></title>