docs/185521: books/porters-handbook: update parallel building section

[Jason Helfman]

>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 at 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.</para>
 
 	<para>This is achieved by passing <varname>-jX</varname> 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
-	  <literal>MAKE_JOBS_SAFE=yes</literal> somewhere below the
-	  dependency declaration section of the
-	  <filename>Makefile</filename>.</para>
-
-	<para>Another option for controlling this feature from the
-	  maintainer's point of view is the
-	  <varname>MAKE_JOBS_UNSAFE=yes</varname> variable.  It is
-	  used when a port is known to be broken with
-	  <varname>-jX</varname> and a user forces the use of multi
-	  processor compilations for all ports in
-	  <filename>/etc/make.conf</filename> with the
-	  <literal>FORCE_MAKE_JOBS=yes</literal> variable.</para>
+	  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>.
       </sect2>
 
       <sect2 xml:id="using-make">
>Release-Note:
>Audit-Trail:
>Unformatted: