commit: 5ef9e1d93aad7538c0c30cd076e956c2947ef4d8 Author: Florian Schmaus <flow <AT> gentoo <DOT> org> AuthorDate: Thu Dec 23 19:17:28 2021 +0000 Commit: Sam James <sam <AT> gentoo <DOT> org> CommitDate: Mon Feb 21 05:21:44 2022 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=5ef9e1d9
general-concepts/dependencies: improve explaination of slot operators The section previously had hard to parse sentences like "[…] and that your package should be rebuilt if the version best matching the runtime dependency is updated to a version with a different slot or subslot" for the := operator. This commit attempts to improve the readability of the section. The change superseeds my proposed change in bug #739858. Thanks to Sam James for reviewing this. :) Signed-off-by: Florian Schmaus <flow <AT> gentoo.org> Bug: https://bugs.gentoo.org/739858 Closes: https://github.com/gentoo/devmanual/pull/259 Signed-off-by: Sam James <sam <AT> gentoo.org> general-concepts/dependencies/text.xml | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/general-concepts/dependencies/text.xml b/general-concepts/dependencies/text.xml index 1abebc8..ef27ac2 100644 --- a/general-concepts/dependencies/text.xml +++ b/general-concepts/dependencies/text.xml @@ -387,18 +387,19 @@ or <uri link="::general-concepts/slotting#Sub-Slots">sub-slot</uri>: <ul> <li> - <c>:=</c> means that any slot is acceptable, and that your package should be - rebuilt if the version best matching the runtime dependency is updated to a - version with a different slot or subslot; + <c>:=</c> means that any slot is acceptable. Additionally indicates that + your package should be rebuilt if the version best matching the runtime + dependency is updated to a version with a different slot or subslot. </li> <li> - <c>:*</c> means that any slot is acceptable, and explicitly declares that - changes in the slot or sub-slot can be ignored; + <c>:*</c> means that any slot is acceptable. Furthermore, this slot + operator explicitly declares that changes in the slot or sub-slot can be + ignored. </li> <li> - <c>:SLOT=</c> means that only the 'SLOT' slot is acceptable, and that your - package should be rebuilt if the version matching the runtime dependency is - updated to another version with this slot but with a different subslot; + <c>:SLOT=</c> means that only the 'SLOT' slot is acceptable. It otherwise + behaves identically to the <c>:=</c> operator. That is, the package must be + rebuilt if the sub-slot of the dependency changes. </li> <li> <c>:SLOT</c> means that only the 'SLOT' slot is acceptable, and that changes