>Number:         18695
>Category:       toolchain
>Synopsis:       How to build NetBSD?
>Confidential:   no
>Severity:       critical
>Priority:       low
>Responsible:    toolchain-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Fri Oct 18 08:04:00 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator:     Andrew Cagney
>Release:        1.6
>Organization:
>Environment:
Head of netbsd-1-6 branch.
>Description:
The file src/BUILDING, on netbsd-1-6 branch, doesn't describe the NetBSD build process.  Instead it provides a [really good] reference manual on what MAKE and BUILD.SH options are supported.

Going on-line and digging around and I found:
http://www.netbsd.org/Documentation/cross/
I think this, or equivalent, should be included in the BUILDING file.
- the documentation should be self contained being included in the distro (and not rely on the web)
- not just the usage, but also the process is included in the BUILDING doco

This is especially important given that 1.6's build process is a radical departure from previous builds - build.sh VS make.

(Critical?  I think this is critical because, until I manage a rebuild/install from the head of the 1-6 branch and hence flush out all outstanding security problems, my machine should technically be switched off :-)

enjoy,

>How-To-Repeat:

>Fix:

>Release-Note:
>Audit-Trail:
>Unformatted: