[src/trunk]: src/doc Direct reader to use build.sh for building NetBSD in fav...

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

details:   https://anonhg.NetBSD.org/src/rev/136945c82634
branches:  trunk
changeset: 827246:136945c82634
user:      sevan <sevan%NetBSD.org@localhost>
date:      Sat Oct 21 22:03:01 2017 +0000

description:
Direct reader to use build.sh for building NetBSD in favour of using make directly.
Give an example of why build.sh is better to use.

diffstat:

 doc/BUILDING.mdoc |  12 ++++++++----
 1 files changed, 8 insertions(+), 4 deletions(-)

diffs (34 lines):

diff -r 14b3246661a9 -r 136945c82634 doc/BUILDING.mdoc
--- a/doc/BUILDING.mdoc Sat Oct 21 21:18:33 2017 +0000
+++ b/doc/BUILDING.mdoc Sat Oct 21 22:03:01 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: BUILDING.mdoc,v 1.121 2017/10/21 21:16:07 sevan Exp $
+.\"    $NetBSD: BUILDING.mdoc,v 1.122 2017/10/21 22:03:01 sevan Exp $
 .\"
 .\" Copyright (c) 2001-2011 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -87,9 +87,11 @@
 version of
 .Nx
 .Xr make 1 .
-(For building from out-of-date systems or on a non-native host, see the
+Intended for expert use with knowlege of its shortcomings, it has been superseded
+by the
 .Nm build.sh
-shell script.)
+shell script as the recommended means for building
+.Nx .
 .It Pa UPDATING
 Special notes for updating from an earlier revision of
 .Nx .
@@ -102,7 +104,9 @@
 system from scratch.
 Can be used for both native and cross builds, and should be used instead of
 .Xr make 1
-for any source tree that is updated and recompiled regularly.
+as it performs additional checks to prevent common issues going undetected, such
+as building with an outdated version of
+.Xr make 1 .
 .It Pa crypto/dist/ , dist/ , gnu/dist/
 Sources imported verbatim from third parties, without mangling the
 existing build structure.