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.126
retrieving revision 1.133
diff -u -p -r1.126 -r1.133
--- src/BUILDING	2017/04/20 09:47:52	1.126
+++ src/BUILDING	2018/05/02 07:34:44	1.133
@@ -29,8 +29,9 @@ FILES
 
      Makefile       The main Makefile for NetBSD; should only be run for
                     native builds with an appropriately up-to-date version of
-                    NetBSD make(1).  (For building from out-of-date systems or
-                    on a non-native host, see the build.sh shell script.)
+                    NetBSD make(1).  Intended for expert use with knowlege of
+                    its shortcomings, it has been superseded by the build.sh
+                    shell script as the recommended means for building NetBSD.
 
      UPDATING       Special notes for updating from an earlier revision of
                     NetBSD.  It is important to read this file before every
@@ -39,8 +40,9 @@ FILES
      build.sh       Bourne-compatible shell script used for building the host
                     build tools and the NetBSD system from scratch.  Can be
                     used for both native and cross builds, and should be used
-                    instead of make(1) for any source tree that is updated and
-                    recompiled regularly.
+                    instead of make(1) as it performs additional checks to
+                    prevent common issues going undetected, such as building
+                    with an outdated version of make(1).
 
      crypto/dist/, dist/, gnu/dist/
                     Sources imported verbatim from third parties, without
@@ -246,14 +248,6 @@ CONFIGURATION
 
                  Default: "no"
 
-     MKCRYPTO    Can be set to "yes" or "no".  Indicates whether cryptographic
-                 code will be included in a build; provided for the benefit of
-                 countries that do not allow strong cryptography.  Will not
-                 affect use of the standard low-security password encryption
-                 system, crypt(3).
-
-                 Default: "yes"
-
      MKDEBUG     Can be set to "yes" or "no".  Indicates whether debug
                  information should be generated for all userland binaries
                  compiled.  The result is collected as an additional debug.tgz
@@ -347,7 +341,7 @@ CONFIGURATION
                  statically linked.
 
                  Default: Platform dependent.  As of this writing, all
-                 platforms except sh3 default to "yes".
+                 platforms except m68000 default to "yes".
 
      MKPICINSTALL
                  Can be set to "yes" or "no".  Indicates whether the ar(1)
@@ -717,12 +711,11 @@ BUILDING
 
      install-image
                    Create a bootable NetBSD installation disk image in the
-                   RELEASEDIR/RELEASEMACHINEDIR/installation/installimage
-                   directory.  The installation disk image is suitable for
-                   copying to bootable USB flash memory sticks, etc., for
-                   machines which are able to boot from such devices.  The
-                   file system in the bootable disk image will have a layout
-                   as described in release(7).
+                   RELEASEDIR/images directory.  The installation disk image
+                   is suitable for copying to bootable USB flash memory
+                   sticks, etc., for machines which are able to boot from such
+                   devices.  The file system in the bootable disk image will
+                   have a layout as described in release(7).
 
                    The installation image is bootable, and will automatically
                    run the sysinst(8) menu-based installation program, which
@@ -884,7 +877,7 @@ BUILDING
                    MACHINE/MACHINE_ARCH pairs, and then exits.  The -m or -a
                    options (or both) may be used to specify glob patterns that
                    will be used to narrow the list of results; for example,
-                   "build.sh -m 'evm*' -a '*arm*' list-arch" will list all
+                   "build.sh -m 'evb*' -a '*arm*' list-arch" will list all
                    known MACHINE/MACHINE_ARCH values in which either MACHINE
                    or ALIAS matches the pattern `evb*', and MACHINE_ARCH
                    matches the pattern `*arm*'.
@@ -1119,4 +1112,4 @@ CAVEATS
      in object directories.  Instead, one may have to manually remove the
      files.  Consult the UPDATING file for notices concerning this.
 
-NetBSD                          April 13, 2017                          NetBSD
+NetBSD                         October 21, 2017                         NetBSD