aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSam James <sam@gentoo.org>2023-10-06 02:30:04 +0100
committerSam James <sam@gentoo.org>2023-10-06 02:30:04 +0100
commit79a7fea7d32c924d290569c0d9efbc377eb87749 (patch)
treea34868384ae7d09690ca827f3822b5fbbb22d379 /man/make.conf.5
parentAsyncioEventLoop: Put back _ChildWatcherThreadSafetyWrapper (diff)
downloadportage-79a7fea7d32c924d290569c0d9efbc377eb87749.tar.gz
portage-79a7fea7d32c924d290569c0d9efbc377eb87749.tar.bz2
portage-79a7fea7d32c924d290569c0d9efbc377eb87749.zip
make.conf(5): update MAKEOPTS guidance
We recommend min(RAM/2GB, threads) nowadays because C++ projects may need up to 2GB per job. Bug: https://bugs.gentoo.org/821529 Signed-off-by: Sam James <sam@gentoo.org>
Diffstat (limited to 'man/make.conf.5')
-rw-r--r--man/make.conf.57
1 files changed, 4 insertions, 3 deletions
diff --git a/man/make.conf.5 b/man/make.conf.5
index 8f6c444ba..762de83c4 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -928,9 +928,10 @@ enabled for these flags may be closed as INVALID.
.B MAKEOPTS
Use this variable if you want to use parallel make. For example, if you
have a dual\-processor system, set this variable to "\-j2" or "\-j3" for
-enhanced build performance with many packages. Suggested settings are
-between \fICPUs+1\fR and \fI2*CPUs+1\fR. In order to avoid
-excess load, the \fB\-\-load\-average\fR option is recommended.
+enhanced build performance with many packages. It is suggested that the jobs
+value used be the minimum of: available RAM divided by 2GB, or the number of
+threads on the system. In order to avoid excess load, the
+\fB\-\-load\-average\fR option is recommended.
For more information, see \fBmake\fR(1). Also see \fBemerge\fR(1) for
information about analogous \fB\-\-jobs\fR and \fB\-\-load\-average\fR options.
Defaults to the number of processors if left unset.