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.11
retrieving revision 1.12.2.2
diff -u -p -r1.11 -r1.12.2.2
--- src/BUILDING	2002/05/03 08:59:13	1.11
+++ src/BUILDING	2003/12/24 04:52:17	1.12.2.2
@@ -346,7 +346,7 @@ BUILDING
                 actually execute them.  This will still cause recursion to
                 take place.
 
-     -v var     Print make(1)'s idea of the value of var.  Does not build any
+     -V var     Print make(1)'s idea of the value of var.  Does not build any
                 targets.
 
      var=value  Set the variable var to value, overriding any setting speci-
@@ -479,6 +479,8 @@ BUILDING
 
      -D dest   Set the value of DESTDIR to dest.
 
+     -M obj    Set MAKEOBJDIRPREFIX to obj.
+
      -O obj    Create an appropriate transform macro for MAKEOBJDIR that will
                place the built object files under obj.  For instance, a set-
                ting of /usr/obj will place build-time files files under
@@ -505,6 +507,33 @@ BUILDING
      This script can be symlinked into a directory listed in PATH, or called
      with an absolute path.
 
+EXAMPLES
+     1.   % ./build.sh -U
+
+          Using unprivileged mode, build a complete distribution to a DESTDIR
+          directory that build.sh selects (and will display).
+
+     2.   # ./build.sh -U -d -D /
+
+          As root, install to / a complete distribution.  Even though this is
+          run as root, -U is required so that the permissions stored in
+          DESTDIR/METALOG are correctly applied to the files as they're copied
+          to /.
+
+     3.   % ./build.sh -U -u -R <dir>
+
+          Using unprivileged mode, build a complete release to a DESTDIR di-
+          rectory that build.sh selects (and will display), and to a user
+          specified RELEASEDIR.  MKUPDATE=yes (-u) is set to prevent the
+          ``make cleandir'', so that if this is run after example 1, it
+          doesn't need to redo that portion of the release build.
+
+     4.   % ./build.sh -t
+
+          Perform a build that builds and installs the cross tools only. These
+          are installed into a TOOLDIR directory that build.sh selects (and
+          will display).
+
 OBSOLETE VARIABLES
      NBUILDJOBS  Now obsolete.  Use the make(1) option -j, instead.
 
@@ -518,4 +547,4 @@ HISTORY
 BUGS
      A few platforms are not yet using the USE_NEW_TOOLCHAIN system.
 
-NetBSD                            May 3, 2002                                8
+NetBSD                           Dec 23, 2003                                9