Index: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
===================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
@@ -1977,10 +1977,27 @@
snapshot.
${DISTVERSIONPREFIX}${DISTVERSION}${DISTVERSIONSUFFIX}
+
+
+ GH_TUPLE
+ GH_TUPLE allows putting all
+ the GH_ACCOUNT,
+ GH_PROJECT, and
+ GH_TAGNAME into one variable. The
+ format is
+ account:project:tagname:group.
+ It is helpful when there is more than one GitHub
+ project from which to fetch.
+
+
+ Do not use GH_TUPLE for the default
+ distribution file, as it has no default.
+
+
Simple Use of USE_GITHUB
@@ -2052,7 +2069,7 @@
${WRKDIR}/foo-1.0.2.
-
+
Fetching Multiple Files from GitHub
The USE_GITHUB framework also
@@ -2071,6 +2088,11 @@
.
+ GH_TUPLE can also be used when there
+ are a lot of distribution files. It helps keep the account,
+ project, tagname, and group information at the same
+ place.
+
For each tag, a
${WRKSRC_tag}
helper variable is created, containing the directory into
@@ -2133,6 +2155,33 @@
${WRKSRC_contrib} and contains
${WRKDIR}/foo-contrib-fa579bc.
+
+
+ Use of USE_GITHUB with Multiple
+ Distribution Files Using
+ GH_TUPLE
+
+ This is functionally equivalent to , but
+ using GH_TUPLE:
+
+ PORTNAME= foo
+PORTVERSION= 1.0.2
+
+USE_GITHUB= yes
+GH_TUPLE= bar:foo-icons:1.0:icons \
+ bar:foo-contrib:fa579bc:contrib
+
+CONFIGURE_ARGS= --with-contrib=${WRKSRC_contrib}
+
+post-extract:
+ @${MV} ${WRKSRC_icons} ${WRKSRC}/icons
+
+ Grouping was used in the previous example with
+ bar:icons,contrib. Some redundant
+ information is present with GH_TUPLE
+ because grouping is not possible.
+