+# -----------------------------------------------------------------------------
+#
+# (c) 2009 The University of Glasgow
+#
+# This file is part of the GHC build system.
+#
+# To understand how the build system works and how to modify it, see
+# http://hackage.haskell.org/trac/ghc/wiki/Building/Architecture
+# http://hackage.haskell.org/trac/ghc/wiki/Building/Modifying
+#
+# -----------------------------------------------------------------------------
+
# ToDo List.
#
# Before we can merge the new build system into HEAD:
# * need to fix Cabal for new Windows layout, see
# Distribution/Simple/GHC.configureToolchain.
#
-# As we merge the new build system into HEAD:
+# Once the new build system is in HEAD, and before 6.12:
#
# * remove old Makefiles, add new stubs for building in subdirs
# * utils/hsc2hs/Makefile
# * utils/haddock/Makefile
# * mk/oldconfig.mk.in
-#
-# Once the new build system is in HEAD, and before 6.12:
-#
+# * docs/Makefile
+# * docs/docbook-cheat-sheet/Makefile
+# * docs/ext-core/Makefile
+# * docs/man/Makefile
+# * docs/storage-mgmt/Makefile
+# * docs/users_guide/Makefile
+# * docs/vh/Makefile
+# * driver/Makefile
+# * driver/ghc/Makefile
+# * libraries/Makefile
+# * rts/dotnet/Makefile
+# * utils/Makefile
# * docbook PDFs, e.g. "dblatex -T db2latex users_guide.xml"
# * GhcProfiled
# * optionally install stage3?
-# * why does so much stuff get rebuilt after re-configuring?
# * shared libraries, way dyn
-# * add pointers to wiki docs from the build system source
# * get HC bootstrapping working
# * add Makefiles for the rest of the utils/ programs that aren't built
# by default (need to exclude them from 'make all' too)
#
# Tickets we can now close, or fix and close:
#
-# * 912 build system doesn't have enough dependencies (it does now!)
-# * 2744 check for presence of hsc2hs in ./configure
# * 2966 make sure --with-gcc does the right thing (#2966)
-# * 3115 make ghc.cabal read-only
-# * 2107 install the docs by default
# * 1693 make distclean
# * 2689 make maintainer-clean
-# * 2619 bootstrapping using a newer GHC shouldn't fail
-# for bogus reasons (picking the wrong version of the ghc package)
-# * 2770 check which version of gcc we require
# * 3173 make install with DESTDIR
# Possible cleanups:
# a state where the package database is out of date, and the build
# system doesn't know.
-# NOTES on how to debug:
-# make --debug=b --debug=m shows dependencies
-# make -p prints all generated makefile rules and variables
-# make show VALUE=VAR prints the value of VAR
-# $(warning stuff) prints stuff when reading the makefile
-
-# BUILD ORDER
+# Approximate build order.
+#
+# The actual build order is defined by dependencies, and the phase
+# ordering used to ensure correct ordering of makefile-generation; see
+# http://hackage.haskell.org/trac/ghc/wiki/Building/Architecture/Idiom/PhaseOrdering
#
# * With bootstrapping compiler:
-# o Build libraries/{hpc,extensible-exceptions,Cabal}
-# o Build utils/ghc-pkg
# o Build utils/ghc-cabal
-# * With bootstrapping compiler and ghc-cabal:
+# o Build utils/ghc-pkg
# o Build utils/hsc2hs
-# o Build libraries/hpc
-# o Build compiler (stage 1)
# * For each package:
-# o generate package-data.mk and inplace-pkg-info
+# o configure, generate package-data.mk and inplace-pkg-info
# o register each package into inplace/lib/package.conf
-# o generate .depend for each package
+# * build libffi
+# * With bootstrapping compiler:
+# o Build libraries/{filepath,hpc,extensible-exceptions,Cabal}
+# o Build compiler (stage 1)
# * With stage 1:
# o Build libraries/*
+# o Build rts
# o Build utils/* (except haddock)
# o Build compiler (stage 2)
# * With stage 2:
# o Build utils/haddock
-# o Build compiler (stage 3)
+# o Build compiler (stage 3) (optional)
# * With haddock:
# o libraries/*
# o compiler
syb \
template-haskell \
base3-compat \
- Cabal
+ Cabal \
+ mtl \
+ utf8-string
+
+ifneq "$(Windows)" "YES"
+PACKAGES += terminfo
+endif
+
+PACKAGES += haskeline
BOOT_PKGS = Cabal hpc extensible-exceptions
# -----------------------------------------------------------------------------
# Include build instructions from all subdirs
-# See commentary in the top-level Makefile for why we divide the build
-# into phases.
+# For the rationale behind the build phases, see
+# http://hackage.haskell.org/trac/ghc/wiki/Building/Architecture/Idiom/PhaseOrdering
# Setting foo_dist_DISABLE=YES means "in directory foo, for build
# "dist", just read the package-data.mk file, do not build anything".
distclean : clean
$(RM) config.cache config.status config.log mk/config.h mk/stamp-h
- $(RM) mk/config.mk mk/are-validating.mk
+ $(RM) mk/config.mk mk/are-validating.mk mk/project.mk
$(RM) extra-gcc-opts docs/users_guide/ug-book.xml
$(RM) compiler/ghc.cabal ghc/ghc-bin.cabal
$(RM) libraries/base/include/HsBaseConfig.h
$(RM) libraries/directory/include/HsDirectoryConfig.h
+ $(RM) libraries/process/include/HsProcessConfig.h
+ $(RM) libraries/unix/include/HsUnixConfig.h
+ $(RM) libraries/old-time/include/HsTimeConfig.h
maintainer-clean : distclean
+ $(RM) configure mk/config.h.in
+ $(RM) -r autom4te.cache libraries/*/autom4te.cache
$(RM) ghc.spec
- $(RM) libraries/*/GNUmakefile
+ $(RM) libraries/*/GNUmakefile libraries/*/ghc.mk libraries/*/configure
+ $(RM) libraries/base/include/HsBaseConfig.h.in
+ $(RM) libraries/directory/include/HsDirectoryConfig.h.in
+ $(RM) libraries/process/include/HsProcessConfig.h.in
+ $(RM) libraries/unix/include/HsUnixConfig.h.in
+ $(RM) libraries/old-time/include/HsTimeConfig.h.in