[src/trunk]: src Revisions 1.92 and 1.93 of src/BUILDING were not reflected in

[apb <apb%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/e21f7da605d6
branches:  trunk
changeset: 769424:e21f7da605d6
user:      apb <apb%NetBSD.org@localhost>
date:      Fri Sep 09 14:01:28 2011 +0000

description:
Revisions 1.92 and 1.93 of src/BUILDING were not reflected in
src/doc/BUILDING.mdoc, so those changes were lost when src/BUILDING
was regenerated in revision 1.94.

Now update src/doc/BUILDING.mdoc and regenerate src/BUILDING to
reinstate the lost changes.  (I also edited one of the changes, to use
the phrase "space-separated list" for consistency with other parts of
the document.)

The original changes were:
----------------------------
revision 1.93
date: 2011/08/06 19:52:49;  author: jnemeth;  state: Exp;  lines: +5 -0
Add description of MKKMOD, part of PR misc/45216
----------------------------
revision 1.92
date: 2011/01/29 16:56:26;  author: jym;  state: Exp;  lines: +6 -4
Pass down INSTALLSETS variable to installsets target. Use :Q to escape
shell meta-characters, as the variable contains a list of sets, separated
by spaces.

$ ./build.sh -V INSTALLSETS="base etc" install=idir

should now work as expected.

Reviewed by apb@ on tech-toolchain.
----------------------------

diffstat:

 BUILDING          |  17 ++++++++++++-----
 doc/BUILDING.mdoc |  12 +++++++++---
 2 files changed, 21 insertions(+), 8 deletions(-)

diffs (81 lines):

diff -r 45c173ac635d -r e21f7da605d6 BUILDING
--- a/BUILDING  Fri Sep 09 14:00:01 2011 +0000
+++ b/BUILDING  Fri Sep 09 14:01:28 2011 +0000
@@ -236,6 +236,11 @@
 
                  Default: ``yes''
 
+     MKKMOD      Can be set to ``yes'' or ``no''.  Indicates whether kernel
+                 modules are built and installed.
+
+                 Default: ``yes''
+
      MKLINT      Can be set to ``yes'' or ``no''.  Indicates whether lint(1)
                  will be run against portions of the NetBSD source code during
                  the build, and whether lint libraries will be installed into
@@ -530,10 +535,11 @@
                    INSTALLWORLDDIR is not the root directory if cross compil-
                    ing.
 
-                   The INSTALLSETS environment variable may be set to a list
-                   of distribution sets to be installed.  By default, all sets
-                   except ``etc'' and ``xetc'' are installed, so most files in
-                   INSTALLWORLDDIR/etc will not be installed or modified.
+                   The INSTALLSETS environment variable may be set to a space-
+                   separated list of distribution sets to be installed.  By
+                   default, all sets except ``etc'' and ``xetc'' are
+                   installed, so most files in INSTALLWORLDDIR/etc will not be
+                   installed or modified.
 
                    Note: Before performing this operation with
                    INSTALLWORLDDIR=/, it is highly recommended that you
@@ -667,7 +673,8 @@
 
      install=idir  Install the contents of DESTDIR to idir, using ``make
                    installworld''.  Note that files that are part of the
-                   ``etc'' or ``xetc'' sets will not be installed.
+                   ``etc'' or ``xetc'' sets will not be installed, unless
+                   overridden by the INSTALLSETS environment variable.
 
      kernel=kconf  Build a new kernel.  The kconf argument is the name of a
                    configuration file suitable for use by config(1).  If kconf
diff -r 45c173ac635d -r e21f7da605d6 doc/BUILDING.mdoc
--- a/doc/BUILDING.mdoc Fri Sep 09 14:00:01 2011 +0000
+++ b/doc/BUILDING.mdoc Fri Sep 09 14:01:28 2011 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: BUILDING.mdoc,v 1.82 2011/09/09 13:29:23 apb Exp $
+.\"    $NetBSD: BUILDING.mdoc,v 1.83 2011/09/09 14:01:28 apb Exp $
 .\"
 .\" Copyright (c) 2001-2011 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -468,6 +468,11 @@
 build.
 .DFLTy
 .
+.It Sy MKKMOD
+.YorN
+Indicates whether kernel modules are built and installed.
+.DFLTy
+.
 .It Sy MKLINT
 .YorN
 Indicates whether
@@ -990,7 +995,7 @@
 .Pp
 The
 .Sy INSTALLSETS
-environment variable may be set to a list of
+environment variable may be set to a space-separated list of
 distribution sets to be installed.
 By default, all sets except
 .Dq etc
@@ -1261,7 +1266,8 @@
 .Dq etc
 or
 .Dq xetc
-sets will not be installed.
+sets will not be installed, unless overridden by
+the INSTALLSETS environment variable.
 .
 .It Sy kernel Ns = Ns Ar kconf
 Build a new kernel.