Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

* Suggest a "-j" value between 1+NCPU and 2*NCPU for the fastest builds.

Browse Source 
* Remove some duplicated content that appeared in both the section about
  make's -j flag and the section about build.sh's -j flag.
This commit is contained in:
apb 2008-08-11 08:22:39 +00:00
parent d3111754f6
commit f0633cf45e
2 changed files with 23 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
BUILDING
View File

@ -413,9 +413,7 @@ BUILDING
-j njob Run up to njob make(1) subjobs in parallel. Makefiles should
use .WAIT or have explicit dependencies as necessary to
enforce build ordering. If you see build failures with -j,
please save complete build logs so the failures can be ana-
lyzed.
enforce build ordering.
-m dir Specify the default directory for searching for system Make-
file segments, mainly the <bsd.*.mk> files. When building any
@ -703,10 +701,13 @@ BUILDING
-h Print a help message.
-j njob Run up to njob make(1) subjobs in parallel; passed through to
make(1). Makefiles should use .WAIT or have explicit dependan-
cies as necessary to enforce build ordering. If you see build
failures with -j, please save complete build logs so the fail-
ures can be analyzed.
make(1). If you see failures for reasons other than running
out of memory while using build.sh with -j, please save com-
plete build logs so the failures can be analyzed.
To achieve the fastest builds, -j values between (1 + the num-
ber of CPUs) and (2 * the number of CPUs) are recommended. Use
lower values on machines with limited memory or I/O bandwidth.
-M obj Set MAKEOBJDIRPREFIX to obj. For instance, if the source
directory is /usr/src, a setting of ``-M /usr/obj'' will place
@ -866,4 +867,4 @@ HISTORY
BUGS
A few platforms are not yet using this build system.
NetBSD August 5, 2008 NetBSD
NetBSD August 11, 2008 NetBSD

21
doc/BUILDING.mdoc
View File

@ -1,4 +1,4 @@
.\" $NetBSD: BUILDING.mdoc,v 1.61 2008/08/05 22:40:33 apb Exp $
.\" $NetBSD: BUILDING.mdoc,v 1.62 2008/08/11 08:22:40 apb Exp $
.\"
.\" Copyright (c) 2001-2008 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -33,7 +33,7 @@
.\" Toolchain prefix for commands
.ds toolprefix nb
.
.Dd August 5, 2008
.Dd August 11, 2008
.Dt BUILDING 8
.Os NetBSD
.
@ -754,8 +754,6 @@ Run up to
subjobs in parallel.
Makefiles should use .WAIT or have explicit dependencies
as necessary to enforce build ordering.
If you see build failures with -j, please save complete build logs
so the failures can be analyzed.
.
.It Fl m Ar dir
Specify the default directory for searching for system Makefile
@ -1341,10 +1339,19 @@ Run up to
subjobs in parallel;
passed through to
.Xr make 1 .
Makefiles should use .WAIT or have explicit dependancies
as necessary to enforce build ordering.
If you see build failures with -j, please save complete build logs
If you see failures for reasons other than running out of memory
while using
.Sy build.sh
with
.Fl j ,
please save complete build logs
so the failures can be analyzed.
.Pp
To achieve the fastest builds,
.Fl j
values between (1 + the number of CPUs) and (2 * the number of CPUs)
are recommended.
Use lower values on machines with limited memory or I/O bandwidth.
.
.It Fl M Ar obj
Set