svn commit: r52413 - head/en_US.ISO8859-1/books/porters-handbook/special

[Mateusz Piotrowski]

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 <acronym>CPU</acronym> power, allowing port
 	builds to be faster and more effective.</para>
 
-      <para>This is achieved by passing <varname>-jX</varname> flag
+      <para>This is achieved by passing <literal>-jX</literal> 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
 	<literal>MAKE_JOBS_UNSAFE=yes</literal> variable.  It is
 	used when a port is known to be broken with
-	<varname>-jX</varname>.</para>
+	<literal>-jX</literal> due to race conditions causing
+	intermittent build failures.</para>
 
       <important>
 	<para>When setting <varname>MAKE_JOBS_UNSAFE</varname>, it