commit: af8bf2fcb2fbfe68ba71d15bc0a204d51f7b6078
Author: Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Sat Nov 15 12:13:06 2014 +0000
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Sat Nov 15 12:13:06 2014 +0000
URL:
http://sources.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=af8bf2fc
Clarify that PDEPEND may be installed after the package in some cases.
Bug 424117.
---
ebuild-writing/variables/text.xml | 6 +++---
general-concepts/dependencies/text.xml | 10 ++++++----
2 files changed, 9 insertions(+), 7 deletions(-)
diff --git a/ebuild-writing/variables/text.xml
b/ebuild-writing/variables/text.xml
index abe66ce..a31baa2 100644
--- a/ebuild-writing/variables/text.xml
+++ b/ebuild-writing/variables/text.xml
@@ -215,9 +215,9 @@ The following variables may or must be defined by every
ebuild.
<tr>
<ti><c>PDEPEND</c></ti>
<ti>
- A list of packages to be installed after the package
- is merged. Should only be used where <c>RDEPEND</c> is not
- possible. See <uri link="::general-concepts/dependencies"/>.
+ A list of packages to be installed (if possible) after the package
+ is merged. Use this only when <c>RDEPEND</c> would cause cyclic
+ dependencies. See <uri link="::general-concepts/dependencies"/>.
</ti>
</tr>
<tr>
diff --git a/general-concepts/dependencies/text.xml
b/general-concepts/dependencies/text.xml
index dc95e28..24b9902 100644
--- a/general-concepts/dependencies/text.xml
+++ b/general-concepts/dependencies/text.xml
@@ -56,10 +56,12 @@ Items which are in <c>RDEPEND</c> but not <c>DEPEND</c>
could <e>in theory</e> b
<body>
<p>
-The <c>PDEPEND</c> variable specifies dependencies which must be merged
<e>after</e> the
-package. This is sometimes used for plugins which have a dependency upon the
-package being merged. Generally <c>PDEPEND</c> should be avoided in favour of
-<c>RDEPEND</c> except where this will create circular dependency chains.
+The <c>PDEPEND</c> variable specifies dependencies that should be
+merged <e>after</e> 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
+<c>PDEPEND</c> should be avoided in favour of <c>RDEPEND</c> except
+where this will create circular dependency chains.
</p>
</body>
