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

[Alex Kozlov]

Author: ak (ports committer)
Date: Sat Oct 14 07:28:50 2017
New Revision: 51120
URL: https://svnweb.freebsd.org/changeset/doc/51120

Log:
  - Remove phrase 'bloat in the master source repository' as a leftover from the cvs times
  - Remove phrase about 'automatically determining of closet master site...', it
    was in planing phase for more than 15 years
  - Replace 'gzipped' with 'compressed' when appropriate
  - Update url for the backup master site
  - Fix typo: s/otn/from/
  - Remove reference to DATA option
  
  Differential Revision:	https://reviews.freebsd.org/D1017
  Approved by:	portmgr (mat)

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	Sat Oct 14 07:21:38 2017	(r51119)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Sat Oct 14 07:28:50 2017	(r51120)
@@ -1697,8 +1697,7 @@ PORTEPOCH=	1</programlisting>
 	we can discuss it before we import it.  As a committer,
 	send a note to the &a.ports; so we can discuss it
 	first.  Too often, new ports are imported to the wrong
-	category only to be moved right away.  This causes unnecessary
-	and undesirable bloat in the master source repository.</para>
+	category only to be moved right away.</para>
     </sect2>
 
     <sect2 xml:id="proposing-categories">
@@ -2058,10 +2057,7 @@ DIST_SUBDIR=	${PORTNAME}-${PORTVERSION}</programlistin
 
       <para>It is recommended that multiple sites are included on this
 	list, preferably from different continents.  This will
-	safeguard against wide-area network problems.  We are even
-	planning to add support for automatically determining the
-	closest master site and fetching from there; having multiple
-	sites will go a long way towards helping this effort.</para>
+	safeguard against wide-area network problems.</para>
 
       <important>
 	<para><varname>MASTER_SITES</varname> must not be blank.  It
@@ -2968,7 +2964,7 @@ EXTRACT_ONLY=	source.tar.gz</programlisting>
 	<filename>.bz2</filename> or <filename>.xz</filename>.</para>
 
       <para>If the patch is distributed with some other files, such as
-	documentation, in a <command>gzip</command>ped tarball, using
+	documentation, in a compressed tarball, using
 	<varname>PATCHFILES</varname> is not possible.  If that is the
 	case, add the name and the location of the patch tarball to
 	<varname>DISTFILES</varname> and
@@ -2997,9 +2993,8 @@ EXTRACT_ONLY=	source.tar.gz</programlisting>
       <note>
 	<para>The tarball will have been extracted alongside the
 	  regular source by then, so there is no need to explicitly
-	  extract it if it is a regular <command>gzip</command>ped or
-	  <command>compress</command>ed tarball.  Take extra care not
-	  to overwrite something that already exists in that
+	  extract it if it is a regular compressed tarball.  Take extra
+	  care not to overwrite something that already exists in that
 	  directory if extracting it manually.  Also, do not forget to
 	  add a command to remove the copied patch in the
 	  <buildtarget>pre-clean</buildtarget> target.</para>
@@ -3676,8 +3671,9 @@ PATCHFILES=	patch1:test</programlisting>
 	that subdirectory.</para>
 
       <para>It will also look at the subdirectory with the same name
-	on the backup master site at
-	<filename>ftp.FreeBSD.org</filename>.  (Setting
+	on the backup master site at <link>
+	  <xlink:href="http://distcache.FreeBSD.org">http://distcache.FreeBSD.org</link>
+	(Setting
 	<varname>DISTDIR</varname> explicitly in
 	<filename>Makefile</filename> will not accomplish this, so
 	please use <varname>DIST_SUBDIR</varname>.)</para>
@@ -4772,7 +4768,7 @@ LICENSE_FILE=	${WRKSRC}/COPYING</programlisting>
 	      Equivalent to setting <link
 		linkend="porting-restrictions-no_package"><varname>NO_PACKAGE</varname></link>.
 	      The package will <emphasis>not</emphasis> be distributed
-	      otn the &os; package
+	      from the &os; package
 	      <acronym>CDN</acronym> <link
 		xlink:href="http://pkg.freebsd.org/">http://pkg.freebsd.org/</link>.</para>
 	  </listitem>
@@ -7445,10 +7441,8 @@ DISTVERSION=	1.0</programlisting>
 	  additional documentation installed in
 	  <varname>DOCSDIR</varname>.  It does not apply to standard
 	  man pages and info pages.  Things installed in
-	  <varname>DATADIR</varname> and
 	  <varname>EXAMPLESDIR</varname> are controlled by
-	  <literal>DATA</literal> and <literal>EXAMPLES</literal>
-	  options, respectively.</para>
+	  the <literal>EXAMPLES</literal> option.</para>
       </note>
 
       <para>These variables are exported to