diff options
| author |   Sam James <sam@gentoo.org> | 2022-01-10 01:25:20 +0000 |
|---|---|---|
| committer | Sam James <sam@gentoo.org> | 2022-02-22 07:11:27 +0000 |
| commit | 9db2bfb9151258ce62a1854774a6d3bf60734af2 (patch) | |
| tree | 968d38d1a6a611833ab946916fc47bddfbac674e /ebuild-writing | |
| parent | ebuild-writing/eapi: document upgrade path policy (diff) | |
| download | devmanual-9db2bfb9151258ce62a1854774a6d3bf60734af2.tar.gz devmanual-9db2bfb9151258ce62a1854774a6d3bf60734af2.tar.bz2 devmanual-9db2bfb9151258ce62a1854774a6d3bf60734af2.zip | |
ebuild-writing/eapi: mention blocker retention period
Bug: https://bugs.gentoo.org/821553
Signed-off-by: Sam James <sam@gentoo.org>
Closes: https://github.com/gentoo/devmanual/pull/261
Signed-off-by: Sam James <sam@gentoo.org>
Diffstat (limited to 'ebuild-writing')
| -rw-r--r-- | ebuild-writing/eapi/text.xml | 9 |
1 files changed, 9 insertions, 0 deletions
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> |