On Thu, Jun 26, 2003 at 10:56:30AM -0400, William Allen Simpson wrote:
  | Luke Mewburn wrote:
  | > 
  | > On Wed, Jun 25, 2003 at 09:07:39PM -0400, William Allen Simpson wrote:
  | >   | I'm trying to document the "best practices", and just found that
  | >   |  ./build.sh -O /usr/obj -T /usr/tools -u build >&$HOME/030625c.build
  | >   |
  | >   | But, my real question is, what target should be used to ENSURE that
  | >   | everything is in good order, and install=/ should not fail?
  | > 
  | > "distribution" ?
  | > 
  | A question?  Hmmm.  
  | 
  | So, throughout the documentation, './build.sh  build' should be changed 
  | to './build.sh distribution'?  That does match the proposed building(8) 
  | man page example....

Which documentation specifically?  src/BUILDING, or something else?

  | Shouldn't './build.sh distribution' be the equivalent of 
  | 'make buildworld' (not 'make distribution'), as './build.sh install' 
  | seems to run 'make installworld'?

The only difference between "distribution" and "buildworld" in the
top-level Makefile is that "buildworld" ensures that DESTDIR is set
to the non-root directory (i.e, you can't accidentally build over
your running system with "buildworld").

"./build.sh distribution" also enforces DESTDIR != /.
(i.e., does same check as "make buildworld")

"./build.sh -E distribution" allows DESTDIR = /.
(if you're clueful enough to fix problems that occurred because you
used -E, there's no reason to enforce "buildworld"'s DESTDIR!=/
semantics).