summaryrefslogtreecommitdiff
path: root/ghc.mk
diff options
context:
space:
mode:
authorSimon Marlow <marlowsd@gmail.com>2009-04-27 12:47:11 +0000
committerSimon Marlow <marlowsd@gmail.com>2009-04-27 12:47:11 +0000
commit6dd9e1fb676126afebab0a0a340a7d6a0470d52a (patch)
treec847d62deb4d4ac1758e63b643e67c7c2ba6fcdb /ghc.mk
parent296058a1cafa80dec0b3f998348bce7c65f668b0 (diff)
downloadhaskell-6dd9e1fb676126afebab0a0a340a7d6a0470d52a.tar.gz
update build order comment
Diffstat (limited to 'ghc.mk')
-rw-r--r--ghc.mk22
1 files changed, 13 insertions, 9 deletions
diff --git a/ghc.mk b/ghc.mk
index fa915c42ba..7381a80cf9 100644
--- a/ghc.mk
+++ b/ghc.mk
@@ -67,27 +67,31 @@
# 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