Date: Sun, 5 Jan 2014 21:19:13 GMT From: Jason Helfman <jgh@FreeBSD.org> To: FreeBSD-gnats-submit@freebsd.org Cc: brd@FreeBSD.org Subject: docs/185521: books/porters-handbook: update parallel building section Message-ID: <201401052119.s05LJDc5031950@freefall.freebsd.org> Resent-Message-ID: <201401052120.s05LK0s7032018@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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@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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201401052119.s05LJDc5031950>