Changeset View
Changeset View
Standalone View
Standalone View
en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
Show First 20 Lines • Show All 1,626 Lines • ▼ Show 20 Lines | system.</para> | ||||
<para>It is recommended that multiple sites are included on this | <para>It is recommended that multiple sites are included on this | ||||
list, preferably from different continents. This will | list, preferably from different continents. This will | ||||
safeguard against wide-area network problems. We are even | safeguard against wide-area network problems. We are even | ||||
planning to add support for automatically determining the | planning to add support for automatically determining the | ||||
closest master site and fetching from there; having multiple | closest master site and fetching from there; having multiple | ||||
sites will go a long way towards helping this effort.</para> | sites will go a long way towards helping this effort.</para> | ||||
<important> | |||||
<para><varname>MASTER_SITES</varname> must not be blank. It | |||||
bdrewery: USE_GITHUB is another exception. | |||||
must point to the actual site hosting the distribution | |||||
files. It cannot point to web archives, or the &os; | |||||
Not Done Inline ActionsIMHO, it's a little too vague, why can't MASTER_SITES points to webarchive.org or any other permanent archive ? ak: IMHO, it's a little too vague, why can't MASTER_SITES points to webarchive.org or any other… | |||||
Not Done Inline ActionsMmmm, because that's our policy. mat: Mmmm, because that's our policy. | |||||
distribution files cache sites. The only exception to this | |||||
rule is ports that do not have any distribution files. For | |||||
Not Done Inline ActionsHmm. In some cases ports other than meta-ports can have MASTER_SITES left blank, like https://svnweb.freebsd.org/ports/head/www/googlebook_dl/Makefile?annotate=354597#l7 ak: Hmm. In some cases ports other than meta-ports can have MASTER_SITES left blank, like https… | |||||
Not Done Inline ActionsI would make that two sentences, it makes the sentences easier to read and understand:
bcr: I would make that two sentences, it makes the sentences easier to read and understand:
1) The… | |||||
Not Done Inline ActionsAgreed on both. For the second sentence: For example, meta-ports do not have any distribution files, so <varname>MASTER_SITES</varname> does not need to be set. wblock: Agreed on both. For the second sentence:
For example, meta-ports do not have any distribution… | |||||
example, meta-ports do not have any distribution files, so | |||||
<varname>MASTER_SITES</varname> does not need to be | |||||
set.</para> | |||||
</important> | |||||
<para>If the original tarball is part of one of the popular | <para>If the original tarball is part of one of the popular | ||||
archives such as SourceForge, GNU, or Perl CPAN, it may be | archives such as SourceForge, GNU, or Perl CPAN, it may be | ||||
possible refer to those sites in an easy compact form using | possible refer to those sites in an easy compact form using | ||||
predefined macros (for example, <literal>SF</literal>, | predefined macros (for example, <literal>SF</literal>, | ||||
<literal>GNU</literal> or <literal>CPAN</literal>). | <literal>GNU</literal> or <literal>CPAN</literal>). | ||||
Set <varname>MASTER_SITES</varname> to one of these values. | Set <varname>MASTER_SITES</varname> to one of these values. | ||||
Here is an example:</para> | Here is an example:</para> | ||||
▲ Show 20 Lines • Show All 3,098 Lines • Show Last 20 Lines |
USE_GITHUB is another exception.