Page MenuHomeFreeBSD
Files F166215172

D5509.id13940.diff
No OneTemporary
Actions

D5509.id13940.diff
View Options

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.</entry>
<entry><literal>${DISTVERSIONPREFIX}${DISTVERSION}${DISTVERSIONSUFFIX}</literal></entry>
</row>
+
+ <row>
+ <entry><varname>GH_TUPLE</varname></entry>
+ <entry><varname>GH_TUPLE</varname> allows putting all
+ the <varname>GH_ACCOUNT</varname>,
+ <varname>GH_PROJECT</varname>, and
+ <varname>GH_TAGNAME</varname> into one variable, in
+ the form of
+ <literal>account:project:tagname[:group]</literal>.
+ It is helpful when there are more than one GitHub
+ project to fetch from.</entry>
+ </row>
</tbody>
</tgroup>
</table>
+ <important>
+ <para>Do not use <varname>GH_TUPLE</varname> for the default
+ distribution file, as it has no default.</para>
+ </important>
+
<example xml:id="makefile-master_sites-github-ex1">
<title>Simple Use of <varname>USE_GITHUB</varname></title>
@@ -2052,7 +2069,7 @@
<varname>${WRKDIR}/foo-1.0.2</varname>.</para>
</example>
- <sect3>
+ <sect3 xml:id="makefile-master_sites-github-multiple">
<title>Fetching Multiple Files from GitHub</title>
<para>The <varname>USE_GITHUB</varname> framework also
@@ -2071,6 +2088,11 @@
<xref
linkend="makefile-master_sites-github-description"/>.</para>
+ <para><varname>GH_TUPLE</varname>, 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.</para>
+
<para>For each tag, a
<varname>${WRKSRC_<replaceable>tag</replaceable>}</varname>
helper variable is created, containing the directory into
@@ -2133,6 +2155,33 @@
<varname>${WRKSRC_contrib}</varname> and contains
<literal>${WRKDIR}/foo-contrib-fa579bc</literal>.</para>
</example>
+
+ <example xml:id="makefile-master_sites-github-multi2">
+ <title>Use of <varname>USE_GITHUB</varname> with Multiple
+ Distribution Files Using
+ <varname>GH_TUPLE</varname></title>
+
+ <para>This is the same content as the previous one, but
+ using <varname>GH_TUPLE</varname>:</para>
+
+ <programlisting>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</programlisting>
+
+
+ <para>As there is no grouping possible like there was in the
+ previous example with
+ <literal>bar:icons,contrib</literal>, there is some
+ redundant information.</para>
+ </example>
</sect3>
</sect2>

File Metadata

Mime Type
text/plain
Expires
Thu, Aug 13, 10:25 AM (7 h, 32 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
36624242
Default Alt Text
D5509.id13940.diff (2 KB)

Event Timeline