From owner-freebsd-ports-bugs@FreeBSD.ORG  Mon Nov 21 17:40:12 2011
Return-Path: <owner-freebsd-ports-bugs@FreeBSD.ORG>
Delivered-To: freebsd-ports-bugs@hub.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 8D231106564A
	for <freebsd-ports-bugs@hub.freebsd.org>;
	Mon, 21 Nov 2011 17:40:12 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
	[IPv6:2001:4f8:fff6::28])
	by mx1.freebsd.org (Postfix) with ESMTP id 7C2108FC1B
	for <freebsd-ports-bugs@hub.freebsd.org>;
	Mon, 21 Nov 2011 17:40:12 +0000 (UTC)
Received: from freefall.freebsd.org (localhost [127.0.0.1])
	by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pALHeC1v018712
	for <freebsd-ports-bugs@freefall.freebsd.org>;
	Mon, 21 Nov 2011 17:40:12 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pALHeCfI018711;
	Mon, 21 Nov 2011 17:40:12 GMT (envelope-from gnats)
Date: Mon, 21 Nov 2011 17:40:12 GMT
Message-Id: <201111211740.pALHeCfI018711@freefall.freebsd.org>
To: freebsd-ports-bugs@FreeBSD.org
From: Steve Kargl <sgk@troutmask.apl.washington.edu>
Cc: 
Subject: Re: ports/162709: DISABLE_MAKE_JOBS should be the default
X-BeenThere: freebsd-ports-bugs@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: Steve Kargl <sgk@troutmask.apl.washington.edu>
List-Id: Ports bug reports <freebsd-ports-bugs.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports-bugs>, 
	<mailto:freebsd-ports-bugs-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-ports-bugs>
List-Post: <mailto:freebsd-ports-bugs@freebsd.org>
List-Help: <mailto:freebsd-ports-bugs-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports-bugs>, 
	<mailto:freebsd-ports-bugs-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 21 Nov 2011 17:40:12 -0000

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

From: Steve Kargl <sgk@troutmask.apl.washington.edu>
To: Sayetsky Anton <vsjcfm@gmail.com>
Cc: bug-followup@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@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