aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFlorian Schmaus <flow@gentoo.org>2021-12-23 20:17:28 +0100
committerSam James <sam@gentoo.org>2022-02-21 05:21:44 +0000
commit5ef9e1d93aad7538c0c30cd076e956c2947ef4d8 (patch)
tree8867be4650e40ad0ce28bad66b33e72055675fc9 /general-concepts/dependencies/text.xml
parentgeneral-concepts/dependencies: indent xml for better raw readability (diff)
downloaddevmanual-5ef9e1d93aad7538c0c30cd076e956c2947ef4d8.tar.gz
devmanual-5ef9e1d93aad7538c0c30cd076e956c2947ef4d8.tar.bz2
devmanual-5ef9e1d93aad7538c0c30cd076e956c2947ef4d8.zip
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@gentoo.org> Bug: https://bugs.gentoo.org/739858 Closes: https://github.com/gentoo/devmanual/pull/259 Signed-off-by: Sam James <sam@gentoo.org>
Diffstat (limited to 'general-concepts/dependencies/text.xml')
-rw-r--r--general-concepts/dependencies/text.xml17
1 files 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