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