[src/netbsd-1-6]: src Apply patch (requested by jmc in ticket #1578):

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

details:   https://anonhg.NetBSD.org/src/rev/d93efb6e996c
branches:  netbsd-1-6
changeset: 531031:d93efb6e996c
user:      tron <tron%NetBSD.org@localhost>
date:      Thu Dec 18 08:24:52 2003 +0000

description:
Apply patch (requested by jmc in ticket #1578):
Add some examples to BUILDING that correspond as best as possible to the
examples in the doc from -current.

diffstat:

 BUILDING.mdoc |  57 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 56 insertions(+), 1 deletions(-)

diffs (71 lines):

diff -r 0ef780c753fa -r d93efb6e996c BUILDING.mdoc
--- a/BUILDING.mdoc     Wed Dec 17 18:29:22 2003 +0000
+++ b/BUILDING.mdoc     Thu Dec 18 08:24:52 2003 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: BUILDING.mdoc,v 1.18 2002/05/13 01:44:34 lukem Exp $
+.\"    $NetBSD: BUILDING.mdoc,v 1.18.2.1 2003/12/18 08:24:52 tron Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -948,6 +948,61 @@
 .Sy PATH ,
 or called with an absolute path.
 .
+.Sh EXAMPLES
+.
+.Bl -enum
+.
+.It
+.Li "% ./build.sh -U"
+.Pp
+Using unprivileged mode,
+build a complete distribution to a
+.Sy DESTDIR
+directory that
+.Sy build.sh
+selects (and will display).
+.
+.It
+.Li "# ./build.sh -U -d -D /"
+.Pp
+As root, install to
+.Pa /
+a complete distribution.
+Even though this is run as root,
+.Fl U
+is required so that the permissions stored in
+.Sy DESTDIR Ns Pa /METALOG
+are correctly applied to the files as they're copied to
+.Pa / .
+.
+.It
+.Li "% ./build.sh -U -u -R <dir>"
+.Pp
+Using unprivileged mode,
+build a complete release to a
+.Sy DESTDIR
+directory that
+.Sy build.sh 
+selects (and will display), and to a user specified
+.Sy RELEASEDIR .
+.Sy MKUPDATE=yes
+.Pq Fl u
+is set to prevent the
+.Dq make cleandir ,
+so that if this is run after example 1, it doesn't need to redo that
+portion of the release build.
+.
+.It
+.Li "% ./build.sh -t"
+.Pp
+Perform a build that builds and installs the cross tools only. These are
+installed into a
+.Sy TOOLDIR
+directory that
+.Sy build.sh
+selects (and will display).
+.El
+.
 .Sh OBSOLETE VARIABLES
 .
 .Bl -tag -width "NBUILDJOBS"