The following reply was made to PR misc/29244; it has been noted by GNATS.

From: Thomas Klausner <wiz@NetBSD.org>
To: gnats-bugs@NetBSD.org
Cc: jmc@NetBSD.org
Subject: Re: misc/29244: share/mk/bsd.README should be merged into BUILDING
Date: Mon, 7 Feb 2005 15:32:07 +0100

 On Sun, Feb 06, 2005 at 02:37:44AM -0600, James Chacon wrote:
 > On Sat, Feb 05, 2005 at 12:34:00PM +0000, Thomas Klausner wrote:
 > > share/mk/bsd.README documents some flags that are not documented
 > > in BUILDING, but should be.
 > > 
 > > There is no point in having two places to document the same stuff, so
 > > bsd.README should probably be merged into BUILDING.
 > > >How-To-Repeat:
 > > Read both, and note that e.g. MKHTML is in the former but not the latter.
 > 
 > I disagree they should be merged into BUILDING. bsd.README includes more
 > than just the build flags for the system. It's also describing in good
 > detail how all the various .mk files interact/work for the targets they
 > expose. This isn't needed in BUILDING and will just clutter it up.
 
 Hm, that part really shouldn't be there. In any case, the flags
 should be documented in BUILDING. I'm not sure if they should be
 removed from bsd.README afterwards (it can just point to BUILDING).
  Thomas