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.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 844E8138239 for ; Wed, 29 Jan 2020 08:00:00 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 7D411E0866; Wed, 29 Jan 2020 07:59:59 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 61111E0866 for ; Wed, 29 Jan 2020 07:59:59 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 52AD734E4CA for ; Wed, 29 Jan 2020 07:59:58 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 7099AE5 for ; Wed, 29 Jan 2020 07:59:56 +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: <1580284706.be7ec7f3d2965719ffb69879bd879fc9b48c6dc1.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: be7ec7f3d2965719ffb69879bd879fc9b48c6dc1 X-VCS-Branch: master Date: Wed, 29 Jan 2020 07:59:56 +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: 70f05e7f-6631-44e9-aedf-ab16af6bf9c0 X-Archives-Hash: 12d0820c9b100664f6382adc77305594 commit: be7ec7f3d2965719ffb69879bd879fc9b48c6dc1 Author: Michał Górny gentoo org> AuthorDate: Sun Dec 29 08:03:11 2019 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Wed Jan 29 07:58:26 2020 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=be7ec7f3 general-concepts/dependencies: Improve PDEPEND Rewrite the PDEPEND description to be more focused on its purpose. Rename to 'Post Dependencies' to match PMS. Reverse the weird backwards logic that indicated that they might be installed before the package into saying that they may be installed after it. Clearly indicate that its only purpose is to resolve circular dependencies. Signed-off-by: Michał Górny gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> general-concepts/dependencies/text.xml | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/general-concepts/dependencies/text.xml b/general-concepts/dependencies/text.xml index 8deca1f..dde6cda 100644 --- a/general-concepts/dependencies/text.xml +++ b/general-concepts/dependencies/text.xml @@ -94,16 +94,14 @@ Items which are in RDEPEND but not DEPEND could in theory b
-Post-Merge Dependencies +Post Dependencies

-The PDEPEND variable specifies dependencies that should be -merged after the package, but which may be merged at any time, -if the former is not possible. This is sometimes used for plugins -that have a dependency upon the package being merged. Generally -PDEPEND should be avoided in favour of RDEPEND except -where this will create circular dependency chains. +The PDEPEND variable specifies runtime dependencies that do not strictly +require being satisfied immediately. They can be merged after +the package. This variable is used purely to resolve circular dependencies, +while in general case RDEPEND should be used instead.