[pkgsrc/trunk]: pkgsrc/doc/guide/files Add documentation for MASTER_SORT_RAND...

[mishka <mishka%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/2d5f8e2ee34a
branches:  trunk
changeset: 519773:2d5f8e2ee34a
user:      mishka <mishka%pkgsrc.org@localhost>
date:      Mon Oct 09 13:15:07 2006 +0000

description:
Add documentation for MASTER_SORT_RANDOM variable.

diffstat:

 doc/guide/files/build.xml |   8 +++++---
 doc/guide/files/using.xml |  10 +++++++++-
 2 files changed, 14 insertions(+), 4 deletions(-)

diffs (46 lines):

diff -r 96d44b69ddb6 -r 2d5f8e2ee34a doc/guide/files/build.xml
--- a/doc/guide/files/build.xml Mon Oct 09 12:52:34 2006 +0000
+++ b/doc/guide/files/build.xml Mon Oct 09 13:15:07 2006 +0000
@@ -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>
 
diff -r 96d44b69ddb6 -r 2d5f8e2ee34a doc/guide/files/using.xml
--- a/doc/guide/files/using.xml Mon Oct 09 12:52:34 2006 +0000
+++ b/doc/guide/files/using.xml Mon Oct 09 13:15:07 2006 +0000
@@ -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