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

[Mathieu Arnold]

Author: mat
Date: Sun Nov 27 12:40:15 2016
New Revision: 49703
URL: https://svnweb.freebsd.org/changeset/doc/49703

Log:
  Add a note about the :group in USE_GITHUB variables being unique.
  
  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	Sun Nov 27 12:40:13 2016	(r49702)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Sun Nov 27 12:40:15 2016	(r49703)
@@ -2120,6 +2120,15 @@ USE_GITHUB=	yes</programlisting>
 	  <varname>CONFIGURE_ARGS</varname>, or whatever is needed
 	  so that the software builds correctly.</para>
 
+	<caution>
+	  <para>The
+	    <literal>:<replaceable>group</replaceable></literal> part
+	    <emphasis>must</emphasis> be used for <emphasis>only
+	      one</emphasis> distribution file.  It is used as a
+	    unique key and using it more than once will overwrite the
+	    previous values.</para>
+	</caution>
+
 	<note>
 	  <para>As this is only syntastic sugar above
 	    <varname>DISTFILES</varname> and