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
@@ -1965,6 +1965,88 @@
 	    <varname>${WRKDIR}/foo-1.0.2</varname>.</para>
 	</example>
 
+	<sect4>
+	  <title>Fetching Multiple Files From GitHub</title>
+
+	  <para>The <varname>USE_GITHUB</varname> framework also
+	    supports fetching multiple distribution files from
+	    different places in GitHub.  It works in a very similar
+	    way than the <xref
+	      linkend="porting-master-sites-n"/>.</para>
+
+	  <para>Multiple values are added to
+	    <varname>GH_ACCOUNT</varname>,
+	    <varname>GH_PROJECT</varname>, and
+	    <varname>GH_TAGNAME</varname>, each different value is
+	    assigned a tag.  The main value can either have no tag, or
+	    the <literal>:DEFAULT</literal> tag.  A value can be
+	    omitted if it is the same as the default as listed in
+	    <xref
+	      linkend="makefile-master_sites-github-description"/>.</para>
+
+	  <para>For each tag, a
+	    <varname>${WRKSRC_<replaceable>tag</replaceable>}</varname>
+	    helper variable is created, it contains the directory into
+	    which the file has been extracted.  The
+	    <varname>${WRKSRC_<replaceable>tag</replaceable>}</varname>
+	    variables can be used to move directories around during
+	    <buildtarget>post-extract</buildtarget>, or add to
+	    <varname>CONFIGURE_ARGS</varname>, or whatever is needed
+	    so that the software builds correctly.</para>
+
+	  <example xml:id="makefile-master_sites-github-multi">
+	    <title>Use of <varname>USE_GITHUB</varname> with Multiple
+	      Distribution Files</title>
+
+	    <para>From time to time, there is a need to fetch more
+	      than one distribution file.  For example, when the
+	      upstream git repository uses submodules.  This can be
+	      done easily using tags in the
+	      <varname>GH_<replaceable>*</replaceable></varname>
+	      variables:</para>
+
+	    <programlisting>PORTNAME=	foo
+PORTVERSION=	1.0.2
+
+USE_GITHUB=	yes
+GH_ACCOUNT=	bar:icons,contrib
+GH_PROJECT=	foo-icons:icons foo-contrib:contrib
+GH_TAGNAME=	1.0:icons fa579bc:contrib
+
+CONFIGURE_ARGS=	--with-contrib=${WRKSRC_contrib}
+
+post-extract:
+	@${MV} ${WRKSRC_icons} ${WRKSRC}/icons</programlisting>
+
+	    <para>This will fetch three distribution files from
+	      github, the default one comes from
+	      <filename>foo/foo</filename> and is version
+	      <literal>1.0.2</literal>, the second one, tagged
+	      <literal>icons</literal>, comes from
+	      <filename>bar/foo-icons</filename> and is in version
+	      <literal>1.0</literal>, and the third one comes from
+	      <filename>bar/foo-contrib</filename> and uses the
+	      <application>Git</application> commit
+	      <literal>fa579bc</literal>.  The distribution files are
+	      named <filename>foo-foo-1.0.2_GH0.tar.gz</filename>,
+	      <filename>bar-foo-icons-1.0_GH0.tar.gz</filename>, and
+	      <filename>bar-foo-contrib-fa579bc_GH0.tar.gz</filename>.</para>
+
+	    <para>All the distribution files extracted in
+	      <varname>${WRKDIR}</varname> in their respective
+	      sub-directories.  The default one is still extracted in
+	      <varname>${WRKSRC}</varname>, in this case,
+	      <filename>${WRKDIR}/foo-1.0.2</filename>.  Each
+	      additional distribution file in its
+	      <varname>${WRKSRC_<replaceable>tag</replaceable>}</varname>,
+	      here, for the <literal>icons</literal> tag, it is called
+	      <varname>${WRKSRC_icons}</varname> and it contains
+	      <filename>${WRKDIR}/foo-icons-1.0</filename>, the one
+	      with the <literal>contrib</literal> tag is called
+	      <varname>${WRKSRC_contrib}</varname> and contains
+	      <literal>${WRKDIR}/foo-contrib-fa579bc</literal>.</para>
+	  </example>
+	</sect4>
       </sect3>
     </sect2>
 
@@ -2099,9 +2181,8 @@
     </sect2>
 
     <sect2 xml:id="porting-master-sites-n">
-      <title>Multiple Distribution Files or Patches from Different
-	Sites and Subdirectories
-	(<literal>MASTER_SITES:n</literal>)</title>
+      <title>Multiple Distribution or Patches Files from Multiple
+	Locations</title>
 
       <para>(Consider this to be a somewhat
 	<quote>advanced topic</quote>; those new to this document