en Copyright 2015 Java http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#13890d5a3ff94c63919e6818d52332ad578fd7ac BUILDING: fix typo List of files: /netbsd-src/BUILDING Fri, 26 Apr 2024 17:38:44 +0000 rillig <rillig@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#a9756fb69c21854bcddbffe2c05ac99a1c9e1a69 BUILDING: list known mk.conf vars. tweak section headersList known supported and obsolete mk.conf(5) variables,so that searches in this document at least find them.This partially reverts my revision 1.144 on 2023-06-12which completely removed the duplication with mk.conf(5).Remove quote characters from some section headings;it makes it harder to search for a section by known namewhen rendering in markup variations that use smart quotes. List of files: /netbsd-src/BUILDING Sat, 22 Jul 2023 18:50:04 +0000 lukem <lukem@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#cc95aaefd747a259d86e7f468a3b183cd297cf7a BUILDING: clarify environ vs mk.conf behaviourDocument that variables set in the environment or thenbmake-MACHINE wrapper script don't override variableassignments in mk.conf(5), and that using ?= in mk.confallows environment / nbmake-MACHINE variables to overridemk.conf.Consistently refer to "nbmake-MACHINE wrapper script". List of files: /netbsd-src/BUILDING Fri, 21 Jul 2023 22:07:59 +0000 lukem <lukem@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#747c3dee3641b0c202d59f9de1e2e72bf9359c7b BUILDING: consistency fix List of files: /netbsd-src/BUILDING Wed, 19 Jul 2023 15:40:38 +0000 lukem <lukem@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#3cb563b335478513cddb15a2bd07442aa8e4c6a5 build.sh: use mk.conf (if present) as MAKECONFSet MAKECONF to mk.conf in the same directory as build.sh(i.e., the top of the source tree) if mk.conf is present.This means unprivileged users can benefit from mk.conf(5)semantics without write privileges to /etc/mk.conf, andalso simplifies per-source-directory configuration.Fail early if $MAKECONF is empty, since build.sh will failanyway after rebuilding nbmake.Ensure that the computed MAKECONF isn't empty, and thenalways set MAKECONF in the makewrapper (nbmake-$MACHINE).Improve some formatting consistency in BUILDING.mdoc,(even if BUILDING is generated without markup). List of files: /netbsd-src/BUILDING Tue, 18 Jul 2023 16:59:57 +0000 lukem <lukem@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#2b1fd0414ce0c1d3396f879343d50cf535fb6794 BUILDING: wording tweaks List of files: /netbsd-src/BUILDING Wed, 05 Jul 2023 16:41:12 +0000 lukem <lukem@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#6aba6b1625ffa48adf02eb361838a162a38e1165 BUILDING: remove duplication from mk.conf(5)Remove all "make" variables / mk.conf(5) variables already documentedin mk.conf(5). The duplication was a maintenance headache, as I'veexperienced over recent weeks getting the build documentation up todate.Add notes clarifying that manual page references are to the NetBSDmanual pages, not to the host manual pages, and how to format fromsource, or find online at https://man.netbsd.org.Add explicit links to the mdoc(7) in-tree source for mk.conf(5),hier(7), and release(7) because those are directly relevant to the hostbuild information in BUILDING.Note: We don't normally need these notes for native documentation,but BUILDING is intended for users on host systems which might notbe NetBSD(-current).Add missing defaults. List of files: /netbsd-src/BUILDING Sun, 11 Jun 2023 20:34:14 +0000 lukem <lukem@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#3dd6409cfb955aec4a82661b6e9c1df4793852f5 BUILDING: update from mk.conf(5). reorderSync variable entries from mk.conf(5).Merge the "make variables for full builds" section into the previous.Having two separate sections and some entries duplicated was confusingwhen searching for variables. List of files: /netbsd-src/BUILDING Sun, 11 Jun 2023 10:49:43 +0000 lukem <lukem@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#922f5e2588a58574818fef37264163f244d789f1 more NBUILDJOBS deprecationThe NBUILDJOBS option was deprecated in 2002;there's no need to keep warning about it,remove from params / show-params,and only document as obsolete. List of files: /netbsd-src/BUILDING Sun, 11 Jun 2023 10:43:51 +0000 lukem <lukem@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#5166ed0b680e9e56eb8e69c80c8ced2520234270 BUILDING: editorialMKX11=yes wants MKINET6=yesChange the width of the variable lists to 14n (from 15n)so that when the lists are rendered and then left aligned,the column is 16 characters (aka 2 tabs) which makescopypasta to bsd.README easier. List of files: /netbsd-src/BUILDING Mon, 05 Jun 2023 22:36:17 +0000 lukem <lukem@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#f26a4cc930e8e126077be482d1f9898a57af5ae1 BUILDING: update from canonical mk.conf(5)Incorporate content and styles updates for mk.conf entriesfrom share/man/man5/mk.conf.5, which is the canonicalreference for mk.conf.Add: BSDOBJDIR, BSDSRCDIR, EXTERNAL_TOOLCHAIN, MKDEBUGKERNEL,MKDEBUGTOOLS, MKHTML, MKLINKLIB, MKOBJDIRS, TOOLCHAIN_MISSING,NETBSDSRCDIRIt's for further study as to whether we just replace themost of subsection "make" variables with a link to mk.conf(5).Style:- Add more .de macros per mk.conf.5.- Order list items alphabetically. When multiple items are present in a list item, sort within the item first.- More cross-references. List of files: /netbsd-src/BUILDING Sun, 04 Jun 2023 20:08:21 +0000 lukem <lukem@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#105457a1c49880a571d0b6eb6080b5011c8a1741 build.sh: MAKECONF and mk.conf(5) improvementsMove MAKECONF to the Environment variables section.Add mk.conf(5) cross-references.Make Notes more obvious.Fix mandoc lint. List of files: /netbsd-src/BUILDING Fri, 02 Jun 2023 20:48:41 +0000 lukem <lukem@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#23c02a696a424fbb0227eea9cdcbed41fbb1a8d3 BUILDING: TMPDIR must not be noexecDescribe $TMPDIR as used by build.sh, andadd a note that it can't be mounted noexec.PR toolchain/44459 List of files: /netbsd-src/BUILDING Thu, 18 May 2023 14:22:53 +0000 lukem <lukem@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#9d6c4a26028557ae535bd07e4f64a56e75a4c83e build.sh, BUILDING: consistency improvementsConsistently use "show", instead of sometimes using "display" or "print".Fix mdoc markup (even though BUILDING is raw text).Document help, -P, -? List of files: /netbsd-src/BUILDING Tue, 16 May 2023 21:39:26 +0000 lukem <lukem@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#b9abc1c511f5a8803ee0cbd8a7b5face07ac993c BUILDING: update upstream, regendoc/BUILDING.mdoc is the upstream for BUILDING, so add recent changesin 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. List of files: /netbsd-src/BUILDING Tue, 16 May 2023 21:21:38 +0000 lukem <lukem@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#899c3c9bdc08f5d281e506e02a5d4421122c12fc fix documentation for MKLINTSince share/mk/bsd.own.mk 1.749 from 2013-08-26, MKLINT defaults to no. List of files: /netbsd-src/BUILDING Sat, 01 Oct 2022 08:55:45 +0000 rillig <rillig@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#c5a23dac6625adba4d0e6f3a8ec1859a34cce0d4 By default, do not install any bootable images.The previous commit introduced the ability to install a set ofbootable images as a normal part of a release build. While this madeit easy to install bootable images, the contents of a release builddepend on whether or not U-Boot packages are installed in /usr/pkgsrc,which is the default location searched by installboot(8).This commit requires users to explicitly list the bootable images tobe installed, which by default is none (i.e., prior behavior). List of files: /netbsd-src/BUILDING Mon, 22 Aug 2022 16:50:25 +0000 brook <brook@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#99f61d3fde5a9f478601189b22923344d336d559 Create bootable images in ${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/gzimg.Release builds for arm platforms create compressed images in${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/gzimg. However, in somecases, e.g., armv7.img.gz, they are not bootable. Consequently, bootblocks must be manually installed in the images, which is an extrabarrier for testing systems or adopting NetBSD. This has promptedcreation of external repositories, e.g., armbsd.org, to host acollection of bootable images. However, this does not ease the burdenon developers compiling their own systems; for them, manualinstallation of boot blocks is still required.For arm platforms, etc/etc.evbarm/Makefile.inc contains the commandsused to create system images. Because installboot(8) can write bootblocks directly to system images, a loop through possible boards cancreate a series of bootable images during the normal build process.In the case of many arm platforms, installboot(8) uses U-Boot bootblocks, which are not part of the NetBSD source code. Developers can,however, install as many U-Boot boot blocks as desired, either in thedefault location of /usr/pkg/share/u-boot or in a set of directoriespointed to by the U-Boot search path, the INSTALLBOOT_UBOOT_PATHSenvironment variable. For each board with an available boot block, aboard-specific bootable image will be created in${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/gzimg. If a boot block isnot available, which is the typical situation currently, no additionalimage will be created.This facility creates opportunities to build bootable images for anynumber of boards within the scope of a standard release build.However, that is not required and will not occur without theintervention of installing U-Boot boot blocks prior to the build. List of files: /netbsd-src/BUILDING Sun, 21 Aug 2022 15:01:08 +0000 brook <brook@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#b9cfee7c5318ea2b1fcfba8a7d66b98f6be54309 BUILDING: regen for removal of extsrc/ List of files: /netbsd-src/BUILDING Sun, 21 Aug 2022 07:12:54 +0000 lukem <lukem@NetBSD.org> http://src.rcs.uwaterloo.ca:8080/history/netbsd-src/BUILDING#7b29bb599061dceffd0b9bd00b4ac714c3010e69 s/knowlege/knowledge/ List of files: /netbsd-src/BUILDING Sat, 28 May 2022 21:54:56 +0000 andvar <andvar@NetBSD.org>