Is the following paragraph from man 5 make.conf up to date? 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 CPUs+1 and 2*CPUs+1. In order to avoid excess load, the --load-average option is recommended. For more information, see make(1). Also see emerge(1) for information about analogous --jobs and --load-average options. It would be nice if there could be a hint about lowering the number of threads if there are out of memory problems, e.g.: If you experience out of memory problems when running emerge, lower the number of threads in make.conf or on a per package base in package.env . Most packages will be merged without memory problems if you limit the thread count to RAM/2GB. See also: http://wiki.gentoo.org/wiki/Knowledge_Base:Emerge_out_of_memory
Yeah, this is inconsistent with modern advice, which is: jobs=min(RAM/2GB, threads) ... given modern compiler (often C++) jobs can take up to 2GB per job.
The bug has been referenced in the following commit(s): http://gitweb.gentoo.org/proj/portage.git/commit/?id=79a7fea7d32c924d290569c0d9efbc377eb87749 commit 79a7fea7d32c924d290569c0d9efbc377eb87749 Author: Sam James <sam@gentoo.org> AuthorDate: 2023-10-06 01:30:04 +0000 Commit: Sam James <sam@gentoo.org> CommitDate: 2023-10-06 01:30:04 +0000 make.conf(5): update MAKEOPTS guidance We recommend min(RAM/2GB, threads) nowadays because C++ projects may need up to 2GB per job. Bug: http://bugs.gentoo.org/821529 Signed-off-by: Sam James <sam@gentoo.org> man/make.conf.5 | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-)
The bug has been closed via the following commit(s): http://gitweb.gentoo.org/repo/gentoo.git/commit/?id=3500483f75789c36e379c1b6546a09df7c11e2b1 commit 3500483f75789c36e379c1b6546a09df7c11e2b1 Author: Sam James <sam@gentoo.org> AuthorDate: 2023-10-20 00:49:33 +0000 Commit: Sam James <sam@gentoo.org> CommitDate: 2023-10-20 00:51:00 +0000 sys-apps/portage: add 3.0.53 Closes: http://bugs.gentoo.org/915120 Closes: http://bugs.gentoo.org/821529 Closes: http://bugs.gentoo.org/914441 Closes: http://bugs.gentoo.org/914722 Closes: http://bugs.gentoo.org/914873 Closes: http://bugs.gentoo.org/915099 Closes: http://bugs.gentoo.org/915123 Closes: http://bugs.gentoo.org/915128 Closes: http://bugs.gentoo.org/915136 Closes: http://bugs.gentoo.org/915330 Closes: http://bugs.gentoo.org/915494 Closes: http://bugs.gentoo.org/915834 Closes: http://bugs.gentoo.org/915903 Closes: http://bugs.gentoo.org/900224 Signed-off-by: Sam James <sam@gentoo.org> sys-apps/portage/Manifest | 1 + sys-apps/portage/portage-3.0.53.ebuild | 238 +++++++++++++++++++++++++++++++++ 2 files changed, 239 insertions(+)