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.59.2.3
retrieving revision 1.65
diff -u -p -r1.59.2.3 -r1.65
--- src/BUILDING	2007/09/29 11:10:56	1.59.2.3
+++ src/BUILDING	2007/09/01 08:15:27	1.65
@@ -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
@@ -642,6 +627,12 @@ BUILDING
      iso-image-source
                    Perform ``make iso-image-source''.
 
+     iso-dir=directory
+                   When combined with ``iso-image'' or ``iso-image-source'',
+                   it will cause directory to be added to the CD-ROM image.
+                   If directory does not start with ``/'' then it will be made
+                   relative to RELEASEDIR.
+
      The following command line options alter the behaviour of the build.sh
      operations described above:
 
@@ -653,12 +644,6 @@ 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.
@@ -682,18 +667,21 @@ BUILDING
                it will be converted to an absolute path before being used.
                Unsets MAKEOBJDIR.
 
-     -m mach   Set the value of MACHINE to mach.  This will also override any
-               value of MACHINE_ARCH in the process environment with a value
-               deduced from mach, unless -a is specified, or mach is a special
-               case listed below.  All cross builds require -m, but if unset
-               on a NetBSD host, the host's value of MACHINE will be detected
-               and used automatically.
-
-               Some machines support multiple values for MACHINE_ARCH.  For a
-               given value of mach, the following MACHINE and MACHINE_ARCH
-               values will result:
+     -m mach   Set the value of MACHINE to mach, except in some special cases
+               listed below.  This will also override any value of
+               MACHINE_ARCH in the process environment with a value deduced
+               from mach, unless -a is specified.  All cross builds require
+               -m, but if unset on a NetBSD host, the host's value of MACHINE
+               will be detected and used automatically.
+
+               Some machines support multiple values for MACHINE_ARCH.  The
+               following special cases for the mach argument are defined to
+               set the listed values of MACHINE and MACHINE_ARCH:
 
                      mach          MACHINE    MACHINE_ARCH
+                     evbarm        evbarm     (not set)
+                     evbarm-eb     evbarm     armeb
+                     evbarm-el     evbarm     arm
                      evbmips       evbmips    (not set)
                      evbmips-eb    evbmips    mipseb
                      evbmips-el    evbmips    mipsel