Module Name: src
Committed By: sevan
Date: Sat Oct 21 22:03:01 UTC 2017
Modified Files:
src/doc: BUILDING.mdoc
Log Message:
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.
To generate a diff of this commit:
cvs rdiff -u -r1.121 -r1.122 src/doc/BUILDING.mdoc
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/doc/BUILDING.mdoc
diff -u src/doc/BUILDING.mdoc:1.121 src/doc/BUILDING.mdoc:1.122
--- src/doc/BUILDING.mdoc:1.121 Sat Oct 21 21:16:07 2017
+++ src/doc/BUILDING.mdoc Sat Oct 21 22:03:01 2017
@@ -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 @@ should only be run for native builds wit
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 @@ and the
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.
