[gentoo-portage-dev] [PATCH] emerge(1): document --oneshot caveats (bug 563482)

[Zac Medico <zmedico@gentoo.org>]

X-Gentoo-Bug: 563482
X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=563482
---
 man/emerge.1 | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/man/emerge.1 b/man/emerge.1
index 237fb79..c03f044 100644
--- a/man/emerge.1
+++ b/man/emerge.1
@@ -676,6 +676,13 @@ packages that depend on matching packages due to \fB\-\-rebuild\fR.
 .BR "\-\-oneshot " (\fB\-1\fR)
 Emerge as normal, but do not add the packages to the world file
 for later updating.
+
+\fBWARNING:\fR This option should only be used for packages that are
+reachable from the @world package set (those that would not be removed
+by \fB\-\-depclean\fR), since dependencies of unreachable packages are
+allowed to be broken when satisfying dependencies of other packages.
+Broken dependencies of this sort will invalidate assumptions that make
+it possible for \fB\-\-deep\fR to be disabled by default.
 .TP
 .BR "\-\-onlydeps " (\fB\-o\fR)
 Only merge (or pretend to merge) the dependencies of the packages
-- 
2.4.9