summaryrefslogtreecommitdiff
path: root/doc/guide
diff options
context:
space:
mode:
authormishka <mishka@pkgsrc.org>2006-10-09 13:15:07 +0000
committermishka <mishka@pkgsrc.org>2006-10-09 13:15:07 +0000
commitc2aaeefffb04decbbf54c12a9e2dd92af4ecb38c (patch)
treedcde2c2d26a32071bf8692b4a741c9a561673310 /doc/guide
parentf75176b39cb7d35a6a241e5e0a0e934d21742e72 (diff)
downloadpkgsrc-c2aaeefffb04decbbf54c12a9e2dd92af4ecb38c.tar.gz
Add documentation for MASTER_SORT_RANDOM variable.
Diffstat (limited to 'doc/guide')
-rw-r--r--doc/guide/files/build.xml8
-rw-r--r--doc/guide/files/using.xml10
2 files changed, 14 insertions, 4 deletions
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