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.28
retrieving revision 1.31
diff -u -p -r1.28 -r1.31
--- src/BUILDING	2003/02/02 12:37:41	1.28
+++ src/BUILDING	2003/05/10 07:12:37	1.31
@@ -132,6 +132,9 @@ CONFIGURATION
                  Default: Empty string if USETOOLS is ``yes''; unset other-
                  wise.
 
+                 Note: build.sh will provide a default of destdir.MACHINE (in
+                 the top-level .OBJDIR) unless run in `expert' mode
+
      MAKECONF    The name of the make(1) configuration file.  Only settable in
                  the process environment.
 
@@ -328,6 +331,9 @@ CONFIGURATION
 
                       Default: Unset.
 
+                      Note: build.sh will provide a default of releasedir (in
+                      the top-level .OBJDIR) unless run in `expert' mode
+
      UPDATE           If set, then in addition to the effects described for
                       UPDATE above, this implies the effects of NOCLEANDIR
                       (i.e., ``make cleandir'' is avoided).
@@ -430,6 +436,9 @@ BUILDING
                    distribution'' (as ``make build'' does not install all of
                    the required files).
 
+     sourcesets    Create source sets of the source tree into
+                   RELEASEDIR/source/sets.
+
      release       Do a ``make distribution'', build kernels, distribution me-
                    dia, and install sets (this as per ``make sets''), and then
                    package the system into a standard release layout as de-
@@ -492,6 +501,8 @@ BUILDING
 
      sets          Perform ``make sets''.
 
+     sourcesets    Perform ``make sourcesets''.
+
      The following command line options alter the behaviour of the above oper-
      ations: The following command line options alter the behaviour of the
      build.sh operations described above:
@@ -578,24 +589,25 @@ EXAMPLES
           Build a new toolchain, and use the new toolchain to configure and
           build a new GENERIC kernel.
 
-     2.   ./build.sh -U -D /path/to/destdir distribution
+     2.   ./build.sh -U distribution
 
-          Using unprivileged mode, build a complete distribution in
-          /path/to/destdir.
+          Using unprivileged mode, build a complete distribution to a DESTDIR
+          directory that build.sh selects (and will display).
 
-     3.   # ./build.sh -U -D /path/to/destdir installworld=/
+     3.   # ./build.sh -U install=/
 
-          As root, install the distribution that was built by example 2 into
-          /path/to/destdir to /.  Even though this is run as root, -U is re-
-          quired so that the permissions stored in /path/to/destdir/METALOG
-          are correctly applied to the files as they're copied to /.
+          As root, install to / the distribution that was built by example 2.
+          Even though this is run as root, -U is required so that the permis-
+          sions stored in DESTDIR/METALOG are correctly applied to the files
+          as they're copied to /.
 
-     4.   ./build.sh -U -u -D /path/to/destdir -R /path/to/releasedir release
+     4.   ./build.sh -U -u release
 
-          Using unprivileged mode, build a complete release in
-          /path/to/dir/releasedir.  UPDATE (-u) is set to prevent the ``make
-          cleandir'', so that if this is run after example 2, it doesn't need
-          to redo that portion of the release build.
+          Using unprivileged mode, build a complete release to DESTDIR and
+          RELEASEDIR directories that build.sh selects (and will display).
+          UPDATE (-u) is set to prevent the ``make cleandir'', so that if this
+          is run after example 2, it doesn't need to redo that portion of the
+          release build.
 
 OBSOLETE VARIABLES
      NBUILDJOBS  Use the make(1) option -j, instead.
@@ -614,4 +626,4 @@ HISTORY
 BUGS
      A few platforms are not yet using this build system.
 
-NetBSD                         February 2, 2003                             10
+NetBSD                            May 8, 2003                               10