aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGöktürk Yüksek <gokturk@gentoo.org>2019-10-16 16:04:34 -0400
committerGöktürk Yüksek <gokturk@gentoo.org>2019-10-16 16:04:34 -0400
commit10c4cea8a800f9f921ca2dc3f6ea9303eea76861 (patch)
treee8c6c86a6bca9ff3206e71c959af0336e3b6103f /general-concepts/mirrors/text.xml
parentebuild-writing/variables: remove redundant thirdpartymirrors sentence (diff)
downloaddevmanual-10c4cea8a800f9f921ca2dc3f6ea9303eea76861.tar.gz
devmanual-10c4cea8a800f9f921ca2dc3f6ea9303eea76861.tar.bz2
devmanual-10c4cea8a800f9f921ca2dc3f6ea9303eea76861.zip
general-concepts/mirrors: rework the bad upstream distfile renaming example
If a distfile rename is necessary to cope with an upstream updating a versioned distfile in place, suggest the format of '_YYYYMMDD' instead of '.r*'. The rationale is that the '.r*' format may confuse readers with the Gentoo ebuild revision format '-r*', for which there is no necessary correlation. The timestamp format also has the added bonus of quickly being able to tell when the distfile rename took place, assuming the developer used the proper date for it. Signed-off-by: Göktürk Yüksek <gokturk@gentoo.org>
Diffstat (limited to 'general-concepts/mirrors/text.xml')
-rw-r--r--general-concepts/mirrors/text.xml4
1 files changed, 2 insertions, 2 deletions
diff --git a/general-concepts/mirrors/text.xml b/general-concepts/mirrors/text.xml
index 42fef3f..11dd040 100644
--- a/general-concepts/mirrors/text.xml
+++ b/general-concepts/mirrors/text.xml
@@ -56,8 +56,8 @@ is necessary, please use <c>SRC_URI</c> arrow to rename the file. For example:
</p>
<codesample lang="ebuild">
-# upstream updated the distfile in place, so make it .r1
-SRC_URI="https://example.com/badupstream/${P}.tar.gz -> ${P}.r1.tar.gz"
+# upstream updated the distfile in place, so suffix it with _YYYYMMDD
+SRC_URI="https://example.com/badupstream/${P}.tar.gz -> ${P}_20191016.tar.gz"
</codesample>
<p>