[src/trunk]: src BUILDING: update upstream, regen

[lukem <lukem%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/c93a401a6908
branches:  trunk
changeset: 375856:c93a401a6908
user:      lukem <lukem%NetBSD.org@localhost>
date:      Tue May 16 21:21:38 2023 +0000

description:
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.

diffstat:

 BUILDING          |  28 +++++++++++++---------------
 doc/BUILDING.mdoc |  28 ++++++++++++++++++++++++----
 2 files changed, 37 insertions(+), 19 deletions(-)

diffs (144 lines):

diff -r b88178552e78 -r c93a401a6908 BUILDING
--- a/BUILDING  Tue May 16 19:25:06 2023 +0000
+++ b/BUILDING  Tue May 16 21:21:38 2023 +0000
@@ -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
diff -r b88178552e78 -r c93a401a6908 doc/BUILDING.mdoc
--- a/doc/BUILDING.mdoc Tue May 16 19:25:06 2023 +0000
+++ b/doc/BUILDING.mdoc Tue May 16 21:21:38 2023 +0000
@@ -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