commit: c47bae818f63867150e6893232e289f242eb9622 Author: Sam James <sam <AT> gentoo <DOT> org> AuthorDate: Sun Oct 3 02:09:39 2021 +0000 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> CommitDate: Wed Oct 13 13:39:14 2021 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=c47bae81
general-concepts/dependencies: clarify strong blocker usage Noticed we could be a bit clearer in the devmanual after a discussion on a PR [0]. We've had a lot of confusion over when it's appropriate to use strong blockers, so I think giving a non-abstract "example" is helpful here. [0] https://github.com/gentoo/gentoo/pull/22433#discussion_r720746670 Signed-off-by: Sam James <sam <AT> gentoo.org> Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org> general-concepts/dependencies/text.xml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/general-concepts/dependencies/text.xml b/general-concepts/dependencies/text.xml index c175cfa..1340b1c 100644 --- a/general-concepts/dependencies/text.xml +++ b/general-concepts/dependencies/text.xml @@ -305,6 +305,12 @@ the package from source, and may not apply once the package is installed or when it is installed from a binary package. </p> +<p> +The most common use for strong blockers is where another package simply +being installed causes a build failure. Strong blockers are not to be used +to prevent just file collisions. +</p> + <note> If both weak and strong blockers match a given package, the strong blocker takes precedence.