From 6c511d4a280e31c541f9131a3888e1b5d47705bb Mon Sep 17 00:00:00 2001 From: Mateusz Piotrowski <0mp@FreeBSD.org> Date: Mon, 29 Oct 2018 13:41:00 +0000 Subject: [PATCH] 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 --- en_US.ISO8859-1/books/porters-handbook/special/chapter.xml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml index da9cac3cd2..ec5e7d9874 100644 --- a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml +++ b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml @@ -506,14 +506,15 @@ IGNORE= may not be redistributed because of licensing reasons. Please visit 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