Changeset 36901 for trunk/doc-new


Ignore:
Timestamp:
May 17, 2008, 9:46:30 PM (11 years ago)
Author:
markd@…
Message:

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

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/guide/xml/portfile-phase.xml

    r36879 r36901  
    272272
    273273        <listitem>
    274           <para>A list of URLs from which a port's download file(s) may be
    275           retrieved. For multiple master_sites, they are searched in order
    276           until a file matching <varname>${distfile}</varname> is
    277           found.</para>
    278 
    279           <itemizedlist>
    280             <listitem>
    281               <para>Default: ???</para>
     274          <para>A list of URLs from which a port's
     275          <varname>${distfiles}</varname> may be retrieved.</para>
     276
     277          <para>Possible <code>master_sites</code> keyword values include
     278          predefined site lists known as <quote>mirrors</quote>, such as
     279          sourceforge, gnu, etc. If the <varname>${distfiles}</varname> are
     280          not successfully fetched after trying the explictly defined
     281          <code>master_sites</code>, the MacPorts project mirror is always
     282          tried before giving up. For a complete list of mirrors, see the file
     283          <filename>mirror_sites.tcl</filename> located in
     284          <filename>${prefix}/share/macports/resources/port1.0/fetch/</filename>.</para>
     285
     286          <note>
     287            <para>When a <code>master_sites</code> keyword has multiple
     288            values, the ping response times are probed for each site during
     289            the fetch phase and they are sorted by response times. The sites
     290            are then tried in sorted order until a file matching
     291            <varname>${distfiles}</varname> is found.</para>
     292          </note>
     293
     294          <itemizedlist>
     295            <listitem>
     296              <para>Default: <code>macports</code> (the MacPorts Project
     297              mirror - implicit final value of
     298              <code>master_sites</code>)</para>
    282299            </listitem>
    283300
Note: See TracChangeset for help on using the changeset viewer.