Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

===================================================================
RCS file: /ftp/cvs/cvsroot/src/doc/BUILDING.mdoc,v
rcsdiff: /ftp/cvs/cvsroot/src/doc/BUILDING.mdoc,v: warning: Unknown phrases like `commitid ...;' are present.
retrieving revision 1.50
retrieving revision 1.51
diff -u -p -r1.50 -r1.51
--- src/doc/BUILDING.mdoc	2007/08/30 00:35:11	1.50
+++ src/doc/BUILDING.mdoc	2007/08/30 10:29:02	1.51
@@ -1,4 +1,4 @@
-.\"	$NetBSD: BUILDING.mdoc,v 1.50 2007/08/30 00:35:11 ad Exp $
+.\"	$NetBSD: BUILDING.mdoc,v 1.51 2007/08/30 10:29:02 jnemeth Exp $
 .\"
 .\" Copyright (c) 2001-2007 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -40,7 +40,7 @@
 .\" Toolchain prefix for commands
 .ds toolprefix nb
 .
-.Dd April 13, 2007
+.Dd August 30, 2007
 .Dt BUILDING 8
 .Os NetBSD
 .
@@ -973,6 +973,50 @@ utility, which is not part of
 but which can be installed from
 .Pa pkgsrc/sysutils/cdrtools .
 .
+.It iso-image-source
+Create a
+.Nx
+installation CD-ROM image in the
+.Sy RELEASEDIR Ns Pa /iso
+directory.
+The CD-ROM file system will have a layout as described in
+.Xr release 7 .
+It will have top level directories for the machine type and source.
+.Pp
+For most machine types, the CD-ROM will be bootable, and will automatically
+run the
+.Xr sysinst 8
+menu-based installation program, which can be used to install or upgrade a
+.Nx
+system.
+Bootable CD-ROMs also contain tools that may be useful in
+repairing a damaged
+.Nx
+installation.
+.Pp
+Before
+.Dq make iso-image-source
+is attempted, RELEASEDIR must be populated by
+.Dq make sourcesets release
+or equivalent.
+.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 usually 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
+Note that the mac68k port still uses an older method of creating
+CD-ROM images.
+This requires the
+.Xr mkisofs 1
+utility, which is not part of
+.Nx ,
+but which can be installed from
+.Pa pkgsrc/sysutils/cdrtools .
+.
 .It Sy regression-tests
 Can only be run after building the regression tests in the directory
 .Dq regress .