Subject: Re: iso-image
To: NetBSD-current Users's Discussion List <current-users@netbsd.org>
From: Greg A. Woods <woods@planix.com>
List: current-users
Date: 04/01/2007 14:06:30
--pgp-sign-Multipart_Sun_Apr__1_14:06:28_2007-1
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: quoted-printable

At Sun, 1 Apr 2007 13:27:06 +0200, Alan Barrett wrote:
Subject: Re: iso-image
>=20
> Does the following patch to BUILDING.mdoc look accurate?
>=20
> --apb (Alan Barrett)
>=20
> Index: src/doc/BUILDING.mdoc
> =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
> --- doc/BUILDING.mdoc	26 Mar 2007 17:35:06 -0000	1.48
> +++ doc/BUILDING.mdoc	1 Apr 2007 11:23:31 -0000
> @@ -952,17 +952,33 @@
>  be set (see above).
>  .
>  .It iso-image
> -Create a CD-ROM image in
> -.Sy RELEASEDIR/MACHINE Ns Pa /installation/cdrom .
> -RELEASEDIR must already have been populated by
> +Create a
> +.Nx
> +installation CD-ROM image in the
> +.Sy RELEASEDIR Ns Pa /iso
> +directory.
> +A CD-ROM created from the image should be bootable, and
> +contains everything needed to install or upgrade a
> +.Nx
> +system
> +(distribution sets, kernels, the
> +.Xr sysinst
> +menu-based installation program),
> +as well as tools that are intended to be useful to repair a damaged syst=
em.
> +.Pp
> +Note that other, smaller, CD-ROM images may be created in the
> +.Sy RELEASEDIR/MACHINE Ns Pa /installation/cdrom
> +directory by
> +.Dq "make release" .
> +These smaller images contain the same tools as the larger images in
> +.Sy RELEASEDIR Ns Pa /iso ,
> +but do not contain additional content such as the distribution sets.
> +.Pp
> +Before
> +.Dq make iso-image
> +is attempted, RELEASEDIR must be populated by
>  .Dq make release
>  or equivalent.

AH HA!  So it wasn't a mistake that the "old" iso-image and the new
iso_image targets in etc/Makefile still both did something!

At first it seemed to me that (at least on the netbsd-4 branch) someone
had forgot to clean up the old mess.

It would be nice if the internal comments in the Makefiles (and maybe in
build.sh itself too) were also updated to reflect the reality of what
the code actually does.

--=20
						Greg A. Woods

H:+1 416 218-0098 W:+1 416 489-5852 x122 VE3TCP RoboHack <woods@robohack.ca>
Planix, Inc. <woods@planix.com>       Secrets of the Weird <woods@weird.com>

--pgp-sign-Multipart_Sun_Apr__1_14:06:28_2007-1
Content-Type: application/pgp-signature
Content-Transfer-Encoding: 7bit

-----BEGIN PGP SIGNATURE-----
Version: PGPfreeware 5.0i for non-commercial use
MessageID: sRMKwcp9MUOFbj8ScJ3SvCKT3YDdk+RB

iQA/AwUBRg/0pWZ9cbd4v/R/EQJDFgCguHg3jP08bT5CbF6OoLaTmdAECnQAn054
oHcBqRkEB1W9Pxt7hDaNWUAx
=zWu6
-----END PGP SIGNATURE-----

--pgp-sign-Multipart_Sun_Apr__1_14:06:28_2007-1--