[src/trunk]: src Various improvements per discussion with Alan Barrett.

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

details:   https://anonhg.NetBSD.org/src/rev/aa92abc61d6d
branches:  trunk
changeset: 542314:aa92abc61d6d
user:      lukem <lukem%NetBSD.org@localhost>
date:      Sun Jan 26 13:15:17 2003 +0000

description:
Various improvements per discussion with Alan Barrett.

diffstat:

 BUILDING          |  36 ++++++++++++++++++------------------
 doc/BUILDING.mdoc |  44 +++++++++++++++++++++++---------------------
 2 files changed, 41 insertions(+), 39 deletions(-)

diffs (157 lines):

diff -r 0279fe43c1b9 -r aa92abc61d6d BUILDING
--- a/BUILDING  Sun Jan 26 13:12:05 2003 +0000
+++ b/BUILDING  Sun Jan 26 13:15:17 2003 +0000
@@ -424,21 +424,22 @@
                    Note: It is highly recommended that you upgrade your kernel
                    and reboot before performing this operation.
 
+     sets          Create distribution sets from DESTDIR into
+                   RELEASEDIR/MACHINE/binary/sets.  Should be run after ``make
+                   distribution'' (as ``make build'' does not install all of
+                   the required files).
+
      release       Do a ``make distribution'', build kernels, distribution me-
-                   dia, and install sets, and then package the system into a
-                   standard release layout as described by release(7).  This
-                   requires that RELEASEDIR be set (see above).
+                   dia, and install sets (this as per ``make sets''), and then
+                   package the system into a standard release layout as de-
+                   scribed by release(7).  This requires that RELEASEDIR be
+                   set (see above).
 
      regression-tests
                    Can only be run after building the regression tests in the
                    directory ``regress''.  Runs the compiled regression tests
                    on the local host.
 
-     sets          Create distribution sets from DESTDIR into
-                   RELEASEDIR/MACHINE/binary/sets.  Should be run after ``make
-                   distribution'' (as ``make build'' does not install all of
-                   the required files).
-
    The "build.sh" script
      This script file is a Bourne shell script designed to build the entire
      NetBSD system on any host with a Bourne shell in /bin/sh, including many
@@ -573,23 +574,22 @@
 EXAMPLES
      ./build.sh tools kernel=GENERIC
                Build a new toolchain, and use the new toolchain to configure
-               and build a new GENERIC kernel.  This is a simpler way to
-               achieve what the first three examples do.
+               and build a new GENERIC kernel.
 
-     ./build.sh -U -D /some/DESTDIR distribution
+     ./build.sh -U -D /path/to/DESTDIR distribution
                Using unprivileged mode, build a complete distribution in
-               /some/DESTDIR.
+               /path/to/DESTDIR.
 
-     # ./build.sh -U -D /some/DESTDIR installworld=/
+     # ./build.sh -U -D /path/to/DESTDIR installworld=/
                As root, install the distribution that was built with unprivi-
-               leged mode from /some/DESTDIR to /.  (Even though this is run
-               as root, -U is required so that the permissions stored in
-               /some/DESTDIR/METALOG are correctly applied to the files as
+               leged mode from /path/to/DESTDIR to /.  (Even though this is
+               run as root, -U is required so that the permissions stored in
+               /path/to/DESTDIR/METALOG are correctly applied to the files as
                they're copied to /).
 
-     ./build.sh -U -D /some/dir/DESTDIR -R /some/dir/RELEASE release
+     ./build.sh -U -D /path/to/DESTDIR -R /path/to/RELEASE release
                Using unprivileged mode, build a complete release in
-               /some/dir/RELEASE.
+               /path/to/dir/RELEASE.
 
 OBSOLETE VARIABLES
      NBUILDJOBS  Use the make(1) option -j, instead.
diff -r 0279fe43c1b9 -r aa92abc61d6d doc/BUILDING.mdoc
--- a/doc/BUILDING.mdoc Sun Jan 26 13:12:05 2003 +0000
+++ b/doc/BUILDING.mdoc Sun Jan 26 13:15:17 2003 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: BUILDING.mdoc,v 1.11 2003/01/26 06:19:14 lukem Exp $
+.\"    $NetBSD: BUILDING.mdoc,v 1.12 2003/01/26 13:15:17 lukem Exp $
 .\"
 .\" Copyright (c) 2001-2003 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -783,10 +783,24 @@
 It is highly recommended that you upgrade your kernel and reboot
 before performing this operation.
 .
+.It Sy sets
+Create distribution sets from
+.Sy DESTDIR
+into
+.Sy RELEASEDIR Ns Pa /MACHINE/binary/sets .
+Should be run after
+.Dq make distribution
+(as
+.Dq make build
+does not install all of the required files).
+.
 .It Sy release
 Do a
 .Dq make distribution ,
-build kernels, distribution media, and install sets, and
+build kernels, distribution media, and install sets
+(this as per
+.Dq make sets ) ,
+and
 then package the system into a standard release layout as described by
 .Xr release 7 .
 This requires that
@@ -798,17 +812,6 @@
 .Dq regress .
 Runs the compiled regression tests on the local host.
 .
-.It Sy sets
-Create distribution sets from
-.Sy DESTDIR
-into
-.Sy RELEASEDIR Ns Pa /MACHINE/binary/sets .
-Should be run after
-.Dq make distribution
-(as
-.Dq make build
-does not install all of the required files).
-.
 .El
 .
 .Ss The \*qbuild.sh\*q script
@@ -1128,29 +1131,28 @@
 .It Li "./build.sh tools kernel=GENERIC"
 Build a new toolchain, and use the new toolchain to
 configure and build a new GENERIC kernel.
-This is a simpler way to achieve what the first three examples do.
 .
-.It Li "./build.sh -U -D /some/DESTDIR distribution"
+.It Li "./build.sh -U -D /path/to/DESTDIR distribution"
 Using unprivileged mode,
 build a complete distribution in
-.Pa /some/DESTDIR .
+.Pa /path/to/DESTDIR .
 .
-.It Li "# ./build.sh -U -D /some/DESTDIR installworld=/"
+.It Li "# ./build.sh -U -D /path/to/DESTDIR installworld=/"
 As root, install the distribution that was built with unprivileged mode from
-.Pa /some/DESTDIR
+.Pa /path/to/DESTDIR
 to
 .Pa / .
 (Even though this is run as root,
 .Fl U
 is required so that the permissions stored in
-.Pa /some/DESTDIR/METALOG
+.Pa /path/to/DESTDIR/METALOG
 are correctly applied to the files as they're copied to
 .Pa / ) .
 .
-.It Li "./build.sh -U -D /some/dir/DESTDIR -R /some/dir/RELEASE release"
+.It Li "./build.sh -U -D /path/to/DESTDIR -R /path/to/RELEASE release"
 Using unprivileged mode,
 build a complete release in
-.Pa /some/dir/RELEASE .
+.Pa /path/to/dir/RELEASE .
 .El
 .
 .Sh OBSOLETE VARIABLES