aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSam James <sam@gentoo.org>2021-10-03 03:09:39 +0100
committerUlrich Müller <ulm@gentoo.org>2021-10-13 15:39:14 +0200
commitc47bae818f63867150e6893232e289f242eb9622 (patch)
treea102aa7fe69d169556b3f562312e50997eddae57 /general-concepts/dependencies/text.xml
parent.github/workflows/devmanual-ci.yml: Add license notice (diff)
downloaddevmanual-c47bae818f63867150e6893232e289f242eb9622.tar.gz
devmanual-c47bae818f63867150e6893232e289f242eb9622.tar.bz2
devmanual-c47bae818f63867150e6893232e289f242eb9622.zip
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@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
Diffstat (limited to 'general-concepts/dependencies/text.xml')
-rw-r--r--general-concepts/dependencies/text.xml6
1 files changed, 6 insertions, 0 deletions
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.