Better documentation of PDEPEND in ebuild(5)

diff --git a/man/ebuild.5 b/man/ebuild.5
index dbd024ceaf66d7a68e81bc16f0e240a62b627ee2..0d4d4e53831b49b6196624a6fac27c58fc4fb485 100644 (file)
--- a/man/ebuild.5
+++ b/man/ebuild.5
@@ -555,8 +555,13 @@ or earlier, then it defaults to the value of \fBDEPEND\fR. In
 You may use the same syntax to vary dependencies as seen above in \fBDependencies\fR.
 .TP
 .B PDEPEND
-This should contain a list of all packages that should be merged after this one,
-but may be merged before if need be.
+This should contain a list of all packages that should be merged after this
+one, but which may be installed by the package manager at any time, if that is
+not possible.
+
+.B ***WARNING***
+.br
+Use this only as last resort to break cyclic dependencies!
 
 You may use the same syntax to vary dependencies as seen above in \fBDependencies\fR.
 .TP