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.71
retrieving revision 1.168
diff -u -p -r1.71 -r1.168
--- src/Makefile	1998/10/16 05:05:09	1.71
+++ src/Makefile	2002/04/11 19:31:06	1.168
@@ -1,108 +1,218 @@
-#	$NetBSD: Makefile,v 1.71 1998/10/16 05:05:09 mycroft Exp $
+#	$NetBSD: Makefile,v 1.168 2002/04/11 19:31:06 tv Exp $
 
-.include <bsd.own.mk>			# for configuration variables.
+# 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
+#
+# Not everything you can set or do is documented in this makefile. In
+# particular, you should review the files in /usr/share/mk (especially
+# bsd.README) for general information on building programs and writing
+# Makefiles within this structure, and see the comments in src/etc/Makefile
+# for further information on installation and release set options.
+#
+# Variables listed below can be set on the make command line (highest
+# priority), in /etc/mk.conf (middle priority), or in the environment
+# (lowest priority).
+#
+# Variables:
+#   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 
+#	an appropriate point in a build.
+#   MKSHARE, if set to `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, if defined, 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'.
+#
+# 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.)
+#   regression-tests:
+#	Runs the regression tests in "regress" on this host.
+#
+# 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-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.
+
+.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>
+
+# Sanity check: make sure that "make build" is not invoked simultaneously
+# with a standard recursive target.
+
+.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
+
+.if defined(NBUILDJOBS)
+.if !target(.BEGIN)
+.BEGIN:
+	@echo 'NBUILDJOBS is currently broken; see PR toolchain/14837.'
+	@false
+.endif
+#_J=		-j${NBUILDJOBS}
+.endif
+
+_SUBDIR=	tools lib include gnu bin games libexec sbin usr.bin
+_SUBDIR+=	usr.sbin share sys etc distrib regress
+
+# Weed out directories that don't exist.
+
+.for dir in ${_SUBDIR}
+.if exists(${dir}/Makefile) && (${BUILD_${dir}:Uyes} != "no")
+SUBDIR+=	${dir}
+.endif
+.endfor
 
-HAVE_GCC28!=	${CXX} --version | egrep "^(2\.8|egcs)" ; echo
+.if exists(regress)
+regression-tests:
+	@echo Running regression tests...
+	@(cd ${.CURDIR}/regress && ${MAKE} regress)
+.endif
 
-# NOTE THAT etc *DOES NOT* BELONG IN THE LIST BELOW
+afterinstall:
+.if ${MKMAN} != "no"
+	(cd ${.CURDIR}/share/man && ${MAKE} makedb)
+.endif
+.if defined(UNPRIVED) && (${MKINFO} != "no")
+	(cd ${.CURDIR}/gnu/usr.bin/texinfo/install-info && ${MAKE} infodir-meta)
+.endif
 
-SUBDIR+= lib include bin libexec sbin usr.bin usr.sbin share sys
+# Targets (in order!) called by "make build".
 
-.if exists(games)
-SUBDIR+= games
+BUILDTARGETS+=	check-tools
+.if !defined(UPDATE) && !defined(NOCLEANDIR)
+BUILDTARGETS+=	cleandir
+.endif
+.if ${MKOBJDIRS} != "no"
+BUILDTARGETS+=	obj
+.endif
+.if ${USETOOLS} == "yes"
+BUILDTARGETS+=	do-tools
 .endif
+.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
 
-SUBDIR+= gnu
-# This is needed for libstdc++ and gen-params.
-includes-gnu: includes-include includes-sys
+# Enforce proper ordering of some rules.
 
-.if exists(domestic) && !defined(EXPORTABLE_SYSTEM)
-SUBDIR+= domestic
-.endif
+.ORDER:		${BUILDTARGETS}
+includes-lib:	includes-include includes-sys
+includes-gnu:	includes-lib
 
-.if exists(regress)
-.ifmake !(install)
-SUBDIR+= regress
-.endif
+# Build the system and install into DESTDIR.
 
-regression-tests:
-	@echo Running regression tests...
-	@(cd ${.CURDIR}/regress && ${MAKE} regress)
+build:
+.if defined(BUILD_DONE)
+	@echo "Build already installed into ${DESTDIR}"
+.else
+	@echo -n "Build started at: " && date
+.for tgt in ${BUILDTARGETS}
+	@(cd ${.CURDIR} && ${MAKE} ${_J} ${tgt})
+.endfor
+	@echo -n "Build finished at: " && date
 .endif
 
-beforeinstall:
-.ifmake build
-	@echo -n "Build started at: "
-	@date
+# Build a full distribution, but not a release (i.e. no sets into
+# ${RELEASEDIR}).
+
+distribution: build
+	(cd ${.CURDIR}/etc && ${MAKE} INSTALL_DONE=1 distribution)
+
+# Build a release or snapshot (implies "make build").
+
+release snapshot: build
+	(cd ${.CURDIR}/etc && ${MAKE} INSTALL_DONE=1 release)
+
+# Special components of the "make build" process.
+
+check-tools:
+.if defined(USE_NEW_TOOLCHAIN) && (${USE_NEW_TOOLCHAIN} != "nowarn")
+	@echo '*** WARNING:  Building on MACHINE=${MACHINE} with USE_NEW_TOOLCHAIN.'
+	@echo '*** This platform is not yet verified to work with the new toolchain,'
+	@echo '*** and may result in a failed build or corrupt binaries!'
 .endif
-.ifndef DESTDIR
+
+do-distrib-dirs:
+.if !defined(DESTDIR) || ${DESTDIR} == ""
 	(cd ${.CURDIR}/etc && ${MAKE} DESTDIR=/ distrib-dirs)
 .else
-	(cd ${.CURDIR}/etc && ${MAKE} distrib-dirs)
+	(cd ${.CURDIR}/etc && ${MAKE} DESTDIR=${DESTDIR} distrib-dirs)
 .endif
 
-afterinstall:
-.if !defined(NOMAN) && !defined(NOSHARE)
-	(cd ${.CURDIR}/share/man && ${MAKE} makedb)
-.endif
+.for dir in tools lib/csu lib gnu/lib
+do-${dir:S/\//-/}:
+.for targ in dependall install
+	(cd ${.CURDIR}/${dir} && ${MAKE} ${_J} ${targ})
+.endfor
+.endfor
+
+do-build:
+.for targ in dependall install
+	(cd ${.CURDIR} && ${MAKE} ${_J} ${targ} BUILD_tools=no BUILD_lib=no)
+.endfor
+
+# 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}:
+	@true
+.endfor
+.for dir in etc distrib regress
+install-${dir}:
+	@true
+.endfor
+
+# XXX this needs to change when distrib Makefiles are recursion compliant
+dependall-distrib depend-distrib all-distrib:
+	@true
 
-build: beforeinstall
-.if !defined(NOSHARE)
-	(cd ${.CURDIR}/share/mk && ${MAKE} install)
-	(cd ${.CURDIR}/share/tmac && ${MAKE} && ${MAKE} install)
-.endif
-.if !defined(UPDATE)
-	${MAKE} cleandir
-.endif
-.if defined(USE_EGCS) && empty(HAVE_GCC28)
-.if defined(DESTDIR)
-	@echo "*** CAPUTE!"
-	@echo "    You attempted to compile the world with egcs.  You must"
-	@echo "    first install a native egcs compiler."
-	false
-.else
-	(cd ${.CURDIR}/gnu/usr.bin/egcs && \
-	    ${MAKE} depend && NOMAN= ${MAKE} && NOMAN= ${MAKE} install && \
-	    ${MAKE} cleandir)
-.endif
-.endif
-	${MAKE} includes
-	(cd ${.CURDIR}/lib/csu && \
-	    ${MAKE} depend && NOMAN= ${MAKE} && NOMAN= ${MAKE} install)
-	(cd ${.CURDIR}/lib && \
-	    ${MAKE} depend && NOMAN= ${MAKE} && NOMAN= ${MAKE} install)
-	(cd ${.CURDIR}/gnu/lib && \
-	    ${MAKE} depend && NOMAN= ${MAKE} && NOMAN= ${MAKE} install)
-.if !defined(USE_EGCS)
-.if	(${MACHINE_ARCH} != "alpha") && \
-	(${MACHINE_ARCH} != "powerpc")
-	(cd ${.CURDIR}/gnu/usr.bin/gcc/libgcc && \
-	    ${MAKE} depend && NOMAN= ${MAKE} && NOMAN= ${MAKE} install)
-.endif
-.endif
-.if exists(domestic) && !defined(EXPORTABLE_SYSTEM)
-# libtelnet depends on libdes and libkrb.  libkrb depends on
-# libcom_err.
-.if exists(domestic/lib/libdes)
-	(cd ${.CURDIR}/domestic/lib/libdes && \
-	    ${MAKE} depend && NOMAN= ${MAKE} && NOMAN= ${MAKE} install)
-.endif
-.if exists(domestic/lib/libcom_err)
-	(cd ${.CURDIR}/domestic/lib/libcom_err && \
-	    ${MAKE} depend && NOMAN= ${MAKE} && NOMAN= ${MAKE} install)
-.endif
-.if exists(domestic/lib/libkrb)
-	(cd ${.CURDIR}/domestic/lib/libkrb && \
-	    ${MAKE} depend && NOMAN= ${MAKE} && NOMAN= ${MAKE} install)
-.endif
-	(cd ${.CURDIR}/domestic/lib && \
-	    ${MAKE} depend && NOMAN= ${MAKE} && NOMAN= ${MAKE} install)
-.endif
-.if !defined(DESTDIR)
-	ldconfig -m /usr/lib
-.endif
-	${MAKE} depend && ${MAKE} && ${MAKE} install
-	@echo -n "Build finished at: "
-	@date
+clean:
+	rm -f METALOG
 
+.include <bsd.obj.mk>
 .include <bsd.subdir.mk>
+
+build-docs: ${.CURDIR}/BUILDING
+${.CURDIR}/BUILDING: BUILDING.mdoc
+	groff -mdoc -Tascii -P-b -P-u -P-o $> >$@