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 <varname>USE_GITHUB</varname> @@ -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 <varname>USE_GITHUB</varname> with Multiple + Distribution Files Using + <varname>GH_TUPLE</varname> + + 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. +