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

[Mathieu Arnold]

Author: mat
Date: Thu May  2 14:18:22 2019
New Revision: 52974
URL: https://svnweb.freebsd.org/changeset/doc/52974

Log:
  Document that USE_GIT(HUB|LAB)=nodefault needs some special handling.
  
  PR:		235762
  Reported by:	jhb

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	Thu May  2 04:25:58 2019	(r52973)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Thu May  2 14:18:22 2019	(r52974)
@@ -2664,12 +2664,6 @@ v0.7.3-0-gc66c71d</screen>
 	  similar to <xref
 	    linkend="porting-master-sites-n"/>.</para>
 
-	<para>When fetching multiple files from GitHub, sometimes the
-	  default distribution file is not fetched from GitHub.  To disable
-	  fetching the default distribution, set:</para>
-
-	<programlisting>USE_GITHUB=	nodefault</programlisting>
-
 	<para>Multiple values are added to
 	  <varname>GH_ACCOUNT</varname>,
 	  <varname>GH_PROJECT</varname>, and
@@ -2712,6 +2706,22 @@ v0.7.3-0-gc66c71d</screen>
 	    <xref linkend="porting-master-sites-n"/></para>
 	</note>
 
+	<para>When fetching multiple files from GitHub, sometimes the
+	  default distribution file is not fetched from GitHub.  To disable
+	  fetching the default distribution, set:</para>
+
+	<programlisting>USE_GITHUB=	nodefault</programlisting>
+
+	<important>
+	  <para>When using <literal>USE_GITHUB=nodefault</literal>,
+	    the <filename>Makefile</filename> must set
+	    <varname>DISTFILES</varname> in its
+	    <link linkend="porting-order-portname">top block</link>.
+	    The definition should be:</para>
+
+	  <programlisting>DISTFILES=    ${DISTNAME}${EXTRACT_SUFX}</programlisting>
+	</important>
+
 	<example xml:id="makefile-master_sites-github-multi">
 	  <title>Use of <varname>USE_GITHUB</varname> with Multiple
 	    Distribution Files</title>
@@ -3053,12 +3063,6 @@ GL_COMMIT=	9c1669ce60c3f4f5eb43df874d7314483fb3f8a6</p
               linkend="porting-master-sites-n"/> and <xref
               linkend="makefile-master_sites-gitlab-multiple"/>.</para>
 
-          <para>When fetching multiple files using <application>GitLab</application>,
-            sometimes the default distribution file is not fetched from a <application>GitLab</application>
-            site.  To disable fetching the default distribution, set:</para>
-
-          <programlisting>USE_GITLAB=     nodefault</programlisting>
-
           <para>Multiple values are added to
             <varname>GL_SITE</varname>,
             <varname>GL_ACCOUNT</varname>,
@@ -3099,6 +3103,23 @@ GL_COMMIT=	9c1669ce60c3f4f5eb43df874d7314483fb3f8a6</p
               adhere to the restrictions on group names outlined in
               <xref linkend="porting-master-sites-n"/></para>
           </note>
+
+	<para>When fetching multiple files using <application>GitLab</application>,
+	  sometimes the default distribution file is not fetched from a <application>GitLab</application>
+	  site.  To disable fetching the default distribution, set:</para>
+
+	<programlisting>USE_GITLAB=	nodefault</programlisting>
+
+	<important>
+	  <para>When using <literal>USE_GITLAB=nodefault</literal>,
+	    the <filename>Makefile</filename> must set
+	    <varname>DISTFILES</varname> in its
+	    <link linkend="porting-order-portname">top block</link>.
+	    The definition should be:</para>
+
+	  <programlisting>DISTFILES=    ${DISTNAME}${EXTRACT_SUFX}</programlisting>
+	</important>
+
 
         <example xml:id="makefile-master_sites-gitlab-multi">
           <title>Use of <varname>USE_GITLAB</varname> with Multiple