[gentoo-commits] proj/devmanual:master commit in: general-concepts/dependencies/

["Sam James" <sam@gentoo.org>]

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