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/BUILDING,v
rcsdiff: /ftp/cvs/cvsroot/src/BUILDING,v: warning: Unknown phrases like `commitid ...;' are present.
retrieving revision 1.62
retrieving revision 1.62.4.1
diff -u -p -r1.62 -r1.62.4.1
--- src/BUILDING	2007/04/13 19:43:38	1.62
+++ src/BUILDING	2007/11/06 23:07:09	1.62.4.1
@@ -3,21 +3,6 @@ BUILDING(8)             NetBSD System Ma
 NAME
      BUILDING -- Procedure for building NetBSD from source code.
 
-STATUS
-     This document is a work-in-progress.  As such, the information described
-     here may not match the reality of the build system as of this writing.
-     Once this document is completely in sync with reality, this paragraph
-     will be removed.
-
-     Discrepancies between this documentation and the current reality of
-     implementation are noted specially, as with the note below:
-
-     Note: This document applies only to platforms which use the new toolchain
-     as indicated by the default setting of TOOLCHAIN_MISSING in <bsd.own.mk>.
-     Platforms which have not yet been switched to the new toolchain should
-     continue building traditionally, using the notes specified in the file
-     UPDATING.
-
 REQUIREMENTS
      NetBSD is designed to be buildable on most POSIX-compliant host systems.
      The basic build procedure is the same whether compiling natively (on the
@@ -542,6 +527,34 @@ BUILDING
                    ity, which is not part of NetBSD, but which can be
                    installed from pkgsrc/sysutils/cdrtools.
 
+     iso-image-source
+                   Create a NetBSD installation CD-ROM image in the
+                   RELEASEDIR/iso directory.  The CD-ROM file system will have
+                   a layout as described in release(7).  It will have top
+                   level directories for the machine type and source.
+
+                   For most machine types, the CD-ROM will be bootable, and
+                   will automatically run the sysinst(8) menu-based installa-
+                   tion program, which can be used to install or upgrade a
+                   NetBSD system.  Bootable CD-ROMs also contain tools that
+                   may be useful in repairing a damaged NetBSD installation.
+
+                   Before ``make iso-image-source'' is attempted, RELEASEDIR
+                   must be populated by ``make sourcesets release'' or equiva-
+                   lent.
+
+                   Note that other, smaller, CD-ROM images may be created in
+                   the RELEASEDIR/MACHINE/installation/cdrom directory by
+                   ``make release''.  These smaller images usually contain the
+                   same tools as the larger images in RELEASEDIR/iso, but do
+                   not contain additional content such as the distribution
+                   sets.
+
+                   Note that the mac68k port still uses an older method of
+                   creating CD-ROM images.  This requires the mkisofs(1) util-
+                   ity, which is not part of NetBSD, but which can be
+                   installed from pkgsrc/sysutils/cdrtools.
+
      regression-tests
                    Can only be run after building the regression tests in the
                    directory ``regress''.  Runs the compiled regression tests
@@ -611,6 +624,9 @@ BUILDING
 
      iso-image     Perform ``make iso-image''.
 
+     iso-image-source
+                   Perform ``make iso-image-source''.
+
      The following command line options alter the behaviour of the build.sh
      operations described above:
 
@@ -622,6 +638,12 @@ BUILDING
                that the resulting name is of the form
                ``nbmake-MACHINE-BUILDID''.
 
+     -C cddir  Set the value of CDEXTRA to cddir.  If a relative path is spec-
+               ified, it will be converted to an absolute path before being
+               used.  When combined with ``iso-image'' or
+               ``iso-image-source'', it will cause the contents of cddir to be
+               added to the CD-ROM image.
+
      -D dest   Set the value of DESTDIR to dest.  If a relative path is speci-
                fied, it will be converted to an absolute path before being
                used.
@@ -786,4 +808,4 @@ HISTORY
 BUGS
      A few platforms are not yet using this build system.
 
-NetBSD                          April 13, 2007                          NetBSD
+NetBSD                         September 1, 2007                        NetBSD