From c2aaeefffb04decbbf54c12a9e2dd92af4ecb38c Mon Sep 17 00:00:00 2001
From: mishka <mishka@pkgsrc.org>
Date: Mon, 9 Oct 2006 13:15:07 +0000
Subject: Add documentation for MASTER_SORT_RANDOM variable.

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

(limited to 'doc')

diff --git a/doc/guide/files/build.xml b/doc/guide/files/build.xml
index 272c1a42255..a8764a25692 100644
--- a/doc/guide/files/build.xml
+++ b/doc/guide/files/build.xml
@@ -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 --git a/doc/guide/files/using.xml b/doc/guide/files/using.xml
index 714abe53a47..3e26ead75a3 100644
--- a/doc/guide/files/using.xml
+++ b/doc/guide/files/using.xml
@@ -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 @@ Version mismatch: 'tcsh' 6.09.00 vs 6.10.00
     <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
-- 
cgit v1.2.3