From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id 32EAB13888F for ; Tue, 20 Oct 2015 19:30:20 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 6567E21C018; Tue, 20 Oct 2015 19:30:18 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id ECDF321C012 for ; Tue, 20 Oct 2015 19:30:16 +0000 (UTC) Received: from localhost.localdomain (unknown [100.42.98.196]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: zmedico) by smtp.gentoo.org (Postfix) with ESMTPSA id CC703340564; Tue, 20 Oct 2015 19:30:13 +0000 (UTC) From: Zac Medico To: gentoo-portage-dev@lists.gentoo.org Cc: Zac Medico Subject: [gentoo-portage-dev] [PATCH] emerge(1): document --oneshot caveats (bug 563482) Date: Tue, 20 Oct 2015 12:29:54 -0700 Message-Id: <1445369394-24758-1-git-send-email-zmedico@gentoo.org> X-Mailer: git-send-email 2.4.9 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-portage-dev@lists.gentoo.org Reply-to: gentoo-portage-dev@lists.gentoo.org X-Archives-Salt: d317f073-e41a-4660-81d4-59c23eb4c034 X-Archives-Hash: 8b9b505dd5d7620f4703a8dc34764a56 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