Content-Disposition: inline
Content-Transfer-Encoding: 8bit
Content-Type: text/plain; charset="US-ASCII"
MIME-Version: 1.0
Date: Sun, 11 Jun 2023 20:34:14 +0000
From: "Luke Mewburn" <lukem@netbsd.org>
Subject: CVS commit: src
To: source-changes@NetBSD.org
Approved: for-source-only
Reply-To: lukem@netbsd.org
Message-Id: <20230611203414.E5495FA89@cvs.NetBSD.org>

Module Name:	src
Committed By:	lukem
Date:		Sun Jun 11 20:34:14 UTC 2023

Modified Files:
	src: BUILDING
	src/doc: BUILDING.mdoc

Log Message:
BUILDING: remove duplication from mk.conf(5)

Remove all "make" variables / mk.conf(5) variables already documented
in mk.conf(5).  The duplication was a maintenance headache, as I've
experienced over recent weeks getting the build documentation up to
date.

Add notes clarifying that manual page references are to the NetBSD
manual pages, not to the host manual pages, and how to format from
source, or find online at https://man.netbsd.org.

Add explicit links to the mdoc(7) in-tree source for mk.conf(5),
hier(7), and release(7) because those are directly relevant to the host
build information in BUILDING.

Note: We don't normally need these notes for native documentation,
but BUILDING is intended for users on host systems which might not
be NetBSD(-current).

Add missing defaults.


To generate a diff of this commit:
cvs rdiff -u -r1.154 -r1.155 src/BUILDING
cvs rdiff -u -r1.143 -r1.144 src/doc/BUILDING.mdoc

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.