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

===================================================================
RCS file: /ftp/cvs/cvsroot/src/Makefile,v
rcsdiff: /ftp/cvs/cvsroot/src/Makefile,v: warning: Unknown phrases like `commitid ...;' are present.
retrieving revision 1.124
retrieving revision 1.242
diff -u -p -r1.124 -r1.242
--- src/Makefile	2001/06/10 13:12:32	1.124
+++ src/Makefile	2006/01/21 19:01:15	1.242
@@ -1,8 +1,9 @@
-#	$NetBSD: Makefile,v 1.124 2001/06/10 13:12:32 mrg Exp $
+#	$NetBSD: Makefile,v 1.242 2006/01/21 19:01:15 dsl Exp $
 
+#
 # This is the top-level makefile for building NetBSD. For an outline of
 # how to build a snapshot or release, as well as other release engineering
-# information, see http://www.netbsd.org/developers/releng/index.html
+# information, see http://www.NetBSD.org/developers/releng/index.html
 #
 # Not everything you can set or do is documented in this makefile. In
 # particular, you should review the files in /usr/share/mk (especially
@@ -18,214 +19,381 @@
 #   DESTDIR is the target directory for installation of the compiled
 #	software. It defaults to /. Note that programs are built against
 #	libraries installed in DESTDIR.
-#   MKMAN, if set to `no', will prevent building of manual pages.
-#   MKOBJDIRS, if not set to `no', will build object directories at 
+#   MKMAN, if `no', will prevent building of manual pages.
+#   MKOBJDIRS, if not `no', will build object directories at
 #	an appropriate point in a build.
-#   MKSHARE, if set to `no', will prevent building and installing
+#   MKSHARE, if `no', will prevent building and installing
 #	anything in /usr/share.
-#   NBUILDJOBS is the number of jobs to start in parallel during a
-#	'make build'. It defaults to 1.
-#   UPDATE will avoid a `make cleandir' at the start of `make build',
-#	as well as having the effects listed in /usr/share/mk/bsd.README.
-#   NOCLEANDIR will avoid a `make cleandir' at the start of `make build',
-#	but without having the effects listed in /usr/share/mk/bsd.README.
+#   MKUPDATE, if not `no', will avoid a `make cleandir' at the start of
+#	`make build', as well as having the effects listed in
+#	/usr/share/mk/bsd.README.
+#   NOCLEANDIR, if defined, will avoid a `make cleandir' at the start
+#	of the `make build'.
 #   NOINCLUDES will avoid the `make includes' usually done by `make build'.
 #
+#   See mk.conf(5) for more details.
+#
+#
 # Targets:
-#   build: builds a full release of netbsd in DESTDIR. If BUILD_DONE is
-#	set, this is an empty target.
-#   release: does a `make build,' and then tars up the DESTDIR files
-#	into RELEASEDIR, in release(7) format. (See etc/Makefile for
-#	more information on this.)
-#   snapshot: a synonym for release.
-#
-# Sub targets of `make build,' in order:
-#   buildstartmsg: displays the start time of the build.
-#   beforeinstall: creates the distribution directories.
-#   do-force-domestic: check's that FORCE_DOMESTIC isn't set (deprecated.)
-#   do-share-mk: installs /usr/share/mk files.
-#   do-cleandir: clean's the tree.
-#   do-make-obj: create's object directories if required.
-#   do-check-egcs: check's that we have a modern enough compiler (deprecated.)
-#   do-make-includes: install include files.
-#   do-lib-csu: build & install startup object files.
-#   do-lib: build & install system libraries.
-#   do-gnu-lib: build & install gnu system libraries.
-#   do-dependall: builds & install the entire system.
-#   do-domestic: build & install the domestic tree (deprecated.)
-#   do-whatisdb: build & install the `whatis.db' man database.
-#   buildendmsg: displays the end time of the build.
+#   build:
+#	Builds a full release of NetBSD in DESTDIR, except for the
+#	/etc configuration files.
+#	If BUILD_DONE is set, this is an empty target.
+#   distribution:
+#	Builds a full release of NetBSD in DESTDIR, including the /etc
+#	configuration files.
+#   buildworld:
+#	As per `make distribution', except that it ensures that DESTDIR
+#	is not the root directory.
+#   installworld:
+#	Install the distribution from DESTDIR to INSTALLWORLDDIR (which
+#	defaults to the root directory).  Ensures that INSTALLWORLDDIR
+#	is the not root directory if cross compiling.
+#   release:
+#	Does a `make distribution', and then tars up the DESTDIR files
+#	into RELEASEDIR/${MACHINE}, in release(7) format.
+#	(See etc/Makefile for more information on this.)
+#   regression-tests:
+#	Runs the regression tests in "regress" on this host.
+#   sets:
+#	Populate ${RELEASEDIR}/${MACHINE}/binary/sets from ${DESTDIR}
+#   sourcesets:
+#	Populate ${RELEASEDIR}/source/sets from ${NETBSDSRCDIR}
+#   syspkgs:
+#	Populate ${RELEASEDIR}/${MACHINE}/binary/syspkgs from ${DESTDIR}
+#
+# Targets invoked by `make build,' in order:
+#   cleandir:        cleans the tree.
+#   obj:             creates object directories.
+#   do-tools:        builds host toolchain.
+#   do-distrib-dirs: creates the distribution directories.
+#   includes:        installs include files.
+#   do-tools-compat: builds the "libnbcompat" library; needed for some
+#                    random host tool programs in the source tree.
+#   do-lib-csu:      builds and installs prerequisites from lib/csu.
+#   do-gnu-lib-crtstuff3: builds and installs prerequisites from
+#			  gnu/lib/crtstuff3
+#   do-gnu-lib-libgcc3: builds and installs prerequisites from gnu/lib/libgcc3
+#   do-lib-libc:     builds and installs prerequisites from lib/libc.
+#   do-lib:          builds and installs prerequisites from lib.
+#   do-gnu-lib:      builds and installs prerequisites from gnu/lib.
+#   do-ld.so:        builds and installs prerequisites from libexec/ld.*_so.
+#   do-build:        builds and installs the entire system.
+#   do-x11:          builds and installs X11R6 from src/x11 if ${MKX11} != "no"
+#   do-obsolete:     installs the obsolete sets (for the postinstall-* targets).
+#
+
+.if ${.MAKEFLAGS:M${.CURDIR}/share/mk} == ""
+.MAKEFLAGS: -m ${.CURDIR}/share/mk
+.endif
+
+#
+# If _SRC_TOP_OBJ_ gets set here, we will end up with a directory that may
+# not be the top level objdir, because "make obj" can happen in the *middle*
+# of "make build" (long after <bsd.own.mk> is calculated it).  So, pre-set
+# _SRC_TOP_OBJ_ here so it will not be added to ${.MAKEOVERRIDES}.
+#
+_SRC_TOP_OBJ_=
 
 .include <bsd.own.mk>
 
-MKOBJDIRS ?= no
-HAVE_EGCS!=	${CXX} --version | egrep "^(2\.[89]|egcs)" ; echo
+#
+# Sanity check: make sure that "make build" is not invoked simultaneously
+# with a standard recursive target.
+#
 
-.if defined(NBUILDJOBS)
-_J= -j${NBUILDJOBS}
+.if make(build) || make(release) || make(snapshot)
+.for targ in ${TARGETS:Nobj:Ncleandir}
+.if make(${targ}) && !target(.BEGIN)
+.BEGIN:
+	@echo 'BUILD ABORTED: "make build" and "make ${targ}" are mutually exclusive.'
+	@false
 .endif
-
-.if defined(DESTDIR)
-_M=-m ${DESTDIR}/usr/share/mk
+.endfor
 .endif
 
-# NOTE THAT etc *DOES NOT* BELONG IN THE LIST BELOW
+_SUBDIR=	tools lib include gnu bin games libexec sbin usr.bin
+_SUBDIR+=	usr.sbin share rescue sys etc .WAIT distrib regress
+
+#
+# Weed out directories that don't exist.
+#
 
-SUBDIR+= lib include bin libexec sbin usr.bin usr.sbin share sys
-.if make(cleandir) || make(obj)
-SUBDIR+= distrib
-.ifdef MAKEOBJDIRPREFIX
-SUBDIR+= etc
+.for dir in ${_SUBDIR}
+.if exists(${dir}/Makefile) && (${BUILD_${dir}:Uyes} != "no")
+SUBDIR+=	${dir}
 .endif
+.endfor
+
+.if exists(regress)
+regression-tests: .PHONY .MAKE
+	@echo Running regression tests...
+	${MAKEDIRTARGET} regress regress
 .endif
 
-includes-lib: includes-include includes-sys
+.if ${MKUNPRIVED} != "no"
+NOPOSTINSTALL=	# defined
+.endif
 
-.if exists(games)
-SUBDIR+= games
+afterinstall: .PHONY .MAKE
+.if ${MKMAN} != "no"
+	${MAKEDIRTARGET} share/man makedb
+.endif
+.if (${MKUNPRIVED} != "no" && ${MKINFO} != "no")
+	${MAKEDIRTARGET} gnu/usr.bin/texinfo/install-info infodir-meta
+.endif
+.if !defined(NOPOSTINSTALL)
+	${MAKEDIRTARGET} . postinstall-check
 .endif
 
-SUBDIR+= gnu
-# This is needed for libstdc++ and gen-params.
-includes-gnu: includes-include includes-sys
+_POSTINSTALL=	${.CURDIR}/usr.sbin/postinstall/postinstall
 
-.if exists(regress)
-.ifmake !(install)
-SUBDIR+= regress
-.endif
+postinstall-check: .PHONY
+	@echo "   === Post installation checks ==="
+	${HOST_SH} ${_POSTINSTALL} -s ${.CURDIR} -d ${DESTDIR}/ check
+	@echo "   ================================"
+
+postinstall-fix: .NOTMAIN .PHONY
+	@echo "   === Post installation fixes ==="
+	${HOST_SH} ${_POSTINSTALL} -s ${.CURDIR} -d ${DESTDIR}/ fix
+	@echo "   ==============================="
+
+postinstall-fix-obsolete: .NOTMAIN .PHONY
+	@echo "   === Removing obsolete files ==="
+	${HOST_SH} ${_POSTINSTALL} -s ${.CURDIR} -d ${DESTDIR}/ fix obsolete
+	@echo "   ==============================="
 
-regression-tests:
-	@echo Running regression tests...
-	@(cd ${.CURDIR}/regress && ${MAKE} ${_M} regress)
-.endif
 
-buildstartmsg:
-	@echo -n "Build started at: "
-	@date
-
-buildendmsg:
-	@echo -n "Build finished at: "
-	@date
-
-# If sharesrc is around, use its share/mk files to bootstrap until the
-# mk files are installed (first step of make build).  If installing to
-# DESTDIR, don't bother, since the build will fail later on anyway.
-
-beforeinstall:
-.ifndef NODISTRIBDIRS
-.ifndef DESTDIR
-.if exists(share/mk)
-	(cd ${.CURDIR}/etc && ${MAKE} -m ${.CURDIR}/share/mk DESTDIR=/ distrib-dirs)
+#
+# Targets (in order!) called by "make build".
+#
+.if ${USE_TOOLS_TOOLCHAIN} == "no"
+LIBGCC_EXT=3
 .else
-	(cd ${.CURDIR}/etc && ${MAKE} DESTDIR=/ distrib-dirs)
+LIBGCC_EXT=
 .endif
-.else
-	(cd ${.CURDIR}/etc && ${MAKE} distrib-dirs)
+
+BUILDTARGETS+=	check-tools
+.if ${MKUPDATE} == "no" && !defined(NOCLEANDIR)
+BUILDTARGETS+=	cleandir
 .endif
+.if ${MKOBJDIRS} != "no"
+BUILDTARGETS+=	obj
 .endif
-
-afterinstall:
-.if ${MKMAN} != "no" && !defined(_BUILD)
-	${MAKE} ${_M} whatis.db
+.if ${USETOOLS} == "yes"
+BUILDTARGETS+=	do-tools
 .endif
+.if !defined(NODISTRIBDIRS)
+BUILDTARGETS+=	do-distrib-dirs
+.endif
+.if !defined(NOINCLUDES)
+BUILDTARGETS+=	includes
+.endif
+BUILDTARGETS+=	do-tools-compat
+BUILDTARGETS+=	do-lib-csu
+.if ${MKGCC} != "no"
+.if ${HAVE_GCC3} != "no"
+BUILDTARGETS+=	do-gnu-lib-crtstuff${LIBGCC_EXT}
+.endif
+BUILDTARGETS+=	do-gnu-lib-libgcc${LIBGCC_EXT}
+.endif
+BUILDTARGETS+=	do-lib-libc
+BUILDTARGETS+=	do-lib do-gnu-lib
+BUILDTARGETS+=	do-ld.so
+BUILDTARGETS+=	do-build
+.if ${MKX11} != "no"
+BUILDTARGETS+=	do-x11
+.endif
+BUILDTARGETS+=	do-obsolete
 
-whatis.db:
-	(cd ${.CURDIR}/share/man && ${MAKE} ${_M} makedb)
+#
+# Enforce proper ordering of some rules.
+#
 
-# wrt info/dir below:  It's safe to move this over top of /usr/share/info/dir,
-# as the build will automatically remove/replace the non-pkg entries there.
+.ORDER:		${BUILDTARGETS}
+includes-lib:	.PHONY includes-include includes-sys
+includes-gnu:	.PHONY includes-lib
 
+#
+# Build the system and install into DESTDIR.
+#
+
+START_TIME!=	date
+
+build: .PHONY .MAKE
 .if defined(BUILD_DONE)
-build:
-	@echo "Build installed into ${DESTDIR}"
+	@echo "Build already installed into ${DESTDIR}"
 .else
-build:
-	@${MAKE} ${_M} buildstartmsg
-	@${MAKE} ${_M} beforeinstall
-	@${MAKE} ${_M} do-force-domestic
-	@${MAKE} ${_M} do-share-mk
-	@${MAKE} ${_M} do-cleandir
-	@${MAKE} ${_M} do-make-obj
-	@${MAKE} ${_M} do-check-egcs
-	@${MAKE} ${_M} do-make-includes
-	@${MAKE} ${_M} do-lib-csu
-	@${MAKE} ${_M} do-lib
-	@${MAKE} ${_M} do-gnu-lib
-	@${MAKE} ${_M} do-dependall
-	@${MAKE} ${_M} do-domestic
-	@${MAKE} ${_M} do-whatisdb
-	@${MAKE} ${_M} buildendmsg
-.endif
-
-do-force-domestic:
-.if defined(FORCE_DOMESTIC)
-	@echo '*** CAPUTE!'
-	@echo '    The FORCE_DOMESTIC flag is not compatible with "make build".'
-	@echo '    Please correct the problem and try again.'
-	@false
+	@echo "Build started at: ${START_TIME}"
+.for tgt in ${BUILDTARGETS}
+	${MAKEDIRTARGET} . ${tgt}
+.endfor
+	${MAKEDIRTARGET} etc install-etc-release
+	@echo   "Build started at:  ${START_TIME}"
+	@printf "Build finished at: " && date
 .endif
 
-do-share-mk:
-.if ${MKSHARE} != "no"
-	(cd ${.CURDIR}/share/mk && ${MAKE} install)
-.endif
+#
+# Build a full distribution, but not a release (i.e. no sets into
+# ${RELEASEDIR}).  "buildworld" enforces a build to ${DESTDIR} != /
+#
 
-do-cleandir:
-.if !defined(UPDATE) && !defined(NOCLEANDIR)
-	${MAKE} ${_J} ${_M} cleandir
+distribution buildworld: .PHONY .MAKE
+.if make(buildworld) && \
+    (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
+	@echo "Won't make ${.TARGET} with DESTDIR=/"
+	@false
 .endif
-
-do-make-obj:
-.if ${MKOBJDIRS} != "no"
-	${MAKE} ${_J} ${_M} obj
+	${MAKEDIRTARGET} . build NOPOSTINSTALL=1
+	${MAKEDIRTARGET} etc distribution INSTALL_DONE=1
+.if defined(DESTDIR) && ${DESTDIR} != "" && ${DESTDIR} != "/"
+	${MAKEDIRTARGET} . postinstall-fix-obsolete
+	${MAKEDIRTARGET} distrib/sets checkflist
 .endif
+	@echo   "make ${.TARGET} started at:  ${START_TIME}"
+	@printf "make ${.TARGET} finished at: " && date
 
-do-check-egcs:
-.if empty(HAVE_EGCS)
-.if defined(DESTDIR)
-	@echo "*** CAPUTE!"
-	@echo "    You attempted to compile the world without egcs.  You must"
-	@echo "    first install a native egcs compiler."
+#
+# Install the distribution from $DESTDIR to $INSTALLWORLDDIR (defaults to `/')
+# If installing to /, ensures that the host's operating system is NetBSD and
+# the host's `uname -m` == ${MACHINE}.
+#
+
+HOST_UNAME_S!=	uname -s
+HOST_UNAME_M!=	uname -m
+
+installworld: .PHONY .MAKE
+.if (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
+	@echo "Can't make ${.TARGET} to DESTDIR=/"
 	@false
-.else
-	(cd ${.CURDIR}/gnu/usr.bin/egcs && \
-	    ${MAKE} ${_M} ${_J} dependall MKMAN=no && \
-	    ${MAKE} ${_M} MKMAN=no install && ${MAKE} ${_M} cleandir)
 .endif
+.if !defined(INSTALLWORLDDIR) || \
+    ${INSTALLWORLDDIR} == "" || ${INSTALLWORLDDIR} == "/"
+.if (${HOST_UNAME_S} != "NetBSD")
+	@echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_S} to NetBSD with INSTALLWORLDDIR=/"
+	@false
 .endif
-
-do-make-includes:
-.if !defined(NOINCLUDES)
-	${MAKE} ${_M} includes
+.if (${HOST_UNAME_M} != ${MACHINE})
+	@echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_M} to ${MACHINE} with INSTALLWORLDDIR=/"
+	@false
 .endif
+.endif
+	${MAKEDIRTARGET} distrib/sets installsets \
+	    INSTALLDIR=${INSTALLWORLDDIR:U/} INSTALLSETS=
+	${MAKEDIRTARGET} . postinstall-check DESTDIR=${INSTALLWORLDDIR}
+	@echo   "make ${.TARGET} started at:  ${START_TIME}"
+	@printf "make ${.TARGET} finished at: " && date
+
+#
+# Create sets from $DESTDIR or $NETBSDSRCDIR into $RELEASEDIR
+#
+
+.for tgt in sets sourcesets syspkgs
+${tgt}: .PHONY .MAKE
+	${MAKEDIRTARGET} distrib/sets ${tgt}
+.endfor
+
+#
+# Build a release or snapshot (implies "make distribution").  Note that
+# in this case, the set lists will be checked before the tar files
+# are made.
+#
 
-do-lib-csu:
-	(cd ${.CURDIR}/lib/csu && \
-	    ${MAKE} ${_M} ${_J} MKSHARE=no dependall && \
-	    ${MAKE} ${_M} MKSHARE=no install)
+release snapshot: .PHONY .MAKE
+	${MAKEDIRTARGET} . distribution
+	${MAKEDIRTARGET} etc release DISTRIBUTION_DONE=1
+	@echo   "make ${.TARGET} started at:  ${START_TIME}"
+	@printf "make ${.TARGET} finished at: " && date
 
-do-lib:
-	(cd ${.CURDIR}/lib && \
-	    ${MAKE} ${_M} ${_J} MKSHARE=no dependall && \
-	    ${MAKE} ${_M} MKSHARE=no install)
+#
+# Special components of the "make build" process.
+#
+
+check-tools: .PHONY
+.if ${TOOLCHAIN_MISSING} != "no" && !defined(EXTERNAL_TOOLCHAIN)
+	@echo '*** WARNING:  Building on MACHINE=${MACHINE} with missing toolchain.'
+	@echo '*** May result in a failed build or corrupt binaries!'
+.elif defined(EXTERNAL_TOOLCHAIN)
+	@echo '*** Using external toolchain rooted at ${EXTERNAL_TOOLCHAIN}.'
+.endif
+.if defined(NBUILDJOBS)
+	@echo '*** WARNING: NBUILDJOBS is obsolete; use -j directly instead!'
+.endif
 
-do-gnu-lib:
-	(cd ${.CURDIR}/gnu/lib && \
-	    ${MAKE} ${_M} ${_J} MKSHARE=no dependall && \
-	    ${MAKE} ${_M} MKSHARE=no install)
+do-distrib-dirs: .PHONY .MAKE
+.if !defined(DESTDIR) || ${DESTDIR} == ""
+	${MAKEDIRTARGET} etc distrib-dirs DESTDIR=/
+.else
+	${MAKEDIRTARGET} etc distrib-dirs DESTDIR=${DESTDIR}
+.endif
+
+.for targ in cleandir obj includes
+do-${targ}: .PHONY ${targ}
+	@true
+.endfor
 
-do-dependall:
-	${MAKE} ${_M} ${_J} dependall && ${MAKE} ${_M} _BUILD= install
+.for dir in tools tools/compat lib/csu gnu/lib/crtstuff${LIBGCC_EXT} gnu/lib/libgcc${LIBGCC_EXT} lib/libc lib/libdes lib gnu/lib
+do-${dir:S/\//-/g}: .PHONY .MAKE
+.for targ in dependall install
+	${MAKEDIRTARGET} ${dir} ${targ}
+.endfor
+.endfor
 
-do-domestic:
-.if defined(DOMESTIC) && !defined(EXPORTABLE_SYSTEM)
-	(cd ${.CURDIR}/${DOMESTIC} && ${MAKE} ${_M} ${_J} _SLAVE_BUILD= build)
+do-ld.so: .PHONY .MAKE
+.for targ in dependall install
+.if (${OBJECT_FMT} == "a.out")
+	${MAKEDIRTARGET} libexec/ld.aout_so ${targ}
 .endif
+.if (${OBJECT_FMT} == "ELF")
+	${MAKEDIRTARGET} libexec/ld.elf_so ${targ}
+.endif
+.endfor
+
+do-build: .PHONY .MAKE
+.for targ in dependall install
+	${MAKEDIRTARGET} . ${targ} BUILD_tools=no BUILD_lib=no
+.endfor
 
-do-whatisdb:
-	${MAKE} ${_M} whatis.db
+do-x11: .PHONY .MAKE
+	${MAKEDIRTARGET} x11 build
 
-release snapshot: build
-	(cd ${.CURDIR}/etc && ${MAKE} ${_M} INSTALL_DONE=1 release)
+do-obsolete: .PHONY .MAKE
+	${MAKEDIRTARGET} etc install-obsolete-lists
 
+#
+# Speedup stubs for some subtrees that don't need to run these rules.
+# (Tells <bsd.subdir.mk> not to recurse for them.)
+#
+
+.for dir in bin etc distrib games libexec regress sbin usr.sbin tools
+includes-${dir}: .PHONY
+	@true
+.endfor
+.for dir in etc distrib regress
+install-${dir}: .PHONY
+	@true
+.endfor
+
+#
+# XXX this needs to change when distrib Makefiles are recursion compliant
+# XXX many distrib subdirs need "cd etc && make snap_pre snap_kern" first...
+#
+dependall-distrib depend-distrib all-distrib: .PHONY
+	@true
+
+.include <bsd.sys.mk>
+.include <bsd.obj.mk>
+.include <bsd.kernobj.mk>
 .include <bsd.subdir.mk>
+
+build-docs: .PHONY ${.CURDIR}/BUILDING
+${.CURDIR}/BUILDING: doc/BUILDING.mdoc
+	${_MKMSG_CREATE} ${.TARGET}
+	${TOOL_GROFF} -mdoc -Tascii -P-bou $> >$@
+
+
+#
+# Display current make(1) parameters
+#
+params: .PHONY .MAKE
+	${MAKEDIRTARGET} etc params