diff options
| author | lukem <lukem@NetBSD.org> | 2023-05-16 21:21:38 +0000 |
|---|---|---|
| committer | lukem <lukem@NetBSD.org> | 2023-05-16 21:21:38 +0000 |
| commit | 6d0349d2ae0c74b6cbfb4a87be23b7a7b954e83c (patch) | |
| tree | 8e278c674da2ec1a43627be27df85c53be71a819 | |
| parent | 7e97652c55f3767f85ac137efa295cd51641a05f (diff) | |
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.
| -rw-r--r-- | BUILDING | 28 | ||||
| -rw-r--r-- | doc/BUILDING.mdoc | 28 |
2 files changed, 37 insertions, 19 deletions
@@ -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 --git a/doc/BUILDING.mdoc b/doc/BUILDING.mdoc index d642fbeceba..5ebfa30f749 100644 --- a/doc/BUILDING.mdoc +++ b/doc/BUILDING.mdoc @@ -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 toolchain 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 the toolchain. .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 |
