diff options
author | 2019-10-16 16:04:34 -0400 | |
---|---|---|
committer | 2019-10-16 16:04:34 -0400 | |
commit | 10c4cea8a800f9f921ca2dc3f6ea9303eea76861 (patch) | |
tree | e8c6c86a6bca9ff3206e71c959af0336e3b6103f /general-concepts/mirrors/text.xml | |
parent | ebuild-writing/variables: remove redundant thirdpartymirrors sentence (diff) | |
download | devmanual-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.xml | 4 |
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> |