commit:     79a7fea7d32c924d290569c0d9efbc377eb87749
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Fri Oct  6 01:30:04 2023 +0000
Commit:     Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Fri Oct  6 01:30:04 2023 +0000
URL:        https://gitweb.gentoo.org/proj/portage.git/commit/?id=79a7fea7

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 <AT> gentoo.org>

 man/make.conf.5 | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/man/make.conf.5 b/man/make.conf.5
index 8f6c444ba1..762de83c4a 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.

Reply via email to