Create bootable images in ${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/gzimg.

Release builds for arm platforms create compressed images in
${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/gzimg. However, in some
cases, e.g., armv7.img.gz, they are not bootable. Consequently, boot
blocks must be manually installed in the images, which is an extra
barrier for testing systems or adopting NetBSD. This has prompted
creation of external repositories, e.g., armbsd.org, to host a
collection of bootable images. However, this does not ease the burden
on developers compiling their own systems; for them, manual
installation of boot blocks is still required.

For arm platforms, etc/etc.evbarm/Makefile.inc contains the commands
used to create system images. Because installboot(8) can write boot
blocks directly to system images, a loop through possible boards can
create a series of bootable images during the normal build process.

In the case of many arm platforms, installboot(8) uses U-Boot boot
blocks, which are not part of the NetBSD source code. Developers can,
however, install as many U-Boot boot blocks as desired, either in the
default location of /usr/pkg/share/u-boot or in a set of directories
pointed to by the U-Boot search path, the INSTALLBOOT_UBOOT_PATHS
environment variable. For each board with an available boot block, a
board-specific bootable image will be created in
${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/gzimg. If a boot block is
not available, which is the typical situation currently, no additional
image will be created.

This facility creates opportunities to build bootable images for any
number of boards within the scope of a standard release build.
However, that is not required and will not occur without the
intervention of installing U-Boot boot blocks prior to the build.

Add the missing rescue(8) and tests(7) sets. XXX: this manual is somewhat
broken due to the differences in the archival formats used.

Document xetc.tgz installation set.

Thanks to <wiz> for the review!

Remove workaround for ancient HTML generation code.

branches: 1.36.8;
bump date

fix cksum syntax, CDROM -> CD-ROM, give a specific example of a kernel set
rather than kern.tgz, add dd(1) xref for usb images

branches: 1.34.10;
Fix typo.

Update release(7) for the recent iso -> images change.

branches: 1.32.2; 1.32.4;
PR# install/44593: Please give release ISO's more meaningful names

Change release ISO filenames, what was once 'i386cd.iso' will now look
like 'NetBSD-5.99.60-i386.iso'.

ok snj@

branches: 1.31.6;
Sync with reality.

bump date for previous

mention the new modules.tgz set

New sentence, new line. Use Aq instead of \*[Lt]\*[Gt].

Don't use .Xo/.Xc to workaround ancient groff macro argument limit.
Reduce indentation a bit to make it more readable.

Fix markup

branches: 1.25.4; 1.25.6; 1.25.8; 1.25.10;
Convert TNF licenses to new 2 clause variant

branches: 1.24.6; 1.24.8;
update for iso-image-source

branches: 1.23.4;
Mention the .../iso directory and explain the difference between
it and the .../${MACHINE}/installation/cdrom directory. Discussed in
tech-install.

* Mention that CD-ROM releases don't include the NetBSD-<rel> directory.
* More consistent indentation.

branches: 1.21.4;
Fix typo or mispelling.

branches: 1.20.2;
Change all .Xr config 8 to .Xr config 1, following the recent move of
config from usr.sbin -> usr.bin.

Reviewed by wiz.

Fix mdoc warning reported by Nicolas Joly in PR 29708.

Sync with reality...

- - Clarify how to do multi-platform releases. README, SOURCE_DATE, and
"source" are placed at the root of the heirarchy. Call the heirarchies
in <machine> the "binary releases", to distinguish from the entire
release, which includes source.
- - Split sets are gone.
- - We can now do everything with "./build.sh". Tell how.

I proposed this on tech-install and tech-toolchain, and there were no
objections.

Removed accidental repetitious words.

branches: 1.16.6;
Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

s/seperate/separate/

Fix typos, and formatting fix.

Drop superfluous .Pp.

Improve reference to config 8, and some whitespace fixes.

Describe new shared-set layout: .../shared/$MACHINE_ARCH and .../shared/ALL.

Add description about the "source" dir of a release, based on what's there
for 1.4.2.

remove security/

Add standalone "iso-image" target that can be run with DESTDIR and RELEASEDIR
set in src/etc after a "make release" in both "src" and "xsrc", to create a
ISO-image of the release in $RELEASEDIR/installation/cdrom.

Hook for architecture dependent pre/post-processing in etc/etc.*/Makefile.inc
are available as 'iso-image_md_post' and 'iso-image_md_pre', see
etc/etc.i386/Makefile.inc as an example. Might be useful for setting up
bootable CDs on alpha, sparc, ...

Reviewed by Todd Whitesel and Thomas Klausner.

branches: 1.7.8;
Legalize INSTALL.{html,more,ps,txt}

branches: 1.6.2;
First round of .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.

Assign my copyrights to TNF.

Change occurrences of "UNIX" to .Ux or .At as appropriate.

macroize BSD, NetBSD, FreeBSD and misc cleanup

Fix a typo; s/accomodate/accommodate/

branches: 1.1.2;
Add a document describing the layout of a NetBSD release.