From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <gentoo-commits+bounces-1369750-garchives=archives.gentoo.org@lists.gentoo.org>
Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (2048 bits))
(No client certificate requested)
by finch.gentoo.org (Postfix) with ESMTPS id 8E0E315808B
for <garchives@archives.gentoo.org>; Mon, 21 Feb 2022 05:22:05 +0000 (UTC)
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
by pigeon.gentoo.org (Postfix) with SMTP id 5AC43E095C;
Mon, 21 Feb 2022 05:22:04 +0000 (UTC)
Received: from smtp.gentoo.org (mail.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256)
(No client certificate requested)
by pigeon.gentoo.org (Postfix) with ESMTPS id 44EA4E095C
for <gentoo-commits@lists.gentoo.org>; Mon, 21 Feb 2022 05:22:04 +0000 (UTC)
Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256)
(No client certificate requested)
by smtp.gentoo.org (Postfix) with ESMTPS id 5DB2B343752
for <gentoo-commits@lists.gentoo.org>; Mon, 21 Feb 2022 05:22:03 +0000 (UTC)
Received: from localhost.localdomain (localhost [IPv6:::1])
by oystercatcher.gentoo.org (Postfix) with ESMTP id CF83C2DC
for <gentoo-commits@lists.gentoo.org>; Mon, 21 Feb 2022 05:22:01 +0000 (UTC)
From: "Sam James" <sam@gentoo.org>
To: gentoo-commits@lists.gentoo.org
Content-Transfer-Encoding: 8bit
Content-type: text/plain; charset=UTF-8
Reply-To: gentoo-dev@lists.gentoo.org, "Sam James" <sam@gentoo.org>
Message-ID: <1645420904.5ef9e1d93aad7538c0c30cd076e956c2947ef4d8.sam@gentoo>
Subject: [gentoo-commits] proj/devmanual:master commit in: general-concepts/dependencies/
X-VCS-Repository: proj/devmanual
X-VCS-Files: general-concepts/dependencies/text.xml
X-VCS-Directories: general-concepts/dependencies/
X-VCS-Committer: sam
X-VCS-Committer-Name: Sam James
X-VCS-Revision: 5ef9e1d93aad7538c0c30cd076e956c2947ef4d8
X-VCS-Branch: master
Date: Mon, 21 Feb 2022 05:22:01 +0000 (UTC)
Precedence: bulk
List-Post: <mailto:gentoo-commits@lists.gentoo.org>
List-Help: <mailto:gentoo-commits+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-commits+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-commits+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-commits.gentoo.org>
X-BeenThere: gentoo-commits@lists.gentoo.org
X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply
X-Archives-Salt: 71e41c95-102b-416c-b1ac-2961449a1585
X-Archives-Hash: abde7d1ec2c3638ca0d6607614aa392a
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