Date: Thu, 2 May 2019 14:18:22 +0000 (UTC) From: Mathieu Arnold <mat@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r52974 - head/en_US.ISO8859-1/books/porters-handbook/makefiles Message-ID: <201905021418.x42EIMlF099611@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201905021418.x42EIMlF099611>