diff --git a/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml index 46f1f08c8d..479b771370 100644 --- a/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml +++ b/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml @@ -1977,10 +1977,27 @@ MASTER_SITE_SUBDIR= stardict/WyabdcRealPeopleTTS/${PORTVERSION} 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 @@ USE_GITHUB= yes ${WRKDIR}/foo-1.0.2. - + Fetching Multiple Files from GitHub The USE_GITHUB framework also @@ -2071,6 +2088,11 @@ USE_GITHUB= yes . + 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 @@ post-extract: ${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. +