Index: en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml =================================================================== --- en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml +++ 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, in + the form of + account:project:tagname[:group]. + It is helpful when there are more than one GitHub + project to fetch from. + + + 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 all 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 the same content as the previous one, 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 + + + As there is no grouping possible like there was in the + previous example with + bar:icons,contrib, there is some + redundant information. +