From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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 ; 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 ; 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 ; 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 ; Mon, 21 Feb 2022 05:22:01 +0000 (UTC) From: "Sam James" 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" 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: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail 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 gentoo org> AuthorDate: Thu Dec 23 19:17:28 2021 +0000 Commit: Sam James gentoo 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 gentoo.org> Bug: https://bugs.gentoo.org/739858 Closes: https://github.com/gentoo/devmanual/pull/259 Signed-off-by: Sam James 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 sub-slot:
  • - := 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; + := 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.
  • - :* means that any slot is acceptable, and explicitly declares that - changes in the slot or sub-slot can be ignored; + :* means that any slot is acceptable. Furthermore, this slot + operator explicitly declares that changes in the slot or sub-slot can be + ignored.
  • - :SLOT= 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; + :SLOT= means that only the 'SLOT' slot is acceptable. It otherwise + behaves identically to the := operator. That is, the package must be + rebuilt if the sub-slot of the dependency changes.
  • :SLOT means that only the 'SLOT' slot is acceptable, and that changes