Subject: Re: misc/29244: share/mk/bsd.README should be merged into BUILDING
To: None <gnats-bugs@NetBSD.org>
From: James Chacon <jmc@NetBSD.org>
Date: 02/06/2005 02:37:44
On Sat, Feb 05, 2005 at 12:34:00PM +0000, Thomas Klausner wrote:
> >Number: 29244
> >Category: misc
> >Synopsis: share/mk/bsd.README should be merged into BUILDING
> >Confidential: no
> >Severity: non-critical
> >Priority: low
> >Responsible: misc-bug-people
> >State: open
> >Class: doc-bug
> >Submitter-Id: net
> >Arrival-Date: Sat Feb 05 12:34:00 +0000 2005
> >Originator: Thomas Klausner
> >Release: NetBSD 2.0
> System: NetBSD dmath5.geometrie.tuwien.ac.at 2.0 NetBSD 2.0 (RAFFAELO) #0: Wed Dec 15 16:47:17 CET 2004 firstname.lastname@example.org:/home/2.0-src/sys/arch/i386/compile/RAFFAELO i386
> Architecture: i386
> Machine: i386
> 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.
> 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.