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 2f0ca533efe418721dafd09e58886efaef23d595..6f03ffb068ac3ae009e8fd861108e40fd640bcb2 100644 (file)
--- 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>