0
@@ -274,21 +274,22 @@
0
           <para>A list of URLs from which a port's
0
           <varname>${distfiles}</varname> may be retrieved.</para>
0
 
0
-          <para>Possible <code>master_sites</code> keyword values include
0
+          <para>Keyword values for <code>master_sites</code> may include
0
           predefined site lists known as <quote>mirrors</quote>, such as
0
-          sourceforge, gnu, etc. If the <varname>${distfiles}</varname> are
0
-          not successfully fetched after trying the explictly defined
0
-          <code>master_sites</code>, the MacPorts project mirror is always
0
-          tried before giving up. For a complete list of mirrors, see the file
0
-          <filename>mirror_sites.tcl</filename> located in
0
+          sourceforge, gnu, etc. If the file(s) declared in
0
+          <varname>${distfiles}</varname> are not successfully fetched after
0
+          trying the <code>master_sites</code> values, the MacPorts Project
0
+          mirror is always tried last before giving up.</para>
0
+
0
+          <para>For a complete list of mirrors and their list of sites, see
0
+          the file <filename>mirror_sites.tcl</filename> located in
0
           <filename>${prefix}/share/macports/resources/port1.0/fetch/</filename>.</para>
0
 
0
           <note>
0
-            <para>When a <code>master_sites</code> keyword has multiple
0
-            values, the ping response times are probed for each site during
0
-            the fetch phase and they are sorted by response times. The sites
0
-            are then tried in sorted order until a file matching
0
-            <varname>${distfiles}</varname> is found.</para>
0
+            <para>If a <code>master_sites</code> keyword has multiple values,
0
+            after any mirrors are expanded the list of sites is sorted by ping
0
+            response times. The sites are then tried in sorted order until
0
+            matching <varname>${distfiles}</varname> are found.</para>
0
           </note>
0
 
0
           <itemizedlist>
0
@@ -307,12 +308,21 @@
0
 </programlisting>
0
 
0
               <para>You may also use mirror site lists predefined by MacPorts.
0
-              Here the sourceforge and gnu mirrors are used.</para>
0
+              Here the sourceforge, gnu, and MacPorts Project mirrors are
0
+              used.</para>
0
 
0
-              <programlisting>master_sites        sourceforge gnu
0
+              <programlisting>master_sites        sourceforge gnu macports
0
 
0
 </programlisting>
0
 
0
+              <note>
0
+                <para>Though the MacPorts Project mirror
0
+                (<code>macports</code>) is always tried last if no
0
+                <varname>${distfiles}</varname> match is found, if the mirror
0
+                <code>macports</code> is explicitly declared it is tried in
0
+                the normal sort order.</para>
0
+              </note>
0
+
0
               <para>When using mirror master_sites, the subdirectory
0
               <varname>${name}</varname> is checked on every mirror. If the
0
               mirror subdirectory does not match ${name}, then you may specify