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.
This commit is contained in:
lukem
parent
c78b7b8064
commit
b9abc1c511
28
BUILDING
28
BUILDING
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Reference in New Issue