From: Zac Medico <zmedico@gentoo.org>
Date: Thu, 4 Sep 2008 22:39:05 +0000 (-0000)
Subject: Document EAPI 2 support in the unpack helper function for gitweb snapshots.
X-Git-Tag: v2.2_rc9~32
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=bf49a1e462d7359b83b0140e838310d24758166a;p=portage.git

Document EAPI 2 support in the unpack helper function for gitweb snapshots.
A patch implementing this feature has been submitted by Daniel Robbins.

svn path=/main/trunk/; revision=11494
---

diff --git a/doc/package/ebuild/eapi/2.docbook b/doc/package/ebuild/eapi/2.docbook
index 2f0ca533e..6f03ffb06 100644
--- a/doc/package/ebuild/eapi/2.docbook
+++ b/doc/package/ebuild/eapi/2.docbook
@@ -306,6 +306,18 @@ src_compile() {
 	</tgroup>
 	</table>
 	</section>
+	<section id='package-ebuild-eapi-2-draft-helpers-unpack'>
+	<title>unpack</title>
+	<section id='package-ebuild-eapi-2-draft-helpers-unpack-gitweb-snapshots'>
+	<title>Gitweb Snapshots</title>
+	<para>
+	To aid interoperatiblity with gitweb, files with the suffixes of ;sf=tbz2
+	and ;sf=tgz are now treated as .tar.bz2 and .tar.gz archives, respectively.
+	This allows for ebuilds to consume gitweb snapshots and still use the
+	default src_unpack implementation.
+	</para>
+	</section>
+	</section>
 	</section>
 	<section id='package-ebuild-eapi-2-draft-metadata'>
 	<title>Metadata</title>