| 1 |
commit: 5ef9e1d93aad7538c0c30cd076e956c2947ef4d8 |
| 2 |
Author: Florian Schmaus <flow <AT> gentoo <DOT> org> |
| 3 |
AuthorDate: Thu Dec 23 19:17:28 2021 +0000 |
| 4 |
Commit: Sam James <sam <AT> gentoo <DOT> org> |
| 5 |
CommitDate: Mon Feb 21 05:21:44 2022 +0000 |
| 6 |
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=5ef9e1d9 |
| 7 |
|
| 8 |
general-concepts/dependencies: improve explaination of slot operators |
| 9 |
|
| 10 |
The section previously had hard to parse sentences like "[…] and that |
| 11 |
your package should be rebuilt if the version best matching the |
| 12 |
runtime dependency is updated to a version with a different slot or |
| 13 |
subslot" for the := operator. |
| 14 |
|
| 15 |
This commit attempts to improve the readability of the section. |
| 16 |
|
| 17 |
The change superseeds my proposed change in bug #739858. |
| 18 |
|
| 19 |
Thanks to Sam James for reviewing this. :) |
| 20 |
|
| 21 |
Signed-off-by: Florian Schmaus <flow <AT> gentoo.org> |
| 22 |
Bug: https://bugs.gentoo.org/739858 |
| 23 |
Closes: https://github.com/gentoo/devmanual/pull/259 |
| 24 |
Signed-off-by: Sam James <sam <AT> gentoo.org> |
| 25 |
|
| 26 |
general-concepts/dependencies/text.xml | 17 +++++++++-------- |
| 27 |
1 file changed, 9 insertions(+), 8 deletions(-) |
| 28 |
|
| 29 |
diff --git a/general-concepts/dependencies/text.xml b/general-concepts/dependencies/text.xml |
| 30 |
index 1abebc8..ef27ac2 100644 |
| 31 |
--- a/general-concepts/dependencies/text.xml |
| 32 |
+++ b/general-concepts/dependencies/text.xml |
| 33 |
@@ -387,18 +387,19 @@ or <uri link="::general-concepts/slotting#Sub-Slots">sub-slot</uri>: |
| 34 |
|
| 35 |
<ul> |
| 36 |
<li> |
| 37 |
- <c>:=</c> means that any slot is acceptable, and that your package should be |
| 38 |
- rebuilt if the version best matching the runtime dependency is updated to a |
| 39 |
- version with a different slot or subslot; |
| 40 |
+ <c>:=</c> means that any slot is acceptable. Additionally indicates that |
| 41 |
+ your package should be rebuilt if the version best matching the runtime |
| 42 |
+ dependency is updated to a version with a different slot or subslot. |
| 43 |
</li> |
| 44 |
<li> |
| 45 |
- <c>:*</c> means that any slot is acceptable, and explicitly declares that |
| 46 |
- changes in the slot or sub-slot can be ignored; |
| 47 |
+ <c>:*</c> means that any slot is acceptable. Furthermore, this slot |
| 48 |
+ operator explicitly declares that changes in the slot or sub-slot can be |
| 49 |
+ ignored. |
| 50 |
</li> |
| 51 |
<li> |
| 52 |
- <c>:SLOT=</c> means that only the 'SLOT' slot is acceptable, and that your |
| 53 |
- package should be rebuilt if the version matching the runtime dependency is |
| 54 |
- updated to another version with this slot but with a different subslot; |
| 55 |
+ <c>:SLOT=</c> means that only the 'SLOT' slot is acceptable. It otherwise |
| 56 |
+ behaves identically to the <c>:=</c> operator. That is, the package must be |
| 57 |
+ rebuilt if the sub-slot of the dependency changes. |
| 58 |
</li> |
| 59 |
<li> |
| 60 |
<c>:SLOT</c> means that only the 'SLOT' slot is acceptable, and that changes |
Archives