Thanks for the suggestion.

What machine are you using? Does the build take longer withmake -j thanmake -j4, or otherwise slow the machine down? "consumes too many resources" - in what way?

On macOS with 8 CPUs,make -j uses them all and I don't notice any other slowdown. Having said that, it takes about the same time to run asmake -j4, around 32s.

Hi@hugovk.

It's not so much related to my machine in particular. It's just that once all the CPU cores are used for compiling, adding more jobs generally do not improve the performance and rather tend to make it worst because of the overhead of context switches¹. It's not very much noticeable in practice, though²³.

However, what is growing continuously is the RAM consumption. Each started job will consume memory, which causes a noticeable increase in overall RAM usage (finally "wasted" since an infinite number of jobs cannot run in parallel). This is not really desirable, and this is frequently related to out-of-memory problems for a beginner who is not familiar withmake building process⁴.

Also I suggested-j4 but maybe-j2 is preferable as it matches the example given when clicking "more detailed instructions" on the page.

For the test suite, -j starts a number of parallel tests appropriate to the CPU. Since, you say, make -j does not do that, why not recommend -j# where # is appropriate for the machine?

@terryjreedy On the same page, tests are suggested to be run with./python -m test -j3, details about the-j argument are only provided onthe linked page. I suppose it's best to show a simple and functional example by default, and only go into detail on the appropriate page. It's easier to copy and paste. But in the end, it's up to what you prefer.

The following commit authors need to sign the Contributor License Agreement:

• 4193924+Delgan@users.noreply.github.com

Superseeded by either#1541 or#1543 or both.