[gentoo-commits] proj/devmanual:master commit in: general-concepts/mirrors/

["Göktürk Yüksek" <gokturk@gentoo.org>]

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>