[src/trunk]: src Expand on the difference between ``build.sh -d'' and ``make ...

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

details:   https://anonhg.NetBSD.org/src/rev/596da34e48d4
branches:  trunk
changeset: 536508:596da34e48d4
user:      fredb <fredb%NetBSD.org@localhost>
date:      Tue Sep 17 16:35:39 2002 +0000

description:
Expand on the difference between ``build.sh -d'' and ``make install'',
as requested by Brian Stark in PR toolchain/18228 (which this closes).

diffstat:

 BUILDING      |  11 +++++++----
 BUILDING.mdoc |  23 +++++++++++++++++++----
 2 files changed, 26 insertions(+), 8 deletions(-)

diffs (74 lines):

diff -r 20fef32b8f51 -r 596da34e48d4 BUILDING
--- a/BUILDING  Tue Sep 17 15:28:28 2002 +0000
+++ b/BUILDING  Tue Sep 17 16:35:39 2002 +0000
@@ -382,6 +382,9 @@
                 fore any system libraries or programs can be built.
 
      install    Install programs, libraries, and documentation into DESTDIR.
+                Few files will be installed to /dev, /etc, /root or /var in
+                order to prevent user supplied configuration data from being
+                overwritten.
 
      lint       Run lint(1) against the C source code, where appropriate, and
                 generate system-installed lint libraries.
@@ -440,10 +443,10 @@
      -b        Bootstrap ``make'' and create a nbmake-MACHINE script (see be-
                low).
 
-     -d        Build a full distribution.  This differs from a normal build in
-               that etc files will also be installed.  Note this does not
-               build a ``release''; no release sets are placed in ${RE-
-               LEASEDIR}.
+     -d        Build a full distribution.  This differs from a default build
+               in that files will also be installed to /dev, /etc, /root and
+               /var.  Note this does not build a ``release''; no release sets
+               are placed in ${RELEASEDIR}.  -d is implied by -R.
 
      -j njob   Passed through to make(1).  Makefiles should use .WAIT or have
                explicit dependancies as necessary to enforce build ordering.
diff -r 20fef32b8f51 -r 596da34e48d4 BUILDING.mdoc
--- a/BUILDING.mdoc     Tue Sep 17 15:28:28 2002 +0000
+++ b/BUILDING.mdoc     Tue Sep 17 16:35:39 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: BUILDING.mdoc,v 1.19 2002/07/22 09:49:05 wiz Exp $
+.\"    $NetBSD: BUILDING.mdoc,v 1.20 2002/09/17 16:35:39 fredb Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -676,7 +676,13 @@
 .It Sy install
 Install programs, libraries, and documentation into
 .Sy DESTDIR .
-.
+Few files will be installed to
+.Pa /dev ,
+.Pa /etc ,
+.Pa /root
+or
+.Pa /var
+in order to prevent user supplied configuration data from being overwritten.
 .It Sy lint
 Run
 .Xr lint 1
@@ -796,10 +802,19 @@
 script (see below).
 .
 .It Sy -d
-Build a full distribution.  This differs from a normal build in that
-etc files will also be installed.  Note this does not build a
+Build a full distribution.
+This differs from a default build in that files will also be installed to
+.Pa /dev ,
+.Pa /etc ,
+.Pa /root
+and
+.Pa /var .
+Note this does not build a
 .Dq release ;
 no release sets are placed in ${RELEASEDIR}.
+.Sy -d
+is implied by
+.Sy -R .
 .
 .It Sy -j Em njob
 Passed through to