ports/162709: DISABLE_MAKE_JOBS should be the default

[Steve Kargl]

The following reply was made to PR ports/162709; it has been noted by GNATS.

From: Steve Kargl <sgk at troutmask.apl.washington.edu>
To: Sayetsky Anton <vsjcfm at gmail.com>
Cc: bug-followup at freebsd.org
Subject: Re: ports/162709: DISABLE_MAKE_JOBS should be the default
Date: Mon, 21 Nov 2011 09:39:45 -0800

 On Mon, Nov 21, 2011 at 07:16:39PM +0200, Sayetsky Anton wrote:
 > 2011/11/21 Steve Kargl <sgk at troutmask.apl.washington.edu>:
 > > Where is MAKE_JOBS_NUMBER documented?
 > http://www.freebsd.org/releases/7.2R/relnotes-detailed.html
 
 That's hardly acceptable documentation (given that
 I'm running FreeBSD-current) ...  
 
 > 2.5 Ports/Packages Collection Infrastructure
 > The FreeBSD Ports Collection now supports multiple make(1) jobs in
 > some supported ports. This is automatically enabled when a port is
 > marked as MAKE_JOBS_SAFE and improves CPU utilization at the build
 > stage by passing an option -jX to the top level Makefile from the
 > vendor.
 
 This last sentence is flat out wrong if the system starts to swap.
 
 > The number X is set to the number of CPUs by default, and can
 > be set by users via a make(1) variable MAKE_JOBS_NUMBER. For more
 > details, see ports/Mk/bsd.port.mk.
 
 .., and bsd.port.mk isn't acceptable documentation either.
 
 troutmask:kargl[204] zgrep JOB /usr/share/man/man7/ports.7.gz
 troutmask:kargl[205] pwd
 /usr/share/doc/en_US.ISO8859-1/books/handbook
 troutmask:kargl[206] grep JOBS *.html
 book.html:<dt><a id="ERESOURCES-CHARTERS-JOBS" name="ERESOURCES-CHARTERS-JOBS"></a><a
 eresources.html:<dt><a id="ERESOURCES-CHARTERS-JOBS" name="ERESOURCES-CHARTERS-JOBS"></a><a
 
 So, all of the JOB knobs are undocumented.
 
 -- 
 Steve