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 6F81C15808B for ; Sat, 28 Sep 2024 19:36:54 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id B1148E2A5B; Sat, 28 Sep 2024 19:36:53 +0000 (UTC) Received: from smtp.gentoo.org (smtp.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)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 95452E2A5B for ; Sat, 28 Sep 2024 19:36:53 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id D646A343150 for ; Sat, 28 Sep 2024 19:36:52 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 4F1B8ACC for ; Sat, 28 Sep 2024 19:36:51 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1727552167.1f4eb2b2cb996e95f5fb1f09ee912082c8957fea.ulm@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: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 1f4eb2b2cb996e95f5fb1f09ee912082c8957fea X-VCS-Branch: master Date: Sat, 28 Sep 2024 19:36:51 +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: a07f1dd0-d41f-4173-9880-fa847530580d X-Archives-Hash: f0d2f444ca14b289512bb09932f30cdc commit: 1f4eb2b2cb996e95f5fb1f09ee912082c8957fea Author: Andrei Horodniceanu proton me> AuthorDate: Thu Sep 26 09:08:38 2024 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Sat Sep 28 19:36:07 2024 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=1f4eb2b2 g-c/dependencies: Clarify the stance on circular dependencies I had a package that needed changes that would introduce a dependency cycle with USE=test and I had to ask on IRC whether this was OK. Sam told me not to worry about it and recommended that the devmanual should note this. So, add a paragraph that discourages dependency cycles but expresses that cycles provoked by USE=test can usually be ignored. Signed-off-by: Andrei Horodniceanu proton.me> Signed-off-by: Ulrich Müller gentoo.org> general-concepts/dependencies/text.xml | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/general-concepts/dependencies/text.xml b/general-concepts/dependencies/text.xml index 6c3207d..407e4c4 100644 --- a/general-concepts/dependencies/text.xml +++ b/general-concepts/dependencies/text.xml @@ -821,6 +821,14 @@ There are three kinds of circular dependencies: +

+While circular dependencies should be avoided, an exception can be made for +test-only dependencies. Similar to the example above with the tests of +dev-python/setuptools, if a package needs itself, directly or +indirectly, in order to run its tests, it is usually fine to leave it +as-is. You should fix it if you can but don't go to extensive lengths for it. +

+