From: Zac Medico <zmedico@gentoo.org>
Date: Thu, 4 Sep 2008 21:34:14 +0000 (-0000)
Subject: Add EAPI 2 documentation for customization of output file names in SRC_URI
X-Git-Tag: v2.2_rc9~33
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=d8f1f4f77be4b03079854e427b822eeaa8be55d2;p=portage.git

Add EAPI 2 documentation for customization of output file names in SRC_URI
(bug #177863).

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

diff --git a/doc/package/ebuild/eapi/2.docbook b/doc/package/ebuild/eapi/2.docbook
index dff81cc3d..2f0ca533e 100644
--- a/doc/package/ebuild/eapi/2.docbook
+++ b/doc/package/ebuild/eapi/2.docbook
@@ -405,6 +405,20 @@ src_compile() {
 	</section>
 	</section>
 	</section>
+	<section id='package-ebuild-eapi-2-draft-metadata-src-uri'>
+		<title>SRC_URI</title>
+		<section id='package-ebuild-eapi-2-draft-metadata-src-uri-output-file-name-customization'>
+			<title>Customization of Output File Names</title>
+			<para>
+			A new syntax is supported which allows customization of the output
+			file name for a given URI. In order to customize the output file
+			name, a given URI should be followed by a "->" operator which,
+			in turn, should be followed by the desired output file name. As
+			usual, all tokens, including the operator and output file name,
+			should be separated by whitespace.
+			</para>
+		</section>
+	</section>
 	</section>
 	<section id='package-ebuild-eapi-2-draft-phases'>
 		<title>Phases</title>