commit:     988392156daae34427906e98609d1dd1fe4970a5
Author:     Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
AuthorDate: Wed Oct 16 20:12:24 2019 +0000
Commit:     Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Tue Oct 29 20:46:07 2019 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=98839215

general-concepts/mirrors: improve bad upstream distfile rename text

If an upstream updates a distfile in a way that requires an ebuild
revision bump, remind readers to remove the ebuilds associated with
the old distfile. This is necessary because the Manifest entry for the
old tarball has its checksum changed due to upstream and cause
checksum mismatches during merges.

Closes: https://github.com/gentoo/devmanual.gentoo.org/pull/112
Signed-off-by: Göktürk Yüksek <gokturk <AT> gentoo.org>

 general-concepts/mirrors/text.xml | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/general-concepts/mirrors/text.xml 
b/general-concepts/mirrors/text.xml
index f5553fa..703b705 100644
--- a/general-concepts/mirrors/text.xml
+++ b/general-concepts/mirrors/text.xml
@@ -66,8 +66,13 @@ fetch and start distributing the new version.
 </p>
 
 <p>
-Please note that if upstream made any changes affecting the built package,
-you need to also bump the ebuild's revision.
+Please note that if upstream made any changes affecting the built
+package, you need to also bump the ebuild's revision. Finally,
+remember to remove the ebuilds that are associated with the old
+distfile, or regenerate their checksums in <c>Manifest</c>, if there
+are any. This is necessary because these ebuilds will cause checksum
+mismatch errors as the checksum recorded in the Manifest file no
+longer matches the computed checksum of the fetched distfile.
 </p>
 
 <p>

Reply via email to