Changeset 36917 for trunk/doc-new


Ignore:
Timestamp:
May 18, 2008, 11:37:08 PM (11 years ago)
Author:
markd@…
Message:

Clarify master_sites description.

File:
1 edited

Legend:

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

    r36901 r36917  
    275275          <varname>${distfiles}</varname> may be retrieved.</para>
    276276
    277           <para>Possible <code>master_sites</code> keyword values include
     277          <para>Keyword values for <code>master_sites</code> may include
    278278          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
     279          sourceforge, gnu, etc. If the file(s) declared in
     280          <varname>${distfiles}</varname> are not successfully fetched after
     281          trying the <code>master_sites</code> values, the MacPorts Project
     282          mirror is always tried last before giving up.</para>
     283
     284          <para>For a complete list of mirrors and their list of sites, see
     285          the file <filename>mirror_sites.tcl</filename> located in
    284286          <filename>${prefix}/share/macports/resources/port1.0/fetch/</filename>.</para>
    285287
    286288          <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>
     289            <para>If a <code>master_sites</code> keyword has multiple values,
     290            after any mirrors are expanded the list of sites is sorted by ping
     291            response times. The sites are then tried in sorted order until
     292            matching <varname>${distfiles}</varname> are found.</para>
    292293          </note>
    293294
     
    308309
    309310              <para>You may also use mirror site lists predefined by MacPorts.
    310               Here the sourceforge and gnu mirrors are used.</para>
    311 
    312               <programlisting>master_sites        sourceforge gnu
     311              Here the sourceforge, gnu, and MacPorts Project mirrors are
     312              used.</para>
     313
     314              <programlisting>master_sites        sourceforge gnu macports
    313315
    314316</programlisting>
     317
     318              <note>
     319                <para>Though the MacPorts Project mirror
     320                (<code>macports</code>) is always tried last if no
     321                <varname>${distfiles}</varname> match is found, if the mirror
     322                <code>macports</code> is explicitly declared it is tried in
     323                the normal sort order.</para>
     324              </note>
    315325
    316326              <para>When using mirror master_sites, the subdirectory
Note: See TracChangeset for help on using the changeset viewer.