commit: c02d046fbe5532b57d350231139e702839297100 Author: Zac Medico <zmedico <AT> gentoo <DOT> org> AuthorDate: Sun Nov 9 18:51:47 2025 +0000 Commit: Zac Medico <zmedico <AT> gentoo <DOT> org> CommitDate: Sun Nov 9 18:51:47 2025 +0000 URL: https://gitweb.gentoo.org/proj/portage.git/commit/?id=c02d046f
man: document emerge --implicit-system-deps interactions The --implicit-system-deps=n option prevents the @system set from interacting with merge-wait and parallel-install features. Bug: https://bugs.gentoo.org/681312 Bug: https://bugs.gentoo.org/965819 Signed-off-by: Zac Medico <zmedico <AT> gentoo.org> man/emerge.1 | 6 ++++-- man/make.conf.5 | 20 ++++++++++++-------- 2 files changed, 16 insertions(+), 10 deletions(-) diff --git a/man/emerge.1 b/man/emerge.1 index 03799b6266..cf2a0c2a73 100644 --- a/man/emerge.1 +++ b/man/emerge.1 @@ -1,4 +1,4 @@ -.TH "EMERGE" "1" "Sep 2025" "Portage @VERSION@" "Portage" +.TH "EMERGE" "1" "Nov 2025" "Portage @VERSION@" "Portage" .SH "NAME" emerge \- Command\-line interface to the Portage system .SH "SYNOPSIS" @@ -677,7 +677,9 @@ Assume that packages may have implicit dependencies on packages which belong to the @system set. This option is enabled by default. One of the effects of disabling this option is to allow the \-\-jobs option to spawn jobs without accounting for the possibility of implicit dependencies -on packages that belong to the @system set. +on packages that belong to the @system set. This option interacts with +the \fImerge\-wait\fR and \fIparallel\-install\fR features as discussed +in the \fBmake.conf\fR(5) man page. .TP .BR \-j\ [JOBS] ", " \-\-jobs[=JOBS] Specifies the number of packages to build simultaneously. If this option is diff --git a/man/make.conf.5 b/man/make.conf.5 index 71395e72f2..e45113775b 100644 --- a/man/make.conf.5 +++ b/man/make.conf.5 @@ -1,4 +1,4 @@ -.TH "MAKE.CONF" "5" "Sep 2025" "Portage @VERSION@" "Portage" +.TH "MAKE.CONF" "5" "Nov 2025" "Portage @VERSION@" "Portage" .SH "NAME" make.conf \- custom settings for Portage .SH "SYNOPSIS" @@ -591,12 +591,13 @@ This feature is enabled by default. .TP .B merge\-wait Wait for all builds to complete before merging new packages, which only -matters when using the \fBemerge\fR(1) \fB\-\-jobs\fR option. This -feature is always effectively enabled and it cannot be disabled for -packages that satisfy direct or indirect dependencies of the system -set. For other packages, it can be disabled in order to trade the -possibility of random build failures for greater parallelism. The queue -can be flushed by ending the SIGUSR2 signal to \fBemerge\fR(1). +matters when using the \fBemerge\fR(1) \fB\-\-jobs\fR option. Unless the +\fBemerge\fR(1) \fB\-\-implicit\-system\-deps=n\fR option is used, +\fImerge\-wait\fR is always effectively enabled for packages that satisfy +direct or indirect dependencies of the system set. The \fImerge\-wait\fR +feature can be disabled in order to trade the possibility of random build +failures for greater parallelism. +The queue can be flushed by sending the SIGUSR2 signal to \fBemerge\fR(1). This feature is enabled by default. .TP .B metadata\-transfer @@ -676,7 +677,10 @@ Also disable \fImerge\-wait\fR for additional parallelism if desired, but that increases the possibility of random build failures. When \fIparallel\-install\fR is used together with \fImerge\-wait\fR, parallel installation occurs in batches when there are no builds -running. +running. Unless the \fBemerge\fR(1) \fB\-\-implicit\-system\-deps=n\fR +option is used, \fIparallel\-install\fR is always effectively disabled +for packages that satisfy direct or indirect dependencies of the system +set. .TP .B pid\-sandbox Isolate the process space for the ebuild processes. This makes it
