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

pkgsrc/doc/guide/files/build.xml: 1.35 -> 1.36 ほか



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

pkgsrc/doc/guide/files/build.xml: 1.35 -> 1.36
pkgsrc/doc/guide/files/using.xml: 1.27 -> 1.28

> Add documentation for MASTER_SORT_RANDOM variable.

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

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

--- build.xml.orig	2007-01-10 20:07:06.000000000 +0900
+++ build.xml	2007-01-10 20:07:06.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: build.xml,v 1.35 2006/09/13 23:23:00 wiz Exp $ -->
+<!-- $NetBSD: build.xml,v 1.36 2006/10/09 13:15:07 mishka Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: build.xml,v 1.35 2006/09/13 23:23:00 wiz Exp   -->
+<!-- NetBSD: build.xml,v 1.36 2006/10/09 13:15:07 mishka Exp   -->
 
 <chapter id="build">
   <title>構築の手順</title>
@@ -327,8 +327,11 @@
       <para>この <literal>${site}</literal> には、複数の候補が決まった順序で使われます: 最初に
       <varname>MASTER_SITE_OVERRIDE</varname>を試み、次に、<varname>SITES.file</varname>が定義されていればそれ
       を、定義されていなければ、<varname>MASTER_SITES</varname>か<varname>PATCH_SITES</varname>のどちらかを試
-      みます。そして、最後に<varname>MASTER_SITE_BACKUP</varname>の値を試みます。最初のもの以
-      外の順序は、<varname>MASTER_SORT_AWK</varname>か<varname>MASTER_SORT_REGEX</varname>を設定して、ユーザー
+      みます。そして、最後に<varname>MASTER_SITE_BACKUP</varname>の値を試みます。
+      これらのうち最初のものと最後のもの以外の順序は、
+      <varname>MASTER_SORT_RANDOM</varname> を設定し、かつ
+      <varname>MASTER_SORT_AWK</varname>か
+      <varname>MASTER_SORT_REGEX</varname>を設定して、ユーザー
       が入れ換えることができます。</para>
     </sect2>
 
--- using.xml.orig	2007-01-10 20:07:08.000000000 +0900
+++ using.xml	2007-01-10 20:07:08.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: using.xml,v 1.27 2006/09/18 13:25:37 rillig Exp $ -->
+<!-- $NetBSD: using.xml,v 1.28 2006/10/09 13:15:07 mishka Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: using.xml,v 1.27 2006/09/18 13:25:37 rillig Exp   -->
+<!-- NetBSD: using.xml,v 1.28 2006/10/09 13:15:07 mishka Exp   -->
 
 <chapter id="using"> <?dbhtml filename="using.html"?>
 <title>pkgsrc を使う</title>
@@ -297,6 +297,15 @@
     を <filename>mk.conf</filename>
     に加えて、使うことができます。</para>
 
+    <para>標準状態では、人気のあるパッケージを置いているサーバー
+    (たとえば SourceForge.net のミラー) に過大な負荷をかけないようにするため、
+    配布サイトのリストの順序はランダムに入れ換えられます。
+    このため、別の distfile を取得する必要が生ずるたびに、
+    すべてのミラーからの取得を、新たな (ランダムな) 順序で試みます。
+    この機能は、<varname>MASTER_SORT_RANDOM=NO</varname>
+    を設定して止めることができます (<varname>PKG_DEVELOPER</varname>
+    が設定されている場合は、すでに無効化されています)。</para>
+
     <para>主要な配布サイトをあなたのところに近いサイトで上書きす
     ることができます。
     変数をひとつかふたつ設定すると、
Index: build.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/build.xml,v
retrieving revision 1.35
retrieving revision 1.36
diff -u -r1.35 -r1.36
--- build.xml	13 Sep 2006 23:23:00 -0000	1.35
+++ build.xml	9 Oct 2006 13:15:07 -0000	1.36
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.35 2006/09/13 23:23:00 wiz Exp $ -->
+<!-- $NetBSD: build.xml,v 1.36 2006/10/09 13:15:07 mishka Exp $ -->
 
 <chapter id="build">
   <title>The build process</title>
@@ -354,8 +354,10 @@
       defined, else <varname>MASTER_SITES</varname> or
       <varname>PATCH_SITES</varname>, as applies, then finally the
       value of <varname>MASTER_SITE_BACKUP</varname>. The order of
-      all except the first can be optionally sorted by the user,
-      via setting either <varname>MASTER_SORT_AWK</varname> or
+      all except the first and the last can be optionally sorted
+      by the user, via setting either
+      <varname>MASTER_SORT_RANDOM</varname>, and
+      <varname>MASTER_SORT_AWK</varname> or
       <varname>MASTER_SORT_REGEX</varname>.</para>
     </sect2>
 
Index: using.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/using.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- using.xml	18 Sep 2006 13:25:37 -0000	1.27
+++ using.xml	9 Oct 2006 13:15:07 -0000	1.28
@@ -1,4 +1,4 @@
-<!-- $NetBSD: using.xml,v 1.27 2006/09/18 13:25:37 rillig Exp $ -->
+<!-- $NetBSD: using.xml,v 1.28 2006/10/09 13:15:07 mishka Exp $ -->
 
 <chapter id="using"> <?dbhtml filename="using.html"?>
 <title>Using pkgsrc</title>
@@ -285,6 +285,14 @@
     <screen>DISTDIR=/cdrom/pkgsrc/distfiles</screen>
     to your <filename>mk.conf</filename>.</para>
 
+    <para>By default a list of distribution sites will be randomly
+    intermixed to prevent huge load on servers which holding popular
+    packages (for example, SourceForge.net mirrors). Thus, every
+    time when you need to fetch yet another distfile all the mirrors
+    will be tried in new (random) order. You can turn this feature
+    off by setting <varname>MASTER_SORT_RANDOM=NO</varname> (for
+    <varname>PKG_DEVELOPER</varname>s it's already disabled).</para>
+
     <para>You can overwrite some of the major distribution sites to
     fit to sites that are close to your own.  By setting one or two
     variables you can modify the order in which the master sites are