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.135
retrieving revision 1.145
diff -u -p -r1.135 -r1.145
--- src/Makefile	2001/10/10 17:20:15	1.135
+++ src/Makefile	2001/10/30 17:59:10	1.145
@@ -1,4 +1,4 @@
-#	$NetBSD: Makefile,v 1.135 2001/10/10 17:20:15 jwise Exp $
+#	$NetBSD: Makefile,v 1.145 2001/10/30 17:59:10 tv 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
@@ -31,193 +31,161 @@
 #   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'.
-
 #
 # Targets:
-#   build: builds a full release of netbsd in DESTDIR. If BUILD_DONE is
+#   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
+#   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.
+#   regression-tests:
+#	Runs the regression tests in "regress" on this host.
 #
-# Sub targets of `make build,' in order:
-#   buildstartmsg: displays the start time of the build.
-#   do-make-tools: builds host toolchain.
+# Targets invoked by `make build,' in order:
+#   obj:             creates object directories.
+#   cleandir:        cleans the tree.
+#   do-make-tools:   builds host toolchain.
 #   do-distrib-dirs: creates the distribution directories.
-#   do-force-domestic: check's that FORCE_DOMESTIC isn't set (deprecated.)
-#   do-cleandir: cleans the tree.
-#   do-make-obj: creates object directories if required.
-#   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.
+#   includes:        installs include files.
+#   do-lib-csu:      builds and installs prerequisites from lib/csu.
+#   do-lib:          builds and installs prerequisites from lib.
+#   do-gnu-lib:      builds and installs prerequisites from gnu/lib.
+#   do-build:        builds and installs the entire system.
 
 .include "${.CURDIR}/share/mk/bsd.own.mk"
 
-MKOBJDIRS ?= no
-
-.if defined(NBUILDJOBS)
-_J= -j${NBUILDJOBS}
-.endif
+# Sanity check: make sure that "make build" is not invoked simultaneously
+# with a standard recursive target.
 
-# NOTE THAT etc *DOES NOT* BELONG IN THE LIST BELOW
-
-SUBDIR+= lib include bin libexec sbin usr.bin usr.sbin share sys
-.if make(cleandir) || make(obj)
-SUBDIR+= distrib
-.if ${USETOOLS} != "no"
-SUBDIR+= tools
-.endif
-.ifdef MAKEOBJDIRPREFIX
-SUBDIR+= etc
+.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
+.endfor
 .endif
 
-includes-lib: includes-include includes-sys
+.if defined(NBUILDJOBS)
+_J=		-j${NBUILDJOBS}
+.endif
 
-.if exists(games)
-SUBDIR+= games
+.if ${USETOOLS} == "yes"
+_SUBDIR+=	tools
 .endif
+_SUBDIR+=	lib include gnu bin games libexec sbin usr.bin \
+		usr.sbin share sys etc distrib regress
 
-SUBDIR+= gnu
-# This is needed for libstdc++ and gen-params.
-includes-gnu: includes-include includes-sys
+# Weed out directories that don't exist.
 
-.if exists(regress)
-.ifmake !(install)
-SUBDIR+= regress
+.for dir in ${_SUBDIR}
+.if exists(${dir}/Makefile)
+SUBDIR+=	${dir}
 .endif
+.endfor
 
+.if exists(regress)
 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
-
-afterinstall:
-.if ${MKMAN} != "no" && !defined(_BUILD)
-	${MAKE} ${_M} whatis.db
+	@cd ${.CURDIR}/regress && ${MAKE} ${_M} regress
 .endif
 
+.if ${MKMAN} != "no"
+afterinstall: whatis.db
 whatis.db:
-	(cd ${.CURDIR}/share/man && ${MAKE} ${_M} makedb)
+	cd ${.CURDIR}/share/man && ${MAKE} ${_M} makedb
+.endif
 
-# 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.
+# Targets (in order!) called by "make build".
 
-.if defined(BUILD_DONE)
-build:
-	@echo "Build installed into ${DESTDIR}"
-.else
-build:
-	@${MAKE} ${_M} buildstartmsg
-	@${MAKE} ${_M} do-make-tools
-	@${MAKE} ${_M} do-distrib-dirs
-	@${MAKE} ${_M} do-force-domestic
-	@${MAKE} ${_M} do-cleandir
-	@${MAKE} ${_M} do-make-obj
-	@${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
+.if ${MKOBJDIRS:Uno} != "no"
+BUILDTARGETS+=	obj
 .endif
-
-do-make-tools:
-.if ${USETOOLS} != "no"
-.if ${MKOBJDIRS} != "no"
-	cd ${.CURDIR}/tools && ${MAKE} ${_M} obj
+.if !defined(UPDATE) && !defined(NOCLEANDIR)
+BUILDTARGETS+=	cleandir
 .endif
-	cd ${.CURDIR}/tools && ${MAKE} ${_M} build
+.if ${USETOOLS} == "yes"
+BUILDTARGETS+=	do-make-tools
 .endif
-
-do-distrib-dirs:
-.ifndef NODISTRIBDIRS
-.ifndef DESTDIR
-	(cd ${.CURDIR}/etc && ${MAKE} ${_M} DESTDIR=/ distrib-dirs)
-.else
-	(cd ${.CURDIR}/etc && ${MAKE} ${_M} DESTDIR=${DESTDIR} distrib-dirs)
+.if !defined(NODISTRIBDIRS)
+BUILDTARGETS+=	do-distrib-dirs
 .endif
+.if !defined(NOINCLUDES)
+BUILDTARGETS+=	includes
 .endif
+BUILDTARGETS+=	do-lib-csu do-lib do-gnu-lib do-build
 
-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
-.endif
+# Enforce proper ordering of some rules.
 
-do-cleandir:
-.if !defined(UPDATE) && !defined(NOCLEANDIR)
-	${MAKE} ${_J} ${_M} cleandir
-.endif
+.ORDER:		${BUILDTARGETS}
+includes-lib:	includes-include includes-sys
+includes-gnu:	includes-lib
 
-do-make-obj:
-.if ${MKOBJDIRS} != "no"
-	${MAKE} ${_J} ${_M} obj
-.endif
+# Build the system and install into DESTDIR.
 
-do-make-includes:
-.if !defined(NOINCLUDES)
-	${MAKE} ${_M} includes
+build:
+.if defined(BUILD_DONE)
+	@echo "Build already installed into ${DESTDIR}"
+.else
+	@echo -n "Build started at: " && date
+.for tgt in ${BUILDTARGETS}
+	${MAKE} ${_J} ${_M} ${tgt}
+.endfor
+	@echo -n "Build finished at: " && date
 .endif
 
-do-lib-csu:
-	(cd ${.CURDIR}/lib/csu && \
-	    ${MAKE} ${_M} ${_J} MKSHARE=no dependall && \
-	    ${MAKE} ${_M} MKSHARE=no install)
+# Build a release or snapshot (implies "make build").
 
-do-lib:
-	(cd ${.CURDIR}/lib && \
-	    ${MAKE} ${_M} ${_J} MKSHARE=no dependall && \
-	    ${MAKE} ${_M} MKSHARE=no install)
+release snapshot: build
+	cd ${.CURDIR}/etc && ${MAKE} ${_M} INSTALL_DONE=1 release
 
-do-gnu-lib:
-	(cd ${.CURDIR}/gnu/lib && \
-	    ${MAKE} ${_M} ${_J} MKSHARE=no dependall && \
-	    ${MAKE} ${_M} MKSHARE=no install)
+# Special components of the "make build" process.
 
-do-dependall:
-	${MAKE} ${_M} ${_J} dependall && ${MAKE} ${_M} _BUILD= install
+do-make-tools:
+	cd ${.CURDIR}/tools && ${MAKE} ${_M} build
 
-do-domestic:
-.if defined(DOMESTIC) && !defined(EXPORTABLE_SYSTEM)
-	(cd ${.CURDIR}/${DOMESTIC} && ${MAKE} ${_M} ${_J} _SLAVE_BUILD= build)
-.endif
+do-distrib-dirs:
+	cd ${.CURDIR}/etc && ${MAKE} ${_M} DESTDIR=${DESTDIR} distrib-dirs
 
-do-whatisdb:
-	${MAKE} ${_M} whatis.db
+.for dir in lib/csu lib gnu/lib
+do-${dir:S/\//-/}:
+.for targ in dependall install
+	cd ${.CURDIR}/${dir} && \
+		${MAKE} ${_M} ${_J} MKSHARE=no MKLINT=no ${targ}
+.endfor
+.endfor
+
+do-build:
+	${MAKE} ${_M} ${_J} dependall
+	${MAKE} ${_M} ${_J} install
 
-release snapshot: build
-	(cd ${.CURDIR}/etc && ${MAKE} ${_M} INSTALL_DONE=1 release)
+# Speedup stubs for some subtrees that don't need to run these rules.
+# (Tells <bsd.subdir.mk> not to recurse for them.)
 
-# Speedup stubs for some subtrees that don't need to run these rules
 includes-bin includes-games includes-libexec includes-regress \
-includes-sbin includes-usr.sbin:
-	@${TRUE}
-
-.if !exists(${.CURDIR}/share/mk)
-.BEGIN:
-	@echo 'BUILD ABORTED: share/mk does not exist, cannot run make.'
-	@false
-.endif
+includes-sbin includes-usr.sbin includes-tools \
+dependall-tools depend-tools all-tools install-tools install-regress \
+dependall-distrib depend-distrib all-distrib install-distrib includes-distrib:
+	@true
 
 .include "${.CURDIR}/share/mk/bsd.subdir.mk"
 
 _M:=	-m ${.CURDIR}/share/mk
+
+# Rules for building the BUILDING.* documentation files.
+
+build-docs: ${.CURDIR}/BUILDING.txt ${.CURDIR}/BUILDING.html
+
+.SUFFIXES: .mdoc .html .txt
+
+.mdoc.html: ${.CURDIR}/Makefile
+	groff -mdoc2html -Tlatin1 -P-b -P-u -P-o -ww -mtty-char $< >$@
+
+# The awk expression changes line endings from LF to CR-LF to make
+# this readable on many more platforms than just Un*x.
+.mdoc.txt: ${.CURDIR}/Makefile
+	groff -mdoc -Tascii -P-b -P-u -P-o $< | \
+		awk 'BEGIN{ORS="\r\n"}{print}' >$@