Module Name: src
Committed By: lukem
Date: Tue May 16 21:21:38 UTC 2023
Modified Files:
src: BUILDING
src/doc: BUILDING.mdoc
Log Message:
BUILDING: update upstream, regen
doc/BUILDING.mdoc is the upstream for BUILDING, so add recent changes
in the latter to the former, formatting correctly.
Move INSTALLBOOT_UBOOT_PATHS to Environment variables.
Move INSTALLBOOT_BOARDS to "make" variables for full builds.
Add installboot(8) cross-reference.
To generate a diff of this commit:
cvs rdiff -u -r1.146 -r1.147 src/BUILDING
cvs rdiff -u -r1.135 -r1.136 src/doc/BUILDING.mdoc
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/BUILDING
diff -u src/BUILDING:1.146 src/BUILDING:1.147
--- src/BUILDING:1.146 Sat Oct 1 08:55:45 2022
+++ src/BUILDING Tue May 16 21:21:38 2023
@@ -13,7 +13,7 @@ REQUIREMENTS
system to create a build toolchain for the target architecture. The host
system must have at least C and C++ compilers in order to create the
toolchain (make is not required); all other tools are created as part of
- the NetBSD build process. (See the environment variables section below
+ the NetBSD build process. (See the Environment variables section below
if you need to override or manually select your compilers.)
FILES
@@ -117,6 +117,10 @@ CONFIGURATION
HOST_CXXFLAGS Flags passed to the host C++ compiler.
+ INSTALLBOOT_UBOOT_PATHS
+ A colon-separated list of search paths used by
+ installboot(8) to find U-Boot packages.
+
MACHINE Machine type, e.g., "macppc".
MACHINE_ARCH Machine architecture, e.g., "powerpc".
@@ -153,18 +157,6 @@ CONFIGURATION
cannot usefully be set inside a Makefile, including
mk.conf or ${MAKECONF}.
- INSTALLBOOT_BOARDS
- A list of boards to create bootable images for.
- If corresponding U-Boot packages are installed,
- bootable images are created as part of a
- release. See the -o "board=" option of
- installboot(8).
-
- INSTALLBOOT_UBOOT_PATHS
- A colon-separated list of search paths used by
- installboot to find U-Boot packages; see
- installboot(8).
-
"make" variables
Several variables control the behavior of NetBSD builds. Unless
otherwise specified, these variables may be set in either the process
@@ -474,6 +466,12 @@ CONFIGURATION
These variables only affect the top level "Makefile" and do not affect
manually building subtrees of the NetBSD source code.
+ INSTALLBOOT_BOARDS
+ A list of boards to create bootable images for. If
+ corresponding U-Boot packages are installed, bootable
+ images are created as part of a release. See the
+ -o board=name option of installboot(8).
+
INSTALLWORLDDIR Location for the "make installworld" target to install
to. If specified, must be an absolute path.
@@ -1110,8 +1108,8 @@ OBSOLETE VARIABLES
TOOLCHAIN_MISSING=yes.
SEE ALSO
- make(1), hier(7), release(7), etcupdate(8), postinstall(8), sysinst(8),
- pkgsrc/sysutils/cdrtools
+ make(1), hier(7), release(7), etcupdate(8), installboot(8),
+ postinstall(8), sysinst(8), pkgsrc/sysutils/cdrtools
HISTORY
The build.sh based build scheme was introduced for NetBSD 1.6 as
Index: src/doc/BUILDING.mdoc
diff -u src/doc/BUILDING.mdoc:1.135 src/doc/BUILDING.mdoc:1.136
--- src/doc/BUILDING.mdoc:1.135 Sun Aug 21 07:10:03 2022
+++ src/doc/BUILDING.mdoc Tue May 16 21:21:38 2023
@@ -1,6 +1,6 @@
-.\" $NetBSD: BUILDING.mdoc,v 1.135 2022/08/21 07:10:03 lukem Exp $
+.\" $NetBSD: BUILDING.mdoc,v 1.136 2023/05/16 21:21:38 lukem Exp $
.\"
-.\" Copyright (c) 2001-2022 The NetBSD Foundation, Inc.
+.\" Copyright (c) 2001-2023 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to The NetBSD Foundation
@@ -76,7 +76,9 @@ compilers in order to create the toolcha
is not required); all other tools are created as part of the
.Nx
build process.
-(See the environment variables section below if you need
+(See the
+.Sx Environment variables
+section below if you need
to override or manually select your compilers.)
.
.Sh FILES
@@ -234,6 +236,11 @@ Path name to C++ compiler used to create
.It Sy HOST_CXXFLAGS
Flags passed to the host C++ compiler.
.
+.It Sy INSTALLBOOT_UBOOT_PATHS
+A colon-separated list of search paths used by
+.Xr installboot 8
+to find U-Boot packages.
+.
.It Sy MACHINE
Machine type, e.g.,
.Dq macppc .
@@ -577,7 +584,7 @@ will be run against portions of the
source code during the build, and whether lint libraries will be
installed into
.Sy DESTDIR Ns Pa /usr/libdata/lint .
-.DFLTy
+.DFLTn
.
.It Sy MKMAN
.YorN
@@ -822,6 +829,7 @@ if that exists; otherwise
.El
.
.Ss \*qmake\*q variables for full builds
+.
These variables only affect the top level
.Dq Makefile
and do not affect manually building subtrees of the
@@ -830,6 +838,17 @@ source code.
.
.Bl -tag -width "INSTALLWORLDDIR"
.
+.It Sy INSTALLBOOT_BOARDS
+A list of boards to create bootable images for.
+If corresponding U-Boot packages are installed,
+bootable images are created as part of a release.
+See the
+.Bk -words
+.Fl o Sy board= Ns Ar name
+.Ek
+option of
+.Xr installboot 8 .
+.
.It Sy INSTALLWORLDDIR
Location for the
.Dq make installworld
@@ -2128,6 +2147,7 @@ To disable, use
.Xr hier 7 ,
.Xr release 7 ,
.Xr etcupdate 8 ,
+.Xr installboot 8 ,
.Xr postinstall 8 ,
.Xr sysinst 8 ,
.Pa pkgsrc/sysutils/cdrtools
