From owner-freebsd-doc@FreeBSD.ORG Sun Jan 5 21:20:00 2014 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 7B114257 for ; Sun, 5 Jan 2014 21:20:00 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 5734514E8 for ; Sun, 5 Jan 2014 21:20:00 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id s05LK0KM032019 for ; Sun, 5 Jan 2014 21:20:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id s05LK0s7032018; Sun, 5 Jan 2014 21:20:00 GMT (envelope-from gnats) Resent-Date: Sun, 5 Jan 2014 21:20:00 GMT Resent-Message-Id: <201401052120.s05LK0s7032018@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Jason Helfman Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 96AA9227; Sun, 5 Jan 2014 21:19:13 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 69F7B14E0; Sun, 5 Jan 2014 21:19:13 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id s05LJDtr031951; Sun, 5 Jan 2014 21:19:13 GMT (envelope-from jgh@freefall.freebsd.org) Received: (from jgh@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id s05LJDc5031950; Sun, 5 Jan 2014 21:19:13 GMT (envelope-from jgh) Message-Id: <201401052119.s05LJDc5031950@freefall.freebsd.org> Date: Sun, 5 Jan 2014 21:19:13 GMT From: Jason Helfman To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.114 Subject: docs/185521: books/porters-handbook: update parallel building section Cc: brd@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list Reply-To: Jason Helfman List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 05 Jan 2014 21:20:00 -0000 >Number: 185521 >Category: docs >Synopsis: books/porters-handbook: update parallel building section >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Sun Jan 05 21:20:00 UTC 2014 >Closed-Date: >Last-Modified: >Originator: Jason Helfman >Release: FreeBSD 11.0-CURRENT amd64 >Organization: >Environment: System: FreeBSD freefall.freebsd.org 11.0-CURRENT FreeBSD 11.0-CURRENT #0 r259961: Fri Dec 27 21:56:39 UTC 2013 peter@freefall.freebsd.org:/usr/obj/usr/src/sys/FREEFALL amd64 >Description: MAKE_JOBS_SAFE is now the default. >How-To-Repeat: >Fix: Index: en_US.ISO8859-1/books/porters-handbook/book.xml =================================================================== --- en_US.ISO8859-1/books/porters-handbook/book.xml (revision 43434) +++ en_US.ISO8859-1/books/porters-handbook/book.xml (working copy) @@ -5624,21 +5624,13 @@ builds to be faster and more effective. This is achieved by passing -jX flag - to &man.make.1; running on vendor code. Unfortunately, not - all ports handle parallel building well. Therefore it is - required to explicitly enable this feature by adding - MAKE_JOBS_SAFE=yes somewhere below the - dependency declaration section of the - Makefile. - - Another option for controlling this feature from the - maintainer's point of view is the - MAKE_JOBS_UNSAFE=yes variable. It is - used when a port is known to be broken with - -jX and a user forces the use of multi - processor compilations for all ports in - /etc/make.conf with the - FORCE_MAKE_JOBS=yes variable. + to &man.make.1; running on vendor code. This is the default + build behavior of ports. Unfortunately, not all ports handle + parallel building well and it may be required to explicitly + disable this feature by adding the + MAKE_JOBS_UNSAFE=yes variable. It is used + when a port is known to be broken with + -jX. >Release-Note: >Audit-Trail: >Unformatted: