-# 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".
-
-# We carefully engineer things so that we can build the
-# package-data.mk files early on: they depend only on a few tools also
-# built early. Having got the package-data.mk files built, we can
-# restart make with up-to-date information about all the packages
-# (this is phase 0). The remaining problem is the .depend files:
-#
-# - .depend files in libraries need the stage 1 compiler to build
-# - ghc/stage1/.depend needs compiler/stage1 built
-# - compiler/stage1/.depend needs the bootstrap libs built
-#
-# GHC 6.11+ can build a .depend file without having built the
-# dependencies of the package, but we can't rely on the bootstrapping
-# compiler being able to do this, which is why we have to separate the
-# three phases above.
-
-# So this is the final ordering:
-
-# Phase 0 : all package-data.mk files
-# (requires ghc-cabal, ghc-pkg, mkdirhier, dummy-ghc etc.)
-# Phase 1 : .depend files for bootstrap libs
-# (requires hsc2hs)
-# Phase 2 : compiler/stage1/.depend
-# (requires bootstrap libs and genprimopcode)
-# Phase 3 : ghc/stage1/.depend
-# (requires compiler/stage1)
-#
-# The rest : libraries/*/dist-install, compiler/stage2, ghc/stage2
-