Sun Jun 11 10:43:51 2023 UTC ()
more NBUILDJOBS deprecation

The NBUILDJOBS option was deprecated in 2002;
there's no need to keep warning about it,
remove from params / show-params,
and only document as obsolete.


(lukem)
diff -r1.152 -r1.153 src/BUILDING
diff -r1.336 -r1.337 src/Makefile
diff -r1.141 -r1.142 src/doc/BUILDING.mdoc
diff -r1.22 -r1.23 src/etc/Makefile.params

cvs diff -r1.152 -r1.153 src/BUILDING (expand / switch to unified diff)

--- src/BUILDING 2023/06/05 22:36:17 1.152
+++ src/BUILDING 2023/06/11 10:43:51 1.153
@@ -666,31 +666,26 @@ CONFIGURATION @@ -666,31 +666,26 @@ CONFIGURATION
666 If using build.sh, the default is "yes". This may be set 666 If using build.sh, the default is "yes". This may be set
667 back to "no" by giving build.sh the -o option. 667 back to "no" by giving build.sh the -o option.
668 668
669 MKUPDATE Can be set to "yes" or "no". If set, then in addition to 669 MKUPDATE Can be set to "yes" or "no". If set, then in addition to
670 the effects described for MKUPDATE=yes above, this 670 the effects described for MKUPDATE=yes above, this
671 implies the effects of NOCLEANDIR (i.e., "make cleandir" 671 implies the effects of NOCLEANDIR (i.e., "make cleandir"
672 is avoided). 672 is avoided).
673 673
674 Default: "no" 674 Default: "no"
675 675
676 If using build.sh, this may be set by giving the -u 676 If using build.sh, this may be set by giving the -u
677 option. 677 option.
678 678
679 NBUILDJOBS Now obsolete. Use the make(1) option -j, instead. See 
680 below. 
681 
682 Default: Unset. 
683 
684 NOCLEANDIR If set, avoids the "make cleandir" phase of a full build. 679 NOCLEANDIR If set, avoids the "make cleandir" phase of a full build.
685 This has the effect of allowing only changed files in a 680 This has the effect of allowing only changed files in a
686 source tree to be recompiled. This can speed up builds 681 source tree to be recompiled. This can speed up builds
687 when updating only a few files in the tree. 682 when updating only a few files in the tree.
688 683
689 Default: Unset. 684 Default: Unset.
690 685
691 See also MKUPDATE. 686 See also MKUPDATE.
692 687
693 NODISTRIBDIRS If set, avoids the "make distrib-dirs" phase of a full 688 NODISTRIBDIRS If set, avoids the "make distrib-dirs" phase of a full
694 build. This skips running mtree(8) on DESTDIR, useful on 689 build. This skips running mtree(8) on DESTDIR, useful on
695 systems where building as an unprivileged user, or where 690 systems where building as an unprivileged user, or where
696 it is known that the system-wide mtree files have not 691 it is known that the system-wide mtree files have not
@@ -1283,37 +1278,37 @@ EXAMPLES @@ -1283,37 +1278,37 @@ EXAMPLES
1283 Even though this is run as root, -U is required so that the 1278 Even though this is run as root, -U is required so that the
1284 permissions stored in DESTDIR/METALOG are correctly applied to the 1279 permissions stored in DESTDIR/METALOG are correctly applied to the
1285 files as they're copied to /. 1280 files as they're copied to /.
1286 1281
1287 4. % ./build.sh [OPTIONS] -U -u release 1282 4. % ./build.sh [OPTIONS] -U -u release
1288 1283
1289 Using unprivileged mode, build a complete release to DESTDIR and 1284 Using unprivileged mode, build a complete release to DESTDIR and
1290 RELEASEDIR directories that build.sh selects (and will show). 1285 RELEASEDIR directories that build.sh selects (and will show).
1291 MKUPDATE=yes (-u) is set to prevent the "make cleandir", so that if 1286 MKUPDATE=yes (-u) is set to prevent the "make cleandir", so that if
1292 this is run after example 2, it doesn't need to redo that portion of 1287 this is run after example 2, it doesn't need to redo that portion of
1293 the release build. 1288 the release build.
1294 1289
1295OBSOLETE VARIABLES 1290OBSOLETE VARIABLES
1296 NBUILDJOBS Use the make(1) option -j instead. 1291 NBUILDJOBS Use the build.sh and make(1) option -j instead.
1297 1292
1298 USE_NEW_TOOLCHAIN 1293 USE_NEW_TOOLCHAIN
1299 The new toolchain is now the default. To disable, use 1294 The new toolchain is now the default. To disable, use
1300 TOOLCHAIN_MISSING=yes. 1295 TOOLCHAIN_MISSING=yes.
1301 1296
1302SEE ALSO 1297SEE ALSO
1303 ar(1), config(1), ctags(1), cvs(1), cvslatest(1), ex(1), g++(1), gzip(1), 1298 ar(1), config(1), ctags(1), cvs(1), cvslatest(1), ex(1), g++(1), gzip(1),
1304 ident(1), ld(1), lint(1), make(1), mkisofs(1), sh(1), uname(1), vi(1), 1299 ident(1), ld(1), lint(1), make(1), mkisofs(1), sh(1), uname(1), vi(1),
1305 options(4), mk.conf(5), atf(7), hier(7), release(7), sysctl(7), 1300 options(4), mk.conf(5), atf(7), hier(7), release(7), sysctl(7),
1306 etcupdate(8), installboot(8), mount(8), mtree(8), postinstall(8), 1301 etcupdate(8), installboot(8), mount(8), mtree(8), postinstall(8),
1307 sysinst(8), pkgsrc/sysutils/cdrtools 1302 sysinst(8), pkgsrc/sysutils/cdrtools
1308 1303
1309HISTORY 1304HISTORY
1310 The build.sh based build scheme was introduced for NetBSD 1.6 as 1305 The build.sh based build scheme was introduced for NetBSD 1.6 as
1311 USE_NEW_TOOLCHAIN, and re-worked to TOOLCHAIN_MISSING after that. 1306 USE_NEW_TOOLCHAIN, and re-worked to TOOLCHAIN_MISSING after that.
1312 1307
1313CAVEATS 1308CAVEATS
1314 After significant updates to third-party components in the source tree, 1309 After significant updates to third-party components in the source tree,
1315 the "make cleandir" operation may be insufficient to clean out old files 1310 the "make cleandir" operation may be insufficient to clean out old files
1316 in object directories. Instead, one may have to manually remove the 1311 in object directories. Instead, one may have to manually remove the
1317 files. Consult the UPDATING file for notices concerning this. 1312 files. Consult the UPDATING file for notices concerning this.
1318 1313
1319NetBSD June 5, 2023 NetBSD 1314NetBSD June 10, 2023 NetBSD

cvs diff -r1.336 -r1.337 src/Makefile (expand / switch to unified diff)

--- src/Makefile 2023/06/02 20:48:09 1.336
+++ src/Makefile 2023/06/11 10:43:51 1.337
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1# $NetBSD: Makefile,v 1.336 2023/06/02 20:48:09 lukem Exp $ 1# $NetBSD: Makefile,v 1.337 2023/06/11 10:43:51 lukem Exp $
2 2
3# 3#
4# This is the top-level makefile for building NetBSD. For an outline of 4# This is the top-level makefile for building NetBSD. For an outline of
5# how to build a snapshot or release, as well as other release engineering 5# how to build a snapshot or release, as well as other release engineering
6# information, see http://www.NetBSD.org/developers/releng/index.html 6# information, see http://www.NetBSD.org/developers/releng/index.html
7# 7#
8# Not everything you can set or do is documented in this makefile. In 8# Not everything you can set or do is documented in this makefile. In
9# particular, you should review the files in /usr/share/mk (especially 9# particular, you should review the files in /usr/share/mk (especially
10# bsd.README) for general information on building programs and writing 10# bsd.README) for general information on building programs and writing
11# Makefiles within this structure, and see the comments in src/etc/Makefile 11# Makefiles within this structure, and see the comments in src/etc/Makefile
12# for further information on installation and release set options. 12# for further information on installation and release set options.
13# 13#
14# Variables listed below can be set on the make command line (highest 14# Variables listed below can be set on the make command line (highest
@@ -436,29 +436,26 @@ install-image: .PHONY @@ -436,29 +436,26 @@ install-image: .PHONY
436 @printf "make ${.TARGET} finished at: " && date 436 @printf "make ${.TARGET} finished at: " && date
437 437
438# 438#
439# Special components of the "make build" process. 439# Special components of the "make build" process.
440# 440#
441 441
442check-tools: .PHONY 442check-tools: .PHONY
443.if ${TOOLCHAIN_MISSING} != "no" && !defined(EXTERNAL_TOOLCHAIN) 443.if ${TOOLCHAIN_MISSING} != "no" && !defined(EXTERNAL_TOOLCHAIN)
444 @echo '*** WARNING: Building on MACHINE=${MACHINE} with missing toolchain.' 444 @echo '*** WARNING: Building on MACHINE=${MACHINE} with missing toolchain.'
445 @echo '*** May result in a failed build or corrupt binaries!' 445 @echo '*** May result in a failed build or corrupt binaries!'
446.elif defined(EXTERNAL_TOOLCHAIN) 446.elif defined(EXTERNAL_TOOLCHAIN)
447 @echo '*** Using external toolchain rooted at ${EXTERNAL_TOOLCHAIN}.' 447 @echo '*** Using external toolchain rooted at ${EXTERNAL_TOOLCHAIN}.'
448.endif 448.endif
449.if defined(NBUILDJOBS) 
450 @echo '*** WARNING: NBUILDJOBS is obsolete; use -j directly instead!' 
451.endif 
452 449
453# Delete or sanitise a leftover METALOG from a previous build. 450# Delete or sanitise a leftover METALOG from a previous build.
454clean_METALOG: .PHONY .MAKE 451clean_METALOG: .PHONY .MAKE
455.if ${MKUPDATE} != "no" 452.if ${MKUPDATE} != "no"
456 ${MAKEDIRTARGET} distrib/sets clean_METALOG 453 ${MAKEDIRTARGET} distrib/sets clean_METALOG
457.endif 454.endif
458 455
459do-distrib-dirs: .PHONY .MAKE 456do-distrib-dirs: .PHONY .MAKE
460.if !defined(DESTDIR) || ${DESTDIR} == "" 457.if !defined(DESTDIR) || ${DESTDIR} == ""
461 ${MAKEDIRTARGET} etc distrib-dirs DESTDIR=/ 458 ${MAKEDIRTARGET} etc distrib-dirs DESTDIR=/
462.else 459.else
463 ${MAKEDIRTARGET} etc distrib-dirs DESTDIR=${DESTDIR} 460 ${MAKEDIRTARGET} etc distrib-dirs DESTDIR=${DESTDIR}
464.endif 461.endif

cvs diff -r1.141 -r1.142 src/doc/BUILDING.mdoc (expand / switch to unified diff)

--- src/doc/BUILDING.mdoc 2023/06/05 22:36:17 1.141
+++ src/doc/BUILDING.mdoc 2023/06/11 10:43:51 1.142
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: BUILDING.mdoc,v 1.141 2023/06/05 22:36:17 lukem Exp $ 1.\" $NetBSD: BUILDING.mdoc,v 1.142 2023/06/11 10:43:51 lukem Exp $
2.\" 2.\"
3.\" Copyright (c) 2001-2023 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2001-2023 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Todd Vierling and Luke Mewburn. 7.\" by Todd Vierling and Luke Mewburn.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -23,27 +23,27 @@ @@ -23,27 +23,27 @@
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE. 28.\" POSSIBILITY OF SUCH DAMAGE.
29.\" 29.\"
30.\" NOTE: After changing this file, run "make regen" in the src/doc 30.\" NOTE: After changing this file, run "make regen" in the src/doc
31.\" directory, and check in both src/BUILDING and src/doc/BUILDING.mdoc. 31.\" directory, and check in both src/BUILDING and src/doc/BUILDING.mdoc.
32.\" 32.\"
33.\" Toolchain prefix for commands 33.\" Toolchain prefix for commands
34.ds toolprefix nb 34.ds toolprefix nb
35. 35.
36.Dd June 5, 2023 36.Dd June 10, 2023
37.Dt BUILDING 8 37.Dt BUILDING 8
38.Os NetBSD 38.Os NetBSD
39.\" turn off hyphenation 39.\" turn off hyphenation
40.hym 999 40.hym 999
41. 41.
42.\" if this file is processed with real roff (doc.tmac) 42.\" if this file is processed with real roff (doc.tmac)
43.\" now that the tmac files have been lazily read, 43.\" now that the tmac files have been lazily read,
44.\" we can override ``quotes'' with "quotes" for ascii output 44.\" we can override ``quotes'' with "quotes" for ascii output
45.ie '\*[Lq]'``' \{\ 45.ie '\*[Lq]'``' \{\
46.ds Lq \*q 46.ds Lq \*q
47.ds Rq \*q 47.ds Rq \*q
48.\} 48.\}
49.\" and disable hyphenation 49.\" and disable hyphenation
@@ -1159,36 +1159,26 @@ If set, then in addition to the effects  @@ -1159,36 +1159,26 @@ If set, then in addition to the effects
1159above, this implies the effects of 1159above, this implies the effects of
1160.Sy NOCLEANDIR 1160.Sy NOCLEANDIR
1161(i.e., 1161(i.e.,
1162.Dq make cleandir 1162.Dq make cleandir
1163is avoided). 1163is avoided).
1164.DFLTn 1164.DFLTn
1165.Pp 1165.Pp
1166If using 1166If using
1167.Sy build.sh , 1167.Sy build.sh ,
1168this may be set by giving the 1168this may be set by giving the
1169.Fl u 1169.Fl u
1170option. 1170option.
1171. 1171.
1172.It Sy NBUILDJOBS 
1173Now obsolete. 
1174Use the 
1175.Xr make 1 
1176option 
1177.Fl j , 
1178instead. 
1179See below. 
1180.DFLTu 
1181. 
1182.It Sy NOCLEANDIR 1172.It Sy NOCLEANDIR
1183If set, avoids the 1173If set, avoids the
1184.Dq make cleandir 1174.Dq make cleandir
1185phase of a full build. 1175phase of a full build.
1186This has the effect of allowing only changed 1176This has the effect of allowing only changed
1187files in a source tree to be recompiled. 1177files in a source tree to be recompiled.
1188This can speed up builds when updating only a few files in the tree. 1178This can speed up builds when updating only a few files in the tree.
1189.DFLTu 1179.DFLTu
1190.Pp 1180.Pp
1191See also 1181See also
1192.Sy MKUPDATE . 1182.Sy MKUPDATE .
1193. 1183.
1194.It Sy NODISTRIBDIRS 1184.It Sy NODISTRIBDIRS
@@ -2422,26 +2412,28 @@ selects (and will show). @@ -2422,26 +2412,28 @@ selects (and will show).
2422.Pq Fl u 2412.Pq Fl u
2423is set to prevent the 2413is set to prevent the
2424.Dq make cleandir , 2414.Dq make cleandir ,
2425so that if this is run after example 2, it doesn't need to redo that 2415so that if this is run after example 2, it doesn't need to redo that
2426portion of the release build. 2416portion of the release build.
2427.El 2417.El
2428. 2418.
2429.Sh OBSOLETE VARIABLES 2419.Sh OBSOLETE VARIABLES
2430. 2420.
2431.Bl -tag -width "NBUILDJOBS" 2421.Bl -tag -width "NBUILDJOBS"
2432. 2422.
2433.It Sy NBUILDJOBS 2423.It Sy NBUILDJOBS
2434Use the 2424Use the
 2425.Nm build.sh
 2426and
2435.Xr make 1 2427.Xr make 1
2436option 2428option
2437.Fl j 2429.Fl j
2438instead. 2430instead.
2439. 2431.
2440.It Sy USE_NEW_TOOLCHAIN 2432.It Sy USE_NEW_TOOLCHAIN
2441The new toolchain is now the default. 2433The new toolchain is now the default.
2442To disable, use 2434To disable, use
2443.Sy TOOLCHAIN_MISSING=yes . 2435.Sy TOOLCHAIN_MISSING=yes .
2444.El 2436.El
2445.Sh SEE ALSO 2437.Sh SEE ALSO
2446.Xr ar 1 , 2438.Xr ar 1 ,
2447.Xr config 1 , 2439.Xr config 1 ,

cvs diff -r1.22 -r1.23 src/etc/Makefile.params (expand / switch to unified diff)

--- src/etc/Makefile.params 2021/02/14 18:45:44 1.22
+++ src/etc/Makefile.params 2023/06/11 10:43:51 1.23
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1# $NetBSD: Makefile.params,v 1.22 2021/02/14 18:45:44 pgoyette Exp $ 1# $NetBSD: Makefile.params,v 1.23 2023/06/11 10:43:51 lukem Exp $
2# 2#
3# Makefile fragment for printing build parameters. 3# Makefile fragment for printing build parameters.
4# 4#
5# Public variables: 5# Public variables:
6# RELEASEVARS 6# RELEASEVARS
7# List of variables whose value should be printed. 7# List of variables whose value should be printed.
8# 8#
9# PRINT_PARAMS 9# PRINT_PARAMS
10# A command to print the desired variables and values 10# A command to print the desired variables and values
11# to stdout, without any additional debugging information. 11# to stdout, without any additional debugging information.
12# Values are printed as single-quoted strings, with 12# Values are printed as single-quoted strings, with
13# embedded quotes and newlines escaped in a way that's 13# embedded quotes and newlines escaped in a way that's
14# acceptable to sh(1). Undefined values are printed 14# acceptable to sh(1). Undefined values are printed
@@ -40,27 +40,27 @@ @@ -40,27 +40,27 @@
40RELEASEVARS= DISTRIBVER EXTERNAL_TOOLCHAIN HAVE_GCC HAVE_GDB \ 40RELEASEVARS= DISTRIBVER EXTERNAL_TOOLCHAIN HAVE_GCC HAVE_GDB \
41 HAVE_LLVM HAVE_PCC INSTALLWORLDDIR \ 41 HAVE_LLVM HAVE_PCC INSTALLWORLDDIR \
42 MACHINE MACHINE_ARCH \ 42 MACHINE MACHINE_ARCH \
43 NETBSD_OFFICIAL_RELEASE NOCLEANDIR NODISTRIBDIRS NOINCLUDES \ 43 NETBSD_OFFICIAL_RELEASE NOCLEANDIR NODISTRIBDIRS NOINCLUDES \
44 TOOLCHAIN_MISSING \ 44 TOOLCHAIN_MISSING \
45 USE_HESIOD USE_INET6 USE_JEMALLOC USE_KERBEROS USE_LDAP \ 45 USE_HESIOD USE_INET6 USE_JEMALLOC USE_KERBEROS USE_LDAP \
46 USE_PAM USE_SKEY USE_YP \ 46 USE_PAM USE_SKEY USE_YP \
47 USETOOLS 47 USETOOLS
48 48
49.if ${MKREPRO:Uno} != "yes" 49.if ${MKREPRO:Uno} != "yes"
50RELEASEVARS+= BSDOBJDIR BSDSRCDIR BUILDID BUILDINFO BUILDSEED \ 50RELEASEVARS+= BSDOBJDIR BSDSRCDIR BUILDID BUILDINFO BUILDSEED \
51 DESTDIR KERNARCHDIR KERNCONFDIR KERNOBJDIR KERNSRCDIR MAKE \ 51 DESTDIR KERNARCHDIR KERNCONFDIR KERNOBJDIR KERNSRCDIR MAKE \
52 KERNEL_DIR MAKECONF MAKEFLAGS MAKEOBJDIR MAKEOBJDIRPREFIX \ 52 KERNEL_DIR MAKECONF MAKEFLAGS MAKEOBJDIR MAKEOBJDIRPREFIX \
53 MAKEVERBOSE NBUILDJOBS NETBSDSRCDIR OBJMACHINE OBJMACHINE_ARCH \ 53 MAKEVERBOSE NETBSDSRCDIR OBJMACHINE OBJMACHINE_ARCH \
54 RELEASEDIR RELEASEMACHINEDIR TOOLDIR USR_OBJMACHINE X11SRCDIR 54 RELEASEDIR RELEASEMACHINEDIR TOOLDIR USR_OBJMACHINE X11SRCDIR
55.endif 55.endif
56 56
57RELEASEVARS+= ${_MKVARS.yes} ${_MKVARS.no} 57RELEASEVARS+= ${_MKVARS.yes} ${_MKVARS.no}
58 58
59# 59#
60# Duplicate the DISTRIBVER setting from src/etc/Makefile. 60# Duplicate the DISTRIBVER setting from src/etc/Makefile.
61# 61#
62.ifndef DISTRIBVER 62.ifndef DISTRIBVER
63DISTRIBVER!= ${HOST_SH} ${NETBSDSRCDIR}/sys/conf/osrelease.sh 63DISTRIBVER!= ${HOST_SH} ${NETBSDSRCDIR}/sys/conf/osrelease.sh
64.endif 64.endif
65 65
66# 66#