Gentoo Archives: gentoo-commits

From: "Ulrich Müller" <ulm@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] proj/devmanual:master commit in: general-concepts/dependencies/
Date: Wed, 13 Oct 2021 13:42:10
Message-Id: 1634132354.c47bae818f63867150e6893232e289f242eb9622.ulm@gentoo
1 commit: c47bae818f63867150e6893232e289f242eb9622
2 Author: Sam James <sam <AT> gentoo <DOT> org>
3 AuthorDate: Sun Oct 3 02:09:39 2021 +0000
4 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
5 CommitDate: Wed Oct 13 13:39:14 2021 +0000
6 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=c47bae81
7
8 general-concepts/dependencies: clarify strong blocker usage
9
10 Noticed we could be a bit clearer in the devmanual after
11 a discussion on a PR [0]. We've had a lot of confusion over
12 when it's appropriate to use strong blockers, so I think giving
13 a non-abstract "example" is helpful here.
14
15 [0] https://github.com/gentoo/gentoo/pull/22433#discussion_r720746670
16
17 Signed-off-by: Sam James <sam <AT> gentoo.org>
18 Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>
19
20 general-concepts/dependencies/text.xml | 6 ++++++
21 1 file changed, 6 insertions(+)
22
23 diff --git a/general-concepts/dependencies/text.xml b/general-concepts/dependencies/text.xml
24 index c175cfa..1340b1c 100644
25 --- a/general-concepts/dependencies/text.xml
26 +++ b/general-concepts/dependencies/text.xml
27 @@ -305,6 +305,12 @@ the package from source, and may not apply once the package is installed
28 or when it is installed from a binary package.
29 </p>
30
31 +<p>
32 +The most common use for strong blockers is where another package simply
33 +being installed causes a build failure. Strong blockers are not to be used
34 +to prevent just file collisions.
35 +</p>
36 +
37 <note>
38 If both weak and strong blockers match a given package, the strong blocker
39 takes precedence.