[gentoo-commits] proj/devmanual:master commit in: ebuild-writing/eapi/

[Sam James]

commit:     9db2bfb9151258ce62a1854774a6d3bf60734af2
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Mon Jan 10 01:25:20 2022 +0000
Commit:     Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Tue Feb 22 07:11:27 2022 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=9db2bfb9

ebuild-writing/eapi: mention blocker retention period

Bug: https://bugs.gentoo.org/821553
Signed-off-by: Sam James <sam <AT> gentoo.org>
Closes: https://github.com/gentoo/devmanual/pull/261
Signed-off-by: Sam James <sam <AT> gentoo.org>

 ebuild-writing/eapi/text.xml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/ebuild-writing/eapi/text.xml b/ebuild-writing/eapi/text.xml
index 257232c..fbf88a5 100644
--- a/ebuild-writing/eapi/text.xml
+++ b/ebuild-writing/eapi/text.xml
@@ -83,6 +83,15 @@ governing their use of newer EAPIs, as does the
 <uri link="https://dev.gentoo.org/~mgorny/python-guide/package-maintenance.html#porting-packages-to-a-new-eapi">Python project</uri>.
 </p>
 
+<p>
+It is also convention that blockers within ebuilds are retained for at least
+2 years after the last ebuild matching the block is removed from the tree to
+avoid file collisions for users upgrading older systems. <c>pkgcheck</c> has
+a warning for this called <c>OutdatedBlocker</c> (or even
+<c>NonexistentBlocker</c> for when the match is from pre-git times if using
+a non-grafted repository).
+</p>
+
 </body>
 </subsection>
 </section>