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>
