Gentoo Archives: gentoo-commits

From: "Ulrich Müller" <ulm@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] proj/devmanual:master commit in: general-concepts/dependencies/
Date: Wed, 29 Jan 2020 08:00:00
Message-Id: 1580284706.be7ec7f3d2965719ffb69879bd879fc9b48c6dc1.ulm@gentoo
1 commit: be7ec7f3d2965719ffb69879bd879fc9b48c6dc1
2 Author: Michał Górny <mgorny <AT> gentoo <DOT> org>
3 AuthorDate: Sun Dec 29 08:03:11 2019 +0000
4 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
5 CommitDate: Wed Jan 29 07:58:26 2020 +0000
6 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=be7ec7f3
7
8 general-concepts/dependencies: Improve PDEPEND
9
10 Rewrite the PDEPEND description to be more focused on its purpose.
11 Rename to 'Post Dependencies' to match PMS. Reverse the weird backwards
12 logic that indicated that they might be installed before the package
13 into saying that they may be installed after it. Clearly indicate
14 that its only purpose is to resolve circular dependencies.
15
16 Signed-off-by: Michał Górny <mgorny <AT> gentoo.org>
17 Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>
18
19 general-concepts/dependencies/text.xml | 12 +++++-------
20 1 file changed, 5 insertions(+), 7 deletions(-)
21
22 diff --git a/general-concepts/dependencies/text.xml b/general-concepts/dependencies/text.xml
23 index 8deca1f..dde6cda 100644
24 --- a/general-concepts/dependencies/text.xml
25 +++ b/general-concepts/dependencies/text.xml
26 @@ -94,16 +94,14 @@ Items which are in <c>RDEPEND</c> but not <c>DEPEND</c> could <e>in theory</e> b
27 </section>
28
29 <section>
30 -<title>Post-Merge Dependencies</title>
31 +<title>Post Dependencies</title>
32 <body>
33
34 <p>
35 -The <c>PDEPEND</c> variable specifies dependencies that should be
36 -merged <e>after</e> the package, but which may be merged at any time,
37 -if the former is not possible. This is sometimes used for plugins
38 -that have a dependency upon the package being merged. Generally
39 -<c>PDEPEND</c> should be avoided in favour of <c>RDEPEND</c> except
40 -where this will create circular dependency chains.
41 +The <c>PDEPEND</c> variable specifies runtime dependencies that do not strictly
42 +require being satisfied immediately. They can be merged <e>after</e>
43 +the package. This variable is used purely to resolve circular dependencies,
44 +while in general case <c>RDEPEND</c> should be used instead.
45 </p>
46
47 </body>