aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMike Frysinger <vapier@gentoo.org>2015-08-07 01:08:38 -0400
committerMike Frysinger <vapier@gentoo.org>2015-08-07 01:08:38 -0400
commitfc94b7c5ee7672096abbfead15f956b887c6d5ba (patch)
treed4a2c40caaa80c9eeb52c121e569bdd41a1ec49f /ebuild-writing
parentUpdate favicon.ico url from http to https. (diff)
downloaddevmanual-fc94b7c5ee7672096abbfead15f956b887c6d5ba.tar.gz
devmanual-fc94b7c5ee7672096abbfead15f956b887c6d5ba.tar.bz2
devmanual-fc94b7c5ee7672096abbfead15f956b887c6d5ba.zip
variables: SRC_URI: document the -> syntax
Diffstat (limited to 'ebuild-writing')
-rw-r--r--ebuild-writing/variables/text.xml24
1 files changed, 24 insertions, 0 deletions
diff --git a/ebuild-writing/variables/text.xml b/ebuild-writing/variables/text.xml
index a31baa2..fd749c0 100644
--- a/ebuild-writing/variables/text.xml
+++ b/ebuild-writing/variables/text.xml
@@ -323,6 +323,30 @@ SRC_URI="http://example.com/files/${P}-core.tar.bz2
</body>
</subsection>
+
+<subsection>
+<title>Renaming Sources</title>
+<body>
+
+<p>
+Sometimes the upstream URI uses generic names that can easily clash with other
+packages when creating a single mirror. Using the <c>-&gt;</c> syntax allows
+you to rename the file when it's fetched from upstream for storing on mirrors
+and in the local distdir.
+</p>
+
+<p>
+Here we download a file from upstream which has a plain name like
+<c>1.0.tar.gz</c> and save/mirror it with a better name like
+<c>thepackage-1.0.tar.gz</c>.
+</p>
+
+<codesample lang="ebuild">
+SRC_URI="http://example.com/files/${PV}.tar.gz -> ${P}.tar.gz"
+</codesample>
+
+</body>
+</subsection>
</section>
<section>