[36901] trunk/doc-new/guide/xml/portfile-phase.xml

[markd at macports.org]

Revision: 36901
          http://trac.macosforge.org/projects/macports/changeset/36901
Author:   markd at macports.org
Date:     2008-05-17 14:46:30 -0700 (Sat, 17 May 2008)

Log Message:
-----------
Document new fetch behavior that sorts master_sites by ping time before
trying them made in r35748. Also see ticket #14891.

Modified Paths:
--------------
    trunk/doc-new/guide/xml/portfile-phase.xml

Modified: trunk/doc-new/guide/xml/portfile-phase.xml
===================================================================
--- trunk/doc-new/guide/xml/portfile-phase.xml	2008-05-17 19:43:59 UTC (rev 36900)
+++ trunk/doc-new/guide/xml/portfile-phase.xml	2008-05-17 21:46:30 UTC (rev 36901)
@@ -271,14 +271,31 @@
         <term>master_sites</term>
 
         <listitem>
-          <para>A list of URLs from which a port's download file(s) may be
-          retrieved. For multiple master_sites, they are searched in order
-          until a file matching <varname>${distfile}</varname> is
-          found.</para>
+          <para>A list of URLs from which a port's
+          <varname>${distfiles}</varname> may be retrieved.</para>
 
+          <para>Possible <code>master_sites</code> keyword values include
+          predefined site lists known as <quote>mirrors</quote>, such as
+          sourceforge, gnu, etc. If the <varname>${distfiles}</varname> are
+          not successfully fetched after trying the explictly defined
+          <code>master_sites</code>, the MacPorts project mirror is always
+          tried before giving up. For a complete list of mirrors, see the file
+          <filename>mirror_sites.tcl</filename> located in
+          <filename>${prefix}/share/macports/resources/port1.0/fetch/</filename>.</para>
+
+          <note>
+            <para>When a <code>master_sites</code> keyword has multiple
+            values, the ping response times are probed for each site during
+            the fetch phase and they are sorted by response times. The sites
+            are then tried in sorted order until a file matching
+            <varname>${distfiles}</varname> is found.</para>
+          </note>
+
           <itemizedlist>
             <listitem>
-              <para>Default: ???</para>
+              <para>Default: <code>macports</code> (the MacPorts Project
+              mirror - implicit final value of
+              <code>master_sites</code>)</para>
             </listitem>
 
             <listitem>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20080517/3b846db3/attachment.htm