svn commit: r46154 - head/en_US.ISO8859-1/books/porters-handbook/makefiles

[Mathieu Arnold]

Author: mat (ports committer)
Date: Wed Jan  7 11:09:00 2015
New Revision: 46154
URL: https://svnweb.freebsd.org/changeset/doc/46154

Log:
  Add a note about what cannot go into MASTER_SITES.
  
  Reviewed by:	bcr, wblock, erwin, bdrewery, ak
  Approved by:	bcr
  Sponsored by:	Absolight

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Wed Jan  7 10:49:44 2015	(r46153)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Wed Jan  7 11:09:00 2015	(r46154)
@@ -1632,6 +1632,17 @@
 	closest master site and fetching from there; having multiple
 	sites will go a long way towards helping this effort.</para>
 
+      <important>
+	<para><varname>MASTER_SITES</varname> must not be blank.  It
+	  must point to the actual site hosting the distribution
+	  files.  It cannot point to web archives, or the &os;
+	  distribution files cache sites.  The only exception to this
+	  rule is ports that do not have any distribution files.  For
+	  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
 	archives such as SourceForge, GNU, or Perl CPAN, it may be
 	possible refer to those sites in an easy compact form using