From jgh@FreeBSD.org  Sun Jan  5 21:19:13 2014
Return-Path: <jgh@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 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 <jgh@FreeBSD.org>
Reply-To: Jason Helfman <jgh@FreeBSD.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc: brd@FreeBSD.org, crees@FreeBSD.org
Subject: books/porters-handbook: update parallel building section
X-Send-Pr-Version: 3.114
X-GNATS-Notify:

>Number:         185521
>Category:       docs
>Synopsis:       books/porters-handbook: update parallel building section
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bcr
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jan 05 21:20:00 UTC 2014
>Closed-Date:    Sun Jan 05 22:02:16 UTC 2014
>Last-Modified:  Sun Jan  5 22:10:00 UTC 2014
>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.</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:
Responsible-Changed-From-To: freebsd-doc->bcr  
Responsible-Changed-By: bcr 
Responsible-Changed-When: Sun Jan 5 21:52:42 UTC 2014 
Responsible-Changed-Why:  
Grab this one. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=185521 
State-Changed-From-To: open->closed 
State-Changed-By: bcr 
State-Changed-When: Sun Jan 5 22:01:05 UTC 2014 
State-Changed-Why:  
Committed a corrected version of the patch. 
Thanks for yet another patch to the porters-handbook, jgh!  
PR closed. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=185521 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/185521: commit references a PR
Date: Sun,  5 Jan 2014 22:00:09 +0000 (UTC)

 Author: bcr
 Date: Sun Jan  5 21:59:57 2014
 New Revision: 43436
 URL: http://svnweb.freebsd.org/changeset/doc/43436
 
 Log:
   Update parallel build instructions as MAKE_JOBS_SAFE is the default now.
   Add a missing </para> tag to the provided patch in order to build
   the porters handbook after applying it.
   
   PR:		docs/185521
   Submitted by:	jgh@
 
 Modified:
   head/en_US.ISO8859-1/books/porters-handbook/book.xml
 
 Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/porters-handbook/book.xml	Sun Jan  5 20:58:56 2014	(r43435)
 +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml	Sun Jan  5 21:59:57 2014	(r43436)
 @@ -5624,21 +5624,13 @@ IGNORE=	may not be redistributed because
  	  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>.</para>
        </sect2>
  
        <sect2 xml:id="using-make">
 _______________________________________________
 svn-doc-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-doc-all
 To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
 
>Unformatted:
