commit: 10c4cea8a800f9f921ca2dc3f6ea9303eea76861 Author: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org> AuthorDate: Wed Oct 16 20:04:34 2019 +0000 Commit: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org> CommitDate: Wed Oct 16 20:04:34 2019 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=10c4cea8
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 <AT> gentoo.org> general-concepts/mirrors/text.xml | 4 ++-- 1 file 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>
