From owner-svn-doc-all@freebsd.org Mon Oct 29 13:41:01 2018 Return-Path: Delivered-To: svn-doc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 59EC410DA16F; Mon, 29 Oct 2018 13:41:01 +0000 (UTC) (envelope-from 0mp@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id EEBE171986; Mon, 29 Oct 2018 13:41:00 +0000 (UTC) (envelope-from 0mp@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id D17407202; Mon, 29 Oct 2018 13:41:00 +0000 (UTC) (envelope-from 0mp@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w9TDf0u1011292; Mon, 29 Oct 2018 13:41:00 GMT (envelope-from 0mp@FreeBSD.org) Received: (from 0mp@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w9TDf0xS011291; Mon, 29 Oct 2018 13:41:00 GMT (envelope-from 0mp@FreeBSD.org) Message-Id: <201810291341.w9TDf0xS011291@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: 0mp set sender to 0mp@FreeBSD.org using -f From: Mateusz Piotrowski <0mp@FreeBSD.org> Date: Mon, 29 Oct 2018 13:41:00 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r52413 - head/en_US.ISO8859-1/books/porters-handbook/special X-SVN-Group: doc-head X-SVN-Commit-Author: 0mp X-SVN-Commit-Paths: head/en_US.ISO8859-1/books/porters-handbook/special X-SVN-Commit-Revision: 52413 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 29 Oct 2018 13:41:01 -0000 Author: 0mp (ports committer) Date: Mon Oct 29 13:41:00 2018 New Revision: 52413 URL: https://svnweb.freebsd.org/changeset/doc/52413 Log: Mention "race conditions" in the section about MAKE_JOBS_UNSAFE. The reason for this is to increase discoverability of MAKE_JOBS_UNSAFE. Reviewed by: bcr, mat (previous version) Approved by: mat (mentor) Differential Revision: https://reviews.freebsd.org/D17383 Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Mon Oct 29 09:18:42 2018 (r52412) +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Mon Oct 29 13:41:00 2018 (r52413) @@ -506,14 +506,15 @@ IGNORE= may not be redistributed because of licensing their available CPU power, allowing port builds to be faster and more effective. - This is achieved by passing -jX flag + This is achieved by passing -jX flag 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. + -jX due to race conditions causing + intermittent build failures. When setting MAKE_JOBS_UNSAFE, it