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