1 # -----------------------------------------------------------------------------
3 # (c) 2009 The University of Glasgow
5 # This file is part of the GHC build system.
7 # To understand how the build system works and how to modify it, see
8 # http://hackage.haskell.org/trac/ghc/wiki/Building/Architecture
9 # http://hackage.haskell.org/trac/ghc/wiki/Building/Modifying
11 # -----------------------------------------------------------------------------
15 # * finish installation
16 # * Windows: should we have ghc-pkg-<version>?
17 # * should we be stripping things?
18 # * install libgmp.a, gmp.h
19 # * need to fix Cabal for new Windows layout, see
20 # Distribution/Simple/GHC.configureToolchain.
21 # * remove old Makefiles, add new stubs for building in subdirs
23 # * docs/docbook-cheat-sheet/Makefile
24 # * docs/ext-core/Makefile
26 # * docs/storage-mgmt/Makefile
28 # * rts/dotnet/Makefile
30 # * optionally install stage3?
31 # * add Makefiles for the rest of the utils/ programs that aren't built
32 # by default (need to exclude them from 'make all' too)
34 # Tickets we can now close, or fix and close:
36 # * 1693 make distclean
40 # * per-source-file dependencies instead of one .depend file?
41 # * eliminate undefined variables, and use --warn-undefined-variables?
42 # * put outputs from different ways in different subdirs of distdir/build,
43 # then we don't have to use -osuf/-hisuf. We would have to install
44 # them in different places too, so we'd need ghc-pkg support for packages
46 # * make PACKAGES generated by configure or sh boot?
47 # * we should use a directory of package.conf files rather than a single
48 # file for the inplace package database, so that we can express
49 # dependencies more accurately. Otherwise it's possible to get into
50 # a state where the package database is out of date, and the build
51 # system doesn't know.
53 # Approximate build order.
55 # The actual build order is defined by dependencies, and the phase
56 # ordering used to ensure correct ordering of makefile-generation; see
57 # http://hackage.haskell.org/trac/ghc/wiki/Building/Architecture/Idiom/PhaseOrdering
59 # * With bootstrapping compiler:
60 # o Build utils/ghc-cabal
61 # o Build utils/ghc-pkg
62 # o Build utils/hsc2hs
64 # o configure, generate package-data.mk and inplace-pkg-info
65 # o register each package into inplace/lib/package.conf
67 # * With bootstrapping compiler:
68 # o Build libraries/{filepath,hpc,extensible-exceptions,Cabal}
69 # o Build compiler (stage 1)
73 # o Build utils/* (except haddock)
74 # o Build compiler (stage 2)
76 # o Build utils/haddock
77 # o Build compiler (stage 3) (optional)
82 .PHONY: default all haddock
84 # We need second expansion for the way we handle directories, so that
86 # expands to the directoy of a rule that uses a % pattern.
91 # Catch make if it runs away into an infinite loop
92 ifeq "$(MAKE_RESTARTS)" ""
93 else ifeq "$(MAKE_RESTARTS)" "1"
94 else ifeq "$(MAKE_RESTARTS)" "2"
96 $(error Make has restarted itself $(MAKE_RESTARTS) times; is there a makefile bug?)
99 # Just bring makefiles up to date:
100 .PHONY: just-makefiles
104 # -----------------------------------------------------------------------------
105 # Misc GNU make utils
108 space=$(nothing) $(nothing)
111 # Cancel all suffix rules. Ideally we'd like to have 'make -r' turned on
112 # by default, because that disables all the implicit rules, but there doesn't
113 # seem to be a good way to do that. This turns off all the old-style suffix
114 # rules, which does half the job and speeds up make quite a bit:
117 # -----------------------------------------------------------------------------
119 # to see the effective value used for a Makefile variable, do
120 # make show VALUE=MY_VALUE
124 @echo '$(VALUE)="$($(VALUE))"'
126 # -----------------------------------------------------------------------------
127 # Include subsidiary build-system bits
131 ifeq "$(findstring clean,$(MAKECMDGOALS))" ""
133 ifeq "$(ProjectVersion)" ""
134 $(error Please run ./configure first)
140 # (Optional) build-specific configuration
141 include mk/custom-settings.mk
143 ifeq "$(findstring clean,$(MAKECMDGOALS))" ""
144 ifeq "$(GhcLibWays)" ""
145 $(error $$(GhcLibWays) is empty, it must contain at least one way)
149 # -----------------------------------------------------------------------------
150 # Macros for standard targets
152 include rules/all-target.mk
153 include rules/clean-target.mk
155 # -----------------------------------------------------------------------------
158 $(eval $(call clean-target,inplace,,inplace))
160 # -----------------------------------------------------------------------------
161 # Whether to build dependencies or not
163 # When we're just doing 'make clean' or 'make show', then we don't need
164 # to build dependencies.
166 ifneq "$(findstring clean,$(MAKECMDGOALS))" ""
167 NO_INCLUDE_DEPS = YES
168 NO_INCLUDE_PKGDATA = YES
170 ifneq "$(findstring bootstrapping-files,$(MAKECMDGOALS))" ""
171 NO_INCLUDE_DEPS = YES
172 NO_INCLUDE_PKGDATA = YES
174 ifeq "$(findstring show,$(MAKECMDGOALS))" "show"
175 NO_INCLUDE_DEPS = YES
176 # We want package-data.mk for show
179 # We don't haddock the bootstrapping libraries
180 libraries/hpc_dist-boot_DO_HADDOCK = NO
181 libraries/Cabal_dist-boot_DO_HADDOCK = NO
182 libraries/extensible-exceptions_dist-boot_DO_HADDOCK = NO
183 libraries/filepath_dist-boot_DO_HADDOCK = NO
184 libraries/binary_dist-boot_DO_HADDOCK = NO
185 libraries/bin-package-db_dist-boot_DO_HADDOCK = NO
187 # -----------------------------------------------------------------------------
190 include rules/way-prelims.mk
192 $(foreach way,$(ALL_WAYS),\
193 $(eval $(call way-prelims,$(way))))
195 # -----------------------------------------------------------------------------
198 include rules/distdir-way-opts.mk
200 # -----------------------------------------------------------------------------
201 # Finding source files and object files
203 include rules/hs-sources.mk
204 include rules/c-sources.mk
205 include rules/includes-sources.mk
206 include rules/hs-objs.mk
207 include rules/c-objs.mk
208 include rules/cmm-objs.mk
210 # -----------------------------------------------------------------------------
213 # Suffix rules cause "make clean" to fail on Windows (trac #3233)
214 # so we don't make any when cleaning.
215 ifneq "$(CLEANING)" "YES"
217 include rules/hs-suffix-rules-srcdir.mk
218 include rules/hs-suffix-rules.mk
220 # -----------------------------------------------------------------------------
221 # Suffix rules for .hi files
223 include rules/hi-rule.mk
225 $(foreach way,$(ALL_WAYS),\
226 $(eval $(call hi-rule,$(way))))
228 #-----------------------------------------------------------------------------
229 # C-related suffix rules
231 include rules/c-suffix-rules.mk
233 #-----------------------------------------------------------------------------
234 # CMM-related suffix rules
236 include rules/cmm-suffix-rules.mk
240 # -----------------------------------------------------------------------------
241 # Building package-data.mk files from .cabal files
243 include rules/package-config.mk
245 # -----------------------------------------------------------------------------
246 # Building dependencies
248 include rules/build-dependencies.mk
250 # -----------------------------------------------------------------------------
251 # Build package-data.mk files
253 include rules/build-package-data.mk
255 # -----------------------------------------------------------------------------
256 # Build and install a program
258 include rules/build-prog.mk
259 include rules/shell-wrapper.mk
261 # -----------------------------------------------------------------------------
262 # Build a perl script
264 include rules/build-perl.mk
266 # -----------------------------------------------------------------------------
269 include rules/build-package.mk
270 include rules/build-package-way.mk
271 include rules/haddock.mk
273 # -----------------------------------------------------------------------------
274 # Registering hand-written package descriptions (used in libffi and rts)
276 include rules/manual-package-config.mk
278 # -----------------------------------------------------------------------------
281 include rules/docbook.mk
283 # -----------------------------------------------------------------------------
286 include rules/bindist.mk
288 # -----------------------------------------------------------------------------
291 define addPackage # args: $1 = package, $2 = condition
293 ifeq "$$(CLEANING)" "YES"
305 $(eval $(call addPackage,ghc-prim))
306 ifeq "$(CLEANING)" "YES"
307 $(eval $(call addPackage,integer-gmp))
308 $(eval $(call addPackage,integer-simple))
310 $(eval $(call addPackage,$(INTEGER_LIBRARY)))
312 $(eval $(call addPackage,base))
313 $(eval $(call addPackage,filepath))
314 $(eval $(call addPackage,array))
315 $(eval $(call addPackage,bytestring))
316 $(eval $(call addPackage,containers))
318 $(eval $(call addPackage,Win32,($$(Windows),YES)))
319 $(eval $(call addPackage,unix,($$(Windows),NO)))
321 $(eval $(call addPackage,old-locale))
322 $(eval $(call addPackage,old-time))
323 $(eval $(call addPackage,time))
324 $(eval $(call addPackage,directory))
325 $(eval $(call addPackage,process))
326 $(eval $(call addPackage,random))
327 $(eval $(call addPackage,extensible-exceptions))
328 $(eval $(call addPackage,haskell98))
329 $(eval $(call addPackage,hpc))
330 $(eval $(call addPackage,pretty))
331 $(eval $(call addPackage,template-haskell))
332 $(eval $(call addPackage,Cabal))
333 $(eval $(call addPackage,binary))
334 $(eval $(call addPackage,bin-package-db))
335 $(eval $(call addPackage,mtl))
336 $(eval $(call addPackage,utf8-string))
338 $(eval $(call addPackage,terminfo,($$(Windows),NO)))
340 $(eval $(call addPackage,haskeline))
342 ifneq "$(BootingFromHc)" "YES"
345 dph/dph-prim-interface \
352 # We assume that the stage0 compiler has a suitable bytestring package,
353 # so we don't have to include it below.
354 BOOT_PKGS = Cabal hpc extensible-exceptions binary bin-package-db
356 # The actual .a and .so/.dll files: needed for dependencies.
357 ALL_STAGE1_LIBS = $(foreach lib,$(PACKAGES),$(libraries/$(lib)_dist-install_v_LIB))
358 ifeq "$(BuildSharedLibs)" "YES"
359 ALL_STAGE1_LIBS += $(foreach lib,$(PACKAGES),$(libraries/$(lib)_dist-install_dyn_LIB))
361 BOOT_LIBS = $(foreach lib,$(BOOT_PKGS),$(libraries/$(lib)_dist-boot_v_LIB))
363 OTHER_LIBS = libffi/dist-install/build/libHSffi$(v_libsuf) libffi/dist-install/build/HSffi.o
364 ifeq "$(BuildSharedLibs)" "YES"
365 OTHER_LIBS += libffi/dist-install/build/libHSffi$(dyn_libsuf)
368 # We cannot run ghc-cabal to configure a package until we have
369 # configured and registered all of its dependencies. So the following
370 # hack forces all the configure steps to happen in exactly the following order:
372 # $(PACKAGES) ghc(stage2) $(PACKAGES_STAGE2)
374 # Ideally we should use the correct dependencies here to allow more
375 # parallelism, but we don't know the dependencies until we've
376 # generated the pacakge-data.mk files.
378 libraries/$1/$2/package-data.mk : $$(GHC_PKG_INPLACE) $$(fixed_pkg_prev)
379 fixed_pkg_prev:=libraries/$1/$2/package-data.mk
382 ifneq "$(BINDIST)" "YES"
384 $(foreach pkg,$(PACKAGES),$(eval $(call fixed_pkg_dep,$(pkg),dist-install)))
386 # the GHC package doesn't live in libraries/, so we add its dependency manually:
387 compiler/stage2/package-data.mk: $(fixed_pkg_prev)
388 fixed_pkg_prev:=compiler/stage2/package-data.mk
390 # and continue with PACKAGES_STAGE2, which depend on GHC:
391 $(foreach pkg,$(PACKAGES_STAGE2),$(eval $(call fixed_pkg_dep,$(pkg),dist-install)))
393 ghc/stage1/package-data.mk: compiler/stage1/package-data.mk
394 ghc/stage2/package-data.mk: compiler/stage2/package-data.mk
395 # haddock depends on ghc and some libraries, but depending on GHC's
396 # package-data.mk is sufficient, as that in turn depends on all the
398 utils/haddock/dist/package-data.mk: compiler/stage2/package-data.mk
400 utils/hsc2hs/dist-install/package-data.mk: compiler/stage2/package-data.mk
402 # add the final two package.conf dependencies: ghc-prim depends on RTS,
403 # and RTS depends on libffi.
404 libraries/ghc-prim/dist-install/package-data.mk : rts/package.conf.inplace
405 rts/package.conf.inplace : libffi/package.conf.inplace
408 # -----------------------------------------------------------------------------
411 # Don't try to delete directories:
414 # Create build directories on demand. NB. the | below: this indicates
415 # that $(MKDIRHIER) is an order-only dependency, which means that this
416 # rule fires after building mkdirhier, but we won't try to recreate
417 # directories if mkdirhier changes.
421 # -----------------------------------------------------------------------------
422 # Special magic for the ghc-prim package
424 # We want the ghc-prim package to include the GHC.Prim module when it
425 # is registered, but not when it is built, because GHC.Prim is not a
426 # real source module, it is built-in to GHC. The old build system did
427 # this using Setup.hs, but we can't do that here, so we have a flag to
428 # enable GHC.Prim in the .cabal file (so that the ghc-prim package
429 # remains compatible with the old build system for the time being).
430 # GHC.Prim module in the ghc-prim package with a flag:
432 libraries/ghc-prim_CONFIGURE_OPTS += --flag=include-ghc-prim
434 # And then we strip it out again before building the package:
435 define libraries/ghc-prim_PACKAGE_MAGIC
436 libraries/ghc-prim_dist-install_MODULES := $$(filter-out GHC.Prim,$$(libraries/ghc-prim_dist-install_MODULES))
439 PRIMOPS_TXT = $(GHC_COMPILER_DIR)/prelude/primops.txt
441 libraries/ghc-prim/dist-install/build/GHC/PrimopWrappers.hs : $(GENPRIMOP_INPLACE) $(PRIMOPS_TXT) | $$(dir $$@)/.
442 "$(GENPRIMOP_INPLACE)" --make-haskell-wrappers <$(PRIMOPS_TXT) >$@
444 libraries/ghc-prim/GHC/Prim.hs : $(GENPRIMOP_INPLACE) $(PRIMOPS_TXT)
445 "$(GENPRIMOP_INPLACE)" --make-haskell-source <$(PRIMOPS_TXT) >$@
448 # -----------------------------------------------------------------------------
449 # Include build instructions from all subdirs
451 # For the rationale behind the build phases, see
452 # http://hackage.haskell.org/trac/ghc/wiki/Building/Architecture/Idiom/PhaseOrdering
454 # Setting foo_dist_DISABLE=YES means "in directory foo, for build
455 # "dist", just read the package-data.mk file, do not build anything".
457 # We carefully engineer things so that we can build the
458 # package-data.mk files early on: they depend only on a few tools also
459 # built early. Having got the package-data.mk files built, we can
460 # restart make with up-to-date information about all the packages
461 # (this is phase 0). The remaining problem is the .depend files:
463 # - .depend files in libraries need the stage 1 compiler to build
464 # - ghc/stage1/.depend needs compiler/stage1 built
465 # - compiler/stage1/.depend needs the bootstrap libs built
467 # GHC 6.11+ can build a .depend file without having built the
468 # dependencies of the package, but we can't rely on the bootstrapping
469 # compiler being able to do this, which is why we have to separate the
470 # three phases above.
472 # So this is the final ordering:
474 # Phase 0 : all package-data.mk files
475 # (requires ghc-cabal, ghc-pkg, mkdirhier, dummy-ghc etc.)
476 # Phase 1 : .depend files for bootstrap libs
478 # Phase 2 : compiler/stage1/.depend
479 # (requires bootstrap libs and genprimopcode)
480 # Phase 3 : ghc/stage1/.depend
481 # (requires compiler/stage1)
483 # The rest : libraries/*/dist-install, compiler/stage2, ghc/stage2
487 ifneq "$(BINDIST)" "YES"
489 $(GHC_MKDEPENDC_DIR) \
496 libraries/Cabal/doc \
500 ifneq "$(GhcUnregisterised)" "YES"
506 ifneq "$(BINDIST)" "YES"
519 ifneq "$(BINDIST)" "YES"
525 ifneq "$(HADDOCK_DOCS)" "NO"
531 ifneq "$(CLEANING)" "YES"
533 $(patsubst %, libraries/%, $(PACKAGES))
536 ifneq "$(BootingFromHc)" "YES"
541 ifeq "$(INTEGER_LIBRARY)" "integer-gmp"
542 BUILD_DIRS += libraries/integer-gmp/gmp
552 ifeq "$(Windows)" "YES"
557 ifneq "$(CLEANING)" "YES"
558 # After compiler/, because these packages depend on it
560 $(patsubst %, libraries/%, $(PACKAGES_STAGE2))
563 # XXX libraries/% must come before any programs built with stage1, see
564 # Note [lib-depends].
567 $(foreach lib,$(BOOT_PKGS),$(eval \
568 libraries/$(lib)_dist-boot_DISABLE = YES))
571 ifneq "$(findstring $(phase),0 1)" ""
572 # We can build deps for compiler/stage1 in phase 2
573 compiler_stage1_DISABLE = YES
576 ifneq "$(findstring $(phase),0 1 2)" ""
577 ghc_stage1_DISABLE = YES
580 ifneq "$(CLEANING)" "YES"
581 ifeq "$(INTEGER_LIBRARY)" "integer-gmp"
582 libraries/base_dist-install_CONFIGURE_OPTS += --flags=-integer-simple
584 ifeq "$(INTEGER_LIBRARY)" "integer-simple"
585 libraries/base_dist-install_CONFIGURE_OPTS += --flags=integer-simple
587 $(error Unknown integer library: $(INTEGER_LIBRARY))
592 ifneq "$(findstring $(phase),0 1 2 3)" ""
593 # In phases 0-3, we disable stage2-3, the full libraries and haddock
594 utils/haddock_dist_DISABLE = YES
595 utils/runghc_dist_DISABLE = YES
596 utils/hpc_dist_DISABLE = YES
597 utils/hsc2hs_dist-install_DISABLE = YES
598 utils/ghc-pkg_dist-install_DISABLE = YES
599 compiler_stage2_DISABLE = YES
600 compiler_stage3_DISABLE = YES
601 ghc_stage2_DISABLE = YES
602 ghc_stage3_DISABLE = YES
603 $(foreach lib,$(PACKAGES) $(PACKAGES_STAGE2),$(eval \
604 libraries/$(lib)_dist-install_DISABLE = YES))
607 # These packages don't pass the Cabal checks because hs-source-dirs
608 # points outside the source directory. This isn't a real problem in
609 # these cases, so we just skip checking them.
610 CHECKED_libraries/dph/dph-seq = YES
611 CHECKED_libraries/dph/dph-par = YES
612 # In compiler's case, include-dirs points outside of the source tree
613 CHECKED_compiler = YES
615 include $(patsubst %, %/ghc.mk, $(BUILD_DIRS))
617 # We need -fno-warn-deprecated-flags to avoid failure with -Werror
618 GhcLibHcOpts += -fno-warn-deprecated-flags
619 ifeq "$(ghc_ge_609)" "YES"
620 GhcBootLibHcOpts += -fno-warn-deprecated-flags
623 # Add $(GhcLibHcOpts) to all library builds
624 $(foreach pkg,$(PACKAGES) $(PACKAGES_STAGE2),$(eval libraries/$(pkg)_dist-install_HC_OPTS += $$(GhcLibHcOpts)))
626 # XXX Hack; remove this
627 $(foreach pkg,$(PACKAGES_STAGE2),$(eval libraries/$(pkg)_dist-install_HC_OPTS += -Wwarn))
629 # A useful pseudo-target
631 stage1_libs : $(ALL_STAGE1_LIBS)
633 ifeq "$(HADDOCK_DOCS)" "YES"
634 libraries/index.html: $(ALL_HADDOCK_FILES)
635 cd libraries && sh gen_contents_index --inplace
636 $(eval $(call all-target,library_doc_index,libraries/index.html))
637 INSTALL_LIBRARY_DOCS += libraries/*.html libraries/*.gif libraries/*.css libraries/*.js
638 CLEAN_FILES += libraries/doc-index* libraries/haddock*.css \
639 libraries/haddock*.js libraries/index*.html libraries/*.gif
642 ifeq "$(CHECK_PACKAGES)" "YES"
646 # -----------------------------------------------------------------------------
647 # Bootstrapping libraries
649 # We need to build a few libraries with the installed GHC, since GHC itself
650 # and some of the tools depend on them:
652 ifneq "$(BINDIST)" "YES"
654 ifneq "$(BOOTSTRAPPING_CONF)" ""
655 ifeq "$(wildcard $(BOOTSTRAPPING_CONF))" ""
656 $(shell echo "[]" >$(BOOTSTRAPPING_CONF))
660 $(eval $(call clean-target,$(BOOTSTRAPPING_CONF),,$(BOOTSTRAPPING_CONF)))
662 # These three libraries do not depend on each other, so we can build
665 $(eval $(call build-package,libraries/hpc,dist-boot,0))
666 $(eval $(call build-package,libraries/extensible-exceptions,dist-boot,0))
667 $(eval $(call build-package,libraries/Cabal,dist-boot,0))
668 $(eval $(call build-package,libraries/binary,dist-boot,0))
669 $(eval $(call build-package,libraries/bin-package-db,dist-boot,0))
671 # register the boot packages in strict sequence, because running
672 # multiple ghc-pkgs in parallel doesn't work (registrations may get
675 $(foreach pkg,$(BOOT_PKGS),$(eval $(call fixed_pkg_dep,$(pkg),dist-boot)))
677 compiler/stage1/package-data.mk : \
678 libraries/Cabal/dist-boot/package-data.mk \
679 libraries/hpc/dist-boot/package-data.mk \
680 libraries/extensible-exceptions/dist-boot/package-data.mk \
681 libraries/bin-package-db/dist-boot/package-data.mk
683 # These are necessary because the bootstrapping compiler may not know
684 # about cross-package dependencies:
685 $(compiler_stage1_depfile) : $(BOOT_LIBS)
686 $(ghc_stage1_depfile) : $(compiler_stage1_v_LIB)
688 # A few careful dependencies between bootstrapping packages. When we
689 # can rely on the stage 0 compiler being able to generate
690 # cross-package dependencies with -M (fixed in GHC 6.12.1) we can drop
691 # these, and also some of the phases.
693 # If you miss any out here, then 'make -j8' will probably tell you.
695 libraries/bin-package-db/dist-boot/build/Distribution/InstalledPackageInfo/Binary.$(v_osuf) : libraries/binary/dist-boot/build/Data/Binary.$(v_hisuf) libraries/Cabal/dist-boot/build/Distribution/InstalledPackageInfo.$(v_hisuf)
697 $(foreach pkg,$(BOOT_PKGS),$(eval libraries/$(pkg)_dist-boot_HC_OPTS += $$(GhcBootLibHcOpts)))
699 # Make sure we have all the GHCi libs by the time we've built
700 # ghc-stage2. DPH includes a bit of Template Haskell which needs the
701 # GHCI libs, and we don't have a better way to express that dependency.
703 GHCI_LIBS = $(foreach lib,$(PACKAGES),$(libraries/$(lib)_dist-install_GHCI_LIB)) \
704 $(compiler_stage2_GHCI_LIB)
706 ghc/stage2/build/tmp/$(ghc_stage2_PROG) : $(GHCI_LIBS)
710 # -----------------------------------------------------------------------------
711 # Creating a local mingw copy on Windows
713 ifeq "$(Windows)" "YES"
715 install : install_mingw
716 .PHONY: install_mingw
717 install_mingw : $(INPLACE_MINGW)
718 "$(CP)" -Rp $(INPLACE_MINGW) $(prefix)
720 install : install_perl
722 install_perl : $(INPLACE_PERL)
723 "$(CP)" -Rp $(INPLACE_PERL) $(prefix)
727 ifneq "$(BINDIST)" "YES"
728 $(ghc-prim_HADDOCK_FILE): \
729 libraries/ghc-prim/dist-install/build/autogen/GHC/Prim.hs \
730 libraries/ghc-prim/dist-install/build/autogen/GHC/PrimopWrappers.hs
733 libraries/ghc-prim/dist-install/build/autogen/GHC/Prim.hs: \
734 $(PRIMOPS_TXT) $(GENPRIMOP_INPLACE) \
736 "$(GENPRIMOP_INPLACE)" --make-haskell-source < $< > $@
738 libraries/ghc-prim/dist-install/build/autogen/GHC/PrimopWrappers.hs: \
739 $(PRIMOPS_TXT) $(GENPRIMOP_INPLACE) \
741 "$(GENPRIMOP_INPLACE)" --make-haskell-wrappers < $< > $@
743 # -----------------------------------------------------------------------------
746 install: install_packages install_libs install_libexecs install_headers \
747 install_libexec_scripts install_bins install_docs \
748 install_topdirs install_topdir_scripts
750 install_bins: $(INSTALL_BINS)
751 $(INSTALL_DIR) "$(DESTDIR)$(bindir)"
752 for i in $(INSTALL_BINS); do \
753 $(INSTALL_PROGRAM) $(INSTALL_BIN_OPTS) $$i "$(DESTDIR)$(bindir)" ; \
754 if test "$(darwin_TARGET_OS)" = "1"; then \
755 sh mk/fix_install_names.sh $(ghclibdir) "$(DESTDIR)$(bindir)/$$i" ; \
759 install_libs: $(INSTALL_LIBS)
760 $(INSTALL_DIR) "$(DESTDIR)$(ghclibdir)"
761 for i in $(INSTALL_LIBS); do \
764 $(INSTALL_DATA) $(INSTALL_OPTS) $$i "$(DESTDIR)$(ghclibdir)"; \
765 $(RANLIB) $(DESTDIR)$(ghclibdir)/`basename $$i` ;; \
767 $(INSTALL_DATA) -s $(INSTALL_OPTS) $$i "$(DESTDIR)$(ghclibdir)" ;; \
769 $(INSTALL_SHLIB) $(INSTALL_OPTS) $$i "$(DESTDIR)$(ghclibdir)" ;; \
771 $(INSTALL_SHLIB) $(INSTALL_OPTS) $$i "$(DESTDIR)$(ghclibdir)"; \
772 install_name_tool -id "$(DESTDIR)$(ghclibdir)/`basename $$i`" "$(DESTDIR)$(ghclibdir)/`basename $$i`" ;; \
774 $(INSTALL_DATA) $(INSTALL_OPTS) $$i "$(DESTDIR)$(ghclibdir)"; \
778 install_libexec_scripts: $(INSTALL_LIBEXEC_SCRIPTS)
779 ifeq "$(INSTALL_LIBEXEC_SCRIPTS)" ""
782 $(INSTALL_DIR) "$(DESTDIR)$(ghclibexecdir)"
783 for i in $(INSTALL_LIBEXEC_SCRIPTS); do \
784 $(INSTALL_SCRIPT) $(INSTALL_OPTS) $$i "$(DESTDIR)$(ghclibexecdir)"; \
788 install_libexecs: $(INSTALL_LIBEXECS)
789 ifeq "$(INSTALL_LIBEXECS)" ""
792 $(INSTALL_DIR) "$(DESTDIR)$(ghclibexecdir)"
793 for i in $(INSTALL_LIBEXECS); do \
794 $(INSTALL_PROGRAM) $(INSTALL_BIN_OPTS) $$i "$(DESTDIR)$(ghclibexecdir)"; \
796 # We rename ghc-stage2, so that the right program name is used in error
798 "$(MV)" "$(DESTDIR)$(ghclibexecdir)/ghc-stage2" "$(DESTDIR)$(ghclibexecdir)/ghc"
801 install_topdir_scripts: $(INSTALL_TOPDIR_SCRIPTS)
802 $(INSTALL_DIR) "$(DESTDIR)$(topdir)"
803 for i in $(INSTALL_TOPDIR_SCRIPTS); do \
804 $(INSTALL_SCRIPT) $(INSTALL_OPTS) $$i "$(DESTDIR)$(topdir)"; \
807 install_topdirs: $(INSTALL_TOPDIRS)
808 $(INSTALL_DIR) "$(DESTDIR)$(topdir)"
809 for i in $(INSTALL_TOPDIRS); do \
810 $(INSTALL_PROGRAM) $(INSTALL_BIN_OPTS) $$i "$(DESTDIR)$(topdir)"; \
813 install_headers: $(INSTALL_HEADERS)
814 $(INSTALL_DIR) "$(DESTDIR)$(ghcheaderdir)"
815 for i in $(INSTALL_HEADERS); do \
816 $(INSTALL_HEADER) $(INSTALL_OPTS) $$i "$(DESTDIR)$(ghcheaderdir)"; \
819 install_docs: $(INSTALL_DOCS)
820 $(INSTALL_DIR) "$(DESTDIR)$(docdir)"
821 ifneq "$(INSTALL_DOCS)" ""
822 for i in $(INSTALL_DOCS); do \
823 $(INSTALL_DOC) $(INSTALL_OPTS) $$i "$(DESTDIR)$(docdir)"; \
826 $(INSTALL_DIR) $(INSTALL_OPTS) "$(DESTDIR)$(docdir)/html"
827 $(INSTALL_DOC) $(INSTALL_OPTS) docs/index.html "$(DESTDIR)$(docdir)/html"
828 ifneq "$(INSTALL_LIBRARY_DOCS)" ""
829 $(INSTALL_DIR) $(INSTALL_OPTS) "$(DESTDIR)$(docdir)/html/libraries"
830 for i in $(INSTALL_LIBRARY_DOCS); do \
831 $(INSTALL_DOC) $(INSTALL_OPTS) $$i "$(DESTDIR)$(docdir)/html/libraries/"; \
833 $(INSTALL_DATA) $(INSTALL_OPTS) libraries/prologue.txt "$(DESTDIR)$(docdir)/html/libraries/"
834 $(INSTALL_SCRIPT) $(INSTALL_OPTS) libraries/gen_contents_index "$(DESTDIR)$(docdir)/html/libraries/"
836 ifneq "$(INSTALL_HTML_DOC_DIRS)" ""
837 for i in $(INSTALL_HTML_DOC_DIRS); do \
838 $(INSTALL_DIR) $(INSTALL_OPTS) "$(DESTDIR)$(docdir)/html/`basename $$i`"; \
839 $(INSTALL_DOC) $(INSTALL_OPTS) $$i/* "$(DESTDIR)$(docdir)/html/`basename $$i`"; \
843 INSTALLED_PACKAGE_CONF=$(DESTDIR)$(topdir)/package.conf.d
845 # Install packages in the right order, so that ghc-pkg doesn't complain.
846 # Also, install ghc-pkg first.
847 ifeq "$(Windows)" "NO"
848 INSTALLED_GHC_REAL=$(DESTDIR)$(ghclibexecdir)/ghc
849 INSTALLED_GHC_PKG_REAL=$(DESTDIR)$(ghclibexecdir)/ghc-pkg
851 INSTALLED_GHC_REAL=$(DESTDIR)$(bindir)/ghc.exe
852 INSTALLED_GHC_PKG_REAL=$(DESTDIR)$(bindir)/ghc-pkg.exe
855 INSTALLED_PACKAGES = $(filter-out haskeline mtl terminfo,$(PACKAGES))
856 HIDDEN_PACKAGES = binary
858 define set_INSTALL_DISTDIR
859 # $1 = libraries/base, $2 = dist-install
861 # INSTALL_DISTDIR_libraries/base = dist-install
862 INSTALL_DISTDIR_$1 = $2
865 $(eval $(foreach p,$(INSTALLED_PACKAGES) $(PACKAGES_STAGE2),\
866 $(call set_INSTALL_DISTDIR,libraries/$p,dist-install)))
867 INSTALL_DISTDIR_compiler = stage2
869 ALL_INSTALLED_PACKAGES = $(addprefix libraries/,$(INSTALLED_PACKAGES)) \
871 $(addprefix libraries/,$(PACKAGES_STAGE2))
873 install_packages: install_libexecs
874 install_packages: libffi/package.conf.install rts/package.conf.install
875 $(INSTALL_DIR) "$(DESTDIR)$(topdir)"
876 "$(RM)" -r $(RM_OPTS) "$(INSTALLED_PACKAGE_CONF)"
877 $(INSTALL_DIR) "$(INSTALLED_PACKAGE_CONF)"
878 "$(INSTALLED_GHC_PKG_REAL)" --force --global-conf "$(INSTALLED_PACKAGE_CONF)" update libffi/package.conf.install
879 "$(INSTALLED_GHC_PKG_REAL)" --force --global-conf "$(INSTALLED_PACKAGE_CONF)" update rts/package.conf.install
880 $(foreach p, $(ALL_INSTALLED_PACKAGES),\
881 "$(GHC_CABAL_INPLACE)" install \
882 "$(INSTALLED_GHC_REAL)" \
883 "$(INSTALLED_GHC_PKG_REAL)" \
885 "$(DESTDIR)$(topdir)" \
886 $p $(INSTALL_DISTDIR_$p) \
887 '$(DESTDIR)' '$(prefix)' '$(ghclibdir)' '$(docdir)/html/libraries' \
888 $(RelocatableBuild) &&) true
889 $(foreach p, $(HIDDEN_PACKAGES),\
890 "$(INSTALLED_GHC_PKG_REAL)" --global-conf "$(INSTALLED_PACKAGE_CONF)" \
893 # -----------------------------------------------------------------------------
894 # Binary distributions
896 ifneq "$(CLEANING)" "YES"
897 # This rule seems to hold some files open on Windows which prevents
898 # cleaning, perhaps due to the $(wildcard).
900 $(eval $(call bindist,.,\
902 configure config.sub config.guess install-sh \
906 $(INPLACE_BIN)/mkdirhier \
907 $(INPLACE_BIN)/ghc-cabal \
908 utils/ghc-pwd/ghc-pwd \
909 $(BINDIST_WRAPPERS) \
913 $(includes_H_CONFIG) \
914 $(includes_H_PLATFORM) \
915 $(includes_H_FILES) \
916 includes/ghcconfig.h \
917 includes/rts/Config.h \
919 $(INSTALL_LIBEXECS) \
920 $(INSTALL_LIBEXEC_SCRIPTS) \
922 $(INSTALL_TOPDIR_SCRIPTS) \
924 $(INSTALL_MANPAGES) \
926 $(INSTALL_LIBRARY_DOCS) \
927 $(addsuffix /*,$(INSTALL_HTML_DOC_DIRS)) \
929 compiler/stage2/doc \
930 $(wildcard libraries/*/dist-install/doc/) \
931 $(filter-out extra-gcc-opts,$(INSTALL_LIBS)) \
932 $(filter-out %/project.mk mk/config.mk %/mk/install.mk,$(MAKEFILE_LIST)) \
933 mk/fix_install_names.sh \
937 libraries/gen_contents_index \
938 libraries/prologue.txt \
939 libraries/dph/LICENSE \
942 # mk/project.mk gets an absolute path, so we manually include it in
943 # the bindist with a relative path
945 BIN_DIST_MK = $(BIN_DIST_PREP_DIR)/bindist.mk
947 unix-binary-dist-prep:
948 "$(RM)" $(RM_OPTS) -r bindistprep/
949 "$(MKDIRHIER)" $(BIN_DIST_PREP_DIR)
950 set -e; for i in LICENSE compiler ghc rts libraries utils docs libffi includes driver mk rules Makefile aclocal.m4 config.sub config.guess install-sh extra-gcc-opts.in ghc.mk inplace; do ln -s ../../$$i $(BIN_DIST_PREP_DIR)/; done
951 echo "HADDOCK_DOCS = $(HADDOCK_DOCS)" >> $(BIN_DIST_MK)
952 echo "LATEX_DOCS = $(LATEX_DOCS)" >> $(BIN_DIST_MK)
953 echo "BUILD_DOCBOOK_HTML = $(BUILD_DOCBOOK_HTML)" >> $(BIN_DIST_MK)
954 echo "BUILD_DOCBOOK_PS = $(BUILD_DOCBOOK_PS)" >> $(BIN_DIST_MK)
955 echo "BUILD_DOCBOOK_PDF = $(BUILD_DOCBOOK_PDF)" >> $(BIN_DIST_MK)
956 echo "BUILD_MAN = $(BUILD_MAN)" >> $(BIN_DIST_MK)
957 ln -s ../../distrib/configure-bin.ac $(BIN_DIST_PREP_DIR)/configure.ac
958 cd $(BIN_DIST_PREP_DIR) && autoreconf
959 "$(RM)" $(RM_OPTS) $(BIN_DIST_PREP_TAR)
960 # h means "follow symlinks", e.g. if aclocal.m4 is a symlink to a source
961 # tree then we want to include the real file, not a symlink to it
962 cd bindistprep && "$(TAR)" hcf - -T ../$(BIN_DIST_LIST) | bzip2 -c > ../$(BIN_DIST_PREP_TAR_BZ2)
964 windows-binary-dist-prep:
965 "$(RM)" $(RM_OPTS) -r bindistprep/
966 $(MAKE) prefix=$(TOP)/$(BIN_DIST_PREP_DIR) install
967 cd bindistprep && "$(TAR)" cf - $(BIN_DIST_NAME) | bzip2 -c > ../$(BIN_DIST_PREP_TAR_BZ2)
971 @echo No ISCC, so not making installer
973 "$(ISCC)" /O. /Fbindistprep/$(WINDOWS_INSTALLER_BASE) - < distrib/ghc.iss
976 nTimes = set -e; for i in `seq 1 $(1)`; do echo Try "$$i: $(2)"; if $(2); then break; fi; done
978 .PHONY: publish-binary-dist
980 $(call nTimes,10,$(PublishCp) $(BIN_DIST_TAR_BZ2) $(PublishLocation)/dist)
981 ifeq "$(mingw32_TARGET_OS)" "1"
982 $(call nTimes,10,$(PublishCp) $(WINDOWS_INSTALLER) $(PublishLocation)/dist)
987 $(call nTimes,10,$(PublishCp) -r bindisttest/installed/share/doc/ghc/* $(PublishLocation)/docs)
989 # -----------------------------------------------------------------------------
990 # Source distributions
998 # A source dist is built from a complete build tree, because we
999 # require some extra files not contained in a darcs checkout: the
1000 # output from Happy and Alex, for example.
1002 # The steps performed by 'make dist' are as follows:
1003 # - create a complete link-tree of the current build tree in /tmp
1004 # - run 'make distclean' on that tree
1005 # - remove a bunch of other files that we know shouldn't be in the dist
1006 # - tar up first the extralibs package, then the main source package
1009 # Directory in which we're going to build the src dist
1011 SRC_DIST_NAME=ghc-$(ProjectVersion)
1012 SRC_DIST_DIR=$(shell pwd)/$(SRC_DIST_NAME)
1015 # Files to include in source distributions
1017 SRC_DIST_DIRS = mk rules docs distrib bindisttest libffi includes utils docs rts compiler ghc driver libraries ghc-tarballs
1019 configure.ac config.guess config.sub configure \
1020 aclocal.m4 README ANNOUNCE HACKING LICENSE Makefile install-sh \
1021 ghc.spec.in ghc.spec extra-gcc-opts.in VERSION \
1022 boot boot-pkgs packages ghc.mk
1024 SRC_DIST_TARBALL = $(SRC_DIST_NAME)-src.tar.bz2
1027 echo $(ProjectVersion) >VERSION
1032 # $(call sdist_file,compiler,stage2,cmm,Foo/Bar,CmmLex,x)
1033 # to copy the generated file that replaces compiler/cmm/Foo/Bar/CmmLex.x, where
1034 # "stage2" is the dist dir.
1036 "$(CP)" $1/$2/build/$4/$5.hs $(SRC_DIST_DIR)/$1/$3/$4
1037 mv $(SRC_DIST_DIR)/$1/$3/$4/$5.$6 $(SRC_DIST_DIR)/$1/$3/$4/$5.$6.source
1042 "$(RM)" $(RM_OPTS) -r $(SRC_DIST_DIR)
1043 "$(RM)" $(RM_OPTS) $(SRC_DIST_TARBALL)
1044 mkdir $(SRC_DIST_DIR)
1045 cd $(SRC_DIST_DIR) && for i in $(SRC_DIST_DIRS); do mkdir $$i; ( cd $$i && lndir $(TOP)/$$i ); done
1046 cd $(SRC_DIST_DIR) && for i in $(SRC_DIST_FILES); do $(LN_S) $(TOP)/$$i .; done
1047 cd $(SRC_DIST_DIR) && $(MAKE) distclean
1048 rm -rf $(SRC_DIST_DIR)/libraries/tarballs/
1049 rm -rf $(SRC_DIST_DIR)/libraries/stamp/
1050 $(call sdist_file,compiler,stage2,cmm,,CmmLex,x)
1051 $(call sdist_file,compiler,stage2,cmm,,CmmParse,y)
1052 $(call sdist_file,compiler,stage2,parser,,Lexer,x)
1053 $(call sdist_file,compiler,stage2,parser,,Parser,y.pp)
1054 $(call sdist_file,compiler,stage2,parser,,ParserCore,y)
1055 $(call sdist_file,utils/hpc,dist,,,HpcParser,y)
1056 $(call sdist_file,utils/genprimopcode,dist,,,Lexer,x)
1057 $(call sdist_file,utils/genprimopcode,dist,,,Parser,y)
1058 $(call sdist_file,utils/haddock,dist,src,Haddock/Interface,Lex,x)
1059 $(call sdist_file,utils/haddock,dist,src,Haddock/Interface,Parse,y)
1060 cd $(SRC_DIST_DIR) && "$(RM)" $(RM_OPTS) -r compiler/stage[123] mk/build.mk
1061 cd $(SRC_DIST_DIR) && "$(FIND)" $(SRC_DIST_DIRS) \( -name _darcs -o -name SRC -o -name "autom4te*" -o -name "*~" -o -name ".cvsignore" -o -name "\#*" -o -name ".\#*" -o -name "log" -o -name "*-SAVE" -o -name "*.orig" -o -name "*.rej" -o -name "*-darcs-backup*" \) -print | "$(XARGS)" $(XARGS_OPTS) "$(RM)" $(RM_OPTS) -r
1065 "$(TAR)" chf - $(SRC_DIST_NAME) 2>$src_log | bzip2 >$(TOP)/$(SRC_DIST_TARBALL)
1067 sdist-manifest : $(SRC_DIST_TARBALL)
1068 tar tjf $(SRC_DIST_TARBALL) | sed "s|^ghc-$(ProjectVersion)/||" | sort >sdist-manifest
1070 # Upload the distribution(s)
1071 # Retrying is to work around buggy firewalls that corrupt large file transfers
1073 ifneq "$(PublishLocation)" ""
1075 $(call nTimes,10,$(PublishCp) $(SRC_DIST_TARBALL) $(PublishLocation)/dist)
1078 ifeq "$(BootingFromHc)" "YES"
1079 # In a normal build we use GHC to compile C files (see
1080 # rules/c-suffix-rules.mk), which passes a number of its own options
1081 # to the C compiler. So when bootstrapping we have to provide these
1082 # flags explicitly to C compilations.
1083 SRC_CC_OPTS += -DNO_REGS -DUSE_MINIINTERPRETER
1084 SRC_CC_OPTS += -D__GLASGOW_HASKELL__=$(ProjectVersionInt)
1085 SRC_CC_OPTS += -I$(GHC_INCLUDE_DIR)
1088 # -----------------------------------------------------------------------------
1089 # sdisting libraries
1091 # Use manually, with e.g.:
1092 # make sdist_directory
1095 inplace/bin/ghc-cabal sdist libraries/$* dist-install
1097 # -----------------------------------------------------------------------------
1102 CLEAN_FILES += utils/ghc-pwd/ghc-pwd
1103 CLEAN_FILES += utils/ghc-pwd/ghc-pwd.exe
1104 CLEAN_FILES += utils/ghc-pwd/ghc-pwd.hi
1105 CLEAN_FILES += utils/ghc-pwd/ghc-pwd.o
1106 CLEAN_FILES += libraries/bootstrapping.conf
1107 CLEAN_FILES += libraries/integer-gmp/cbits/GmpDerivedConstants.h
1108 CLEAN_FILES += libraries/integer-gmp/cbits/mkGmpDerivedConstants
1110 clean : clean_files clean_libraries
1114 "$(RM)" $(RM_OPTS) $(CLEAN_FILES)
1116 ifneq "$(NO_CLEAN_GMP)" "YES"
1117 CLEAN_FILES += libraries/integer-gmp/gmp/gmp.h
1118 CLEAN_FILES += libraries/integer-gmp/gmp/libgmp.a
1123 "$(RM)" $(RM_OPTS) -r libraries/integer-gmp/gmp/objs
1124 "$(RM)" $(RM_OPTS) -r libraries/integer-gmp/gmp/gmpbuild
1127 .PHONY: clean_libraries
1128 clean_libraries: $(patsubst %,clean_libraries/%_dist-install,$(PACKAGES) $(PACKAGES_STAGE2))
1129 clean_libraries: $(patsubst %,clean_libraries/%_dist-boot,$(BOOT_PKGS))
1132 "$(RM)" $(RM_OPTS) -r $(patsubst %, libraries/%/dist, $(PACKAGES) $(PACKAGES_STAGE2))
1133 "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/*.buildinfo, $(PACKAGES) $(PACKAGES_STAGE2))
1135 # We have to define a clean target for each library manually, because the
1136 # libraries/*/ghc.mk files are not included when we're cleaning.
1137 ifeq "$(CLEANING)" "YES"
1138 $(foreach lib,$(PACKAGES) $(PACKAGES_STAGE2),\
1139 $(eval $(call clean-target,libraries/$(lib),dist-install,libraries/$(lib)/dist-install)))
1142 clean : clean_bindistprep
1143 .PHONY: clean_bindistprep
1145 "$(RM)" $(RM_OPTS) -r bindistprep/
1148 "$(RM)" $(RM_OPTS) config.cache config.status config.log mk/config.h mk/stamp-h
1149 "$(RM)" $(RM_OPTS) mk/config.mk mk/are-validating.mk mk/project.mk
1150 "$(RM)" $(RM_OPTS) mk/config.mk.old mk/project.mk.old
1151 "$(RM)" $(RM_OPTS) extra-gcc-opts docs/users_guide/ug-book.xml
1152 "$(RM)" $(RM_OPTS) compiler/ghc.cabal compiler/ghc.cabal.old
1153 "$(RM)" $(RM_OPTS) ghc/ghc-bin.cabal
1154 "$(RM)" $(RM_OPTS) libraries/base/include/HsBaseConfig.h
1155 "$(RM)" $(RM_OPTS) libraries/directory/include/HsDirectoryConfig.h
1156 "$(RM)" $(RM_OPTS) libraries/process/include/HsProcessConfig.h
1157 "$(RM)" $(RM_OPTS) libraries/unix/include/HsUnixConfig.h
1158 "$(RM)" $(RM_OPTS) libraries/old-time/include/HsTimeConfig.h
1160 "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/config.log, $(PACKAGES) $(PACKAGES_STAGE2))
1161 "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/config.status, $(PACKAGES) $(PACKAGES_STAGE2))
1162 "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/include/Hs*Config.h, $(PACKAGES) $(PACKAGES_STAGE2))
1163 "$(RM)" $(RM_OPTS) -r $(patsubst %, libraries/%/autom4te.cache, $(PACKAGES) $(PACKAGES_STAGE2))
1165 maintainer-clean : distclean
1166 "$(RM)" $(RM_OPTS) configure mk/config.h.in
1167 "$(RM)" $(RM_OPTS) -r autom4te.cache libraries/*/autom4te.cache
1168 "$(RM)" $(RM_OPTS) ghc.spec
1169 "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/GNUmakefile, \
1170 $(PACKAGES) $(PACKAGES_STAGE2))
1171 "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/ghc.mk, $(PACKAGES) $(PACKAGES_STAGE2))
1172 "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/configure, \
1173 $(PACKAGES) $(PACKAGES_STAGE2))
1174 "$(RM)" $(RM_OPTS) libraries/base/include/HsBaseConfig.h.in
1175 "$(RM)" $(RM_OPTS) libraries/directory/include/HsDirectoryConfig.h.in
1176 "$(RM)" $(RM_OPTS) libraries/process/include/HsProcessConfig.h.in
1177 "$(RM)" $(RM_OPTS) libraries/unix/include/HsUnixConfig.h.in
1178 "$(RM)" $(RM_OPTS) libraries/old-time/include/HsTimeConfig.h.in
1180 .PHONY: all_libraries
1182 .PHONY: bootstrapping-files
1183 bootstrapping-files: $(OTHER_LIBS)
1184 bootstrapping-files: includes/ghcautoconf.h
1185 bootstrapping-files: includes/DerivedConstants.h
1186 bootstrapping-files: includes/GHCConstants.h