Always haddock by default
[ghc-hetmet.git] / ghc.mk
1 # -----------------------------------------------------------------------------
2 #
3 # (c) 2009 The University of Glasgow
4 #
5 # This file is part of the GHC build system.
6 #
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
10 #
11 # -----------------------------------------------------------------------------
12
13 # ToDo List.
14 #
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
22 #     * docs/Makefile
23 #     * docs/docbook-cheat-sheet/Makefile
24 #     * docs/ext-core/Makefile
25 #     * docs/man/Makefile
26 #     * docs/storage-mgmt/Makefile
27 #     * docs/vh/Makefile
28 #     * rts/dotnet/Makefile
29 #     * utils/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)
33 #
34 # Tickets we can now close, or fix and close:
35 #
36 #   * 1693 make distclean
37
38 # Possible cleanups:
39 #
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
45 #     of different ways.
46 #   * make PACKAGES generated by './configure' or 'perl 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.
52
53 # Approximate build order.
54 #
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
58 #
59 #     * With bootstrapping compiler:
60 #           o Build utils/ghc-cabal
61 #           o Build utils/ghc-pkg
62 #           o Build utils/hsc2hs
63 #     * For each package:
64 #           o configure, generate package-data.mk and inplace-pkg-info
65 #           o register each package into inplace/lib/package.conf
66 #     * build libffi
67 #     * With bootstrapping compiler:
68 #           o Build libraries/{filepath,hpc,extensible-exceptions,Cabal}
69 #           o Build compiler (stage 1)
70 #     * With stage 1:
71 #           o Build libraries/*
72 #           o Build rts
73 #           o Build utils/* (except haddock)
74 #           o Build compiler (stage 2)
75 #     * With stage 2:
76 #           o Build utils/haddock
77 #           o Build compiler (stage 3) (optional)
78 #     * With haddock:
79 #           o libraries/*
80 #           o compiler
81
82 .PHONY: default all haddock
83
84 # We need second expansion for the way we handle directories, so that
85 #     | $$$$(dir $$$$@)/.
86 # expands to the directory of a rule that uses a % pattern.
87 .SECONDEXPANSION:
88
89 default : all
90
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"
95 else
96 $(error Make has restarted itself $(MAKE_RESTARTS) times; is there a makefile bug?)
97 endif
98
99 # Just bring makefiles up to date:
100 .PHONY: just-makefiles
101 just-makefiles:
102         @:
103
104 # -----------------------------------------------------------------------------
105 # Misc GNU make utils
106
107 nothing=
108 space=$(nothing) $(nothing)
109 comma=,
110
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:
115 .SUFFIXES:
116
117 # -----------------------------------------------------------------------------
118 #                       Makefile debugging
119 # to see the effective value used for a Makefile variable, do
120 #  make show VALUE=MY_VALUE
121 #
122
123 show:
124         @echo '$(VALUE)="$($(VALUE))"'
125
126 # -----------------------------------------------------------------------------
127 # Include subsidiary build-system bits
128
129 include mk/tree.mk
130
131 ifeq "$(findstring clean,$(MAKECMDGOALS))" ""
132 include mk/config.mk
133 ifeq "$(ProjectVersion)" ""
134 $(error Please run ./configure first)
135 endif
136 endif
137
138 include mk/ways.mk
139
140 # (Optional) build-specific configuration
141 include mk/custom-settings.mk
142
143 ifeq "$(findstring clean,$(MAKECMDGOALS))" ""
144 ifeq "$(GhcLibWays)" ""
145 $(error $$(GhcLibWays) is empty, it must contain at least one way)
146 endif
147 endif
148
149 # -----------------------------------------------------------------------------
150 # Macros for standard targets
151
152 include rules/all-target.mk
153 include rules/clean-target.mk
154
155 # -----------------------------------------------------------------------------
156 # The inplace tree
157
158 $(eval $(call clean-target,inplace,,inplace))
159
160 # -----------------------------------------------------------------------------
161 # Whether to build dependencies or not
162
163 # When we're just doing 'make clean' or 'make show', then we don't need
164 # to build dependencies.
165
166 ifneq "$(findstring clean,$(MAKECMDGOALS))" ""
167 NO_INCLUDE_DEPS = YES
168 NO_INCLUDE_PKGDATA = YES
169 endif
170 ifneq "$(findstring bootstrapping-files,$(MAKECMDGOALS))" ""
171 NO_INCLUDE_DEPS = YES
172 NO_INCLUDE_PKGDATA = YES
173 endif
174 ifeq "$(findstring show,$(MAKECMDGOALS))" "show"
175 NO_INCLUDE_DEPS = YES
176 # We want package-data.mk for show
177 endif
178
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
186
187 # -----------------------------------------------------------------------------
188 # Ways
189
190 include rules/way-prelims.mk
191
192 $(foreach way,$(ALL_WAYS),\
193   $(eval $(call way-prelims,$(way))))
194
195 # -----------------------------------------------------------------------------
196 # Compilation Flags
197
198 include rules/distdir-way-opts.mk
199
200 # -----------------------------------------------------------------------------
201 # Finding source files and object files
202
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
209
210 # -----------------------------------------------------------------------------
211 # Suffix rules
212
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"
216
217 include rules/hs-suffix-rules-srcdir.mk
218 include rules/hs-suffix-rules.mk
219
220 # -----------------------------------------------------------------------------
221 # Suffix rules for .hi files
222
223 include rules/hi-rule.mk
224
225 $(foreach way,$(ALL_WAYS),\
226   $(eval $(call hi-rule,$(way))))
227
228 #-----------------------------------------------------------------------------
229 # C-related suffix rules
230
231 include rules/c-suffix-rules.mk
232
233 #-----------------------------------------------------------------------------
234 # CMM-related suffix rules
235
236 include rules/cmm-suffix-rules.mk
237
238 endif
239
240 # -----------------------------------------------------------------------------
241 # Building package-data.mk files from .cabal files
242
243 include rules/package-config.mk
244
245 # -----------------------------------------------------------------------------
246 # Building dependencies
247
248 include rules/build-dependencies.mk
249
250 # -----------------------------------------------------------------------------
251 # Build package-data.mk files
252
253 include rules/build-package-data.mk
254
255 # -----------------------------------------------------------------------------
256 # Build and install a program
257
258 include rules/build-prog.mk
259 include rules/shell-wrapper.mk
260
261 # -----------------------------------------------------------------------------
262 # Build a perl script
263
264 include rules/build-perl.mk
265
266 # -----------------------------------------------------------------------------
267 # Build a package
268
269 include rules/build-package.mk
270 include rules/build-package-way.mk
271 include rules/haddock.mk
272 include rules/tags-package.mk
273
274 # -----------------------------------------------------------------------------
275 # Registering hand-written package descriptions (used in libffi and rts)
276
277 include rules/manual-package-config.mk
278
279 # -----------------------------------------------------------------------------
280 # Docs
281
282 include rules/docbook.mk
283
284 # -----------------------------------------------------------------------------
285 # Making bindists
286
287 include rules/bindist.mk
288
289 # -----------------------------------------------------------------------------
290 # Building libraries
291
292 define addPackage # args: $1 = package, $2 = condition
293     ifneq "$2" ""
294         ifeq "$$(CLEANING)" "YES"
295             PACKAGES += $1
296         else
297             ifeq $2
298                 PACKAGES += $1
299             endif
300         endif
301     else
302         PACKAGES += $1
303     endif
304 endef
305
306 $(eval $(call addPackage,ghc-prim))
307 ifeq "$(CLEANING)" "YES"
308 $(eval $(call addPackage,integer-gmp))
309 $(eval $(call addPackage,integer-simple))
310 else
311 $(eval $(call addPackage,$(INTEGER_LIBRARY)))
312 endif
313 $(eval $(call addPackage,base))
314 $(eval $(call addPackage,filepath))
315 $(eval $(call addPackage,array))
316 $(eval $(call addPackage,bytestring))
317 $(eval $(call addPackage,containers))
318
319 $(eval $(call addPackage,Win32,($$(Windows),YES)))
320 $(eval $(call addPackage,unix,($$(Windows),NO)))
321
322 $(eval $(call addPackage,old-locale))
323 $(eval $(call addPackage,old-time))
324 $(eval $(call addPackage,time))
325 $(eval $(call addPackage,directory))
326 $(eval $(call addPackage,process))
327 $(eval $(call addPackage,random))
328 $(eval $(call addPackage,extensible-exceptions))
329 $(eval $(call addPackage,haskell98))
330 $(eval $(call addPackage,haskell2010))
331 $(eval $(call addPackage,hpc))
332 $(eval $(call addPackage,pretty))
333 $(eval $(call addPackage,template-haskell))
334 $(eval $(call addPackage,Cabal))
335 $(eval $(call addPackage,binary))
336 $(eval $(call addPackage,bin-package-db))
337 $(eval $(call addPackage,mtl))
338 $(eval $(call addPackage,utf8-string))
339 $(eval $(call addPackage,xhtml))
340
341 $(eval $(call addPackage,terminfo,($$(Windows),NO)))
342
343 $(eval $(call addPackage,haskeline))
344
345 $(foreach pkg,$(EXTRA_PACKAGES),$(eval $(call addPackage,$(pkg))))
346
347 ifneq "$(BootingFromHc)" "YES"
348 PACKAGES_STAGE2 += \
349         dph/dph-base \
350         dph/dph-prim-interface \
351         dph/dph-prim-seq \
352         dph/dph-prim-par \
353         dph/dph-seq \
354         dph/dph-par
355 endif
356
357 # We assume that the stage0 compiler has a suitable bytestring package,
358 # so we don't have to include it below.
359 BOOT_PKGS = Cabal hpc extensible-exceptions binary bin-package-db
360
361 BOOT_PKG_CONSTRAINTS := $(foreach p,$(BOOT_PKGS),--constraint "$p == $(shell grep -i "^Version:" libraries/$p/$p.cabal | sed "s/[^0-9.]//g")")
362
363 # The actual .a and .so/.dll files: needed for dependencies.
364 ALL_STAGE1_LIBS  = $(foreach lib,$(PACKAGES),$(libraries/$(lib)_dist-install_v_LIB))
365 ifeq "$(BuildSharedLibs)" "YES"
366 ALL_STAGE1_LIBS += $(foreach lib,$(PACKAGES),$(libraries/$(lib)_dist-install_dyn_LIB))
367 endif
368 BOOT_LIBS = $(foreach lib,$(BOOT_PKGS),$(libraries/$(lib)_dist-boot_v_LIB))
369
370 OTHER_LIBS = libffi/dist-install/build/libHSffi$(v_libsuf) libffi/dist-install/build/HSffi.o
371 ifeq "$(BuildSharedLibs)" "YES"
372 OTHER_LIBS  += libffi/dist-install/build/libHSffi$(dyn_libsuf)
373 endif
374
375 # We cannot run ghc-cabal to configure a package until we have
376 # configured and registered all of its dependencies.  So the following
377 # hack forces all the configure steps to happen in exactly the following order:
378 #
379 #  $(PACKAGES) ghc(stage2) $(PACKAGES_STAGE2)
380 #
381 # Ideally we should use the correct dependencies here to allow more
382 # parallelism, but we don't know the dependencies until we've
383 # generated the pacakge-data.mk files.
384 define fixed_pkg_dep
385 libraries/$1/$2/package-data.mk : $$(GHC_PKG_INPLACE) $$(fixed_pkg_prev)
386 fixed_pkg_prev:=libraries/$1/$2/package-data.mk
387 endef
388
389 ifneq "$(BINDIST)" "YES"
390 fixed_pkg_prev=
391 $(foreach pkg,$(PACKAGES),$(eval $(call fixed_pkg_dep,$(pkg),dist-install)))
392
393 # the GHC package doesn't live in libraries/, so we add its dependency manually:
394 compiler/stage2/package-data.mk: $(fixed_pkg_prev)
395 fixed_pkg_prev:=compiler/stage2/package-data.mk
396
397 # and continue with PACKAGES_STAGE2, which depend on GHC:
398 $(foreach pkg,$(PACKAGES_STAGE2),$(eval $(call fixed_pkg_dep,$(pkg),dist-install)))
399
400 ghc/stage1/package-data.mk: compiler/stage1/package-data.mk
401 ghc/stage2/package-data.mk: compiler/stage2/package-data.mk
402 # haddock depends on ghc and some libraries, but depending on GHC's
403 # package-data.mk is sufficient, as that in turn depends on all the
404 # libraries
405 utils/haddock/dist/package-data.mk: compiler/stage2/package-data.mk
406
407 utils/ghc-pkg/dist-install/package-data.mk: compiler/stage2/package-data.mk
408 utils/hsc2hs/dist-install/package-data.mk: compiler/stage2/package-data.mk
409 utils/compare_sizes/dist/package-data.mk: compiler/stage2/package-data.mk
410
411 # add the final two package.conf dependencies: ghc-prim depends on RTS,
412 # and RTS depends on libffi.
413 libraries/ghc-prim/dist-install/package-data.mk : rts/package.conf.inplace
414 rts/package.conf.inplace : libffi/package.conf.inplace
415 endif
416
417 # -----------------------------------------------------------------------------
418 # Directories
419
420 # Don't try to delete directories:
421 .PRECIOUS: %/.
422
423 # Create build directories on demand.  NB. the | below: this indicates
424 # that $(MKDIRHIER) is an order-only dependency, which means that this
425 # rule fires after building mkdirhier, but we won't try to recreate
426 # directories if mkdirhier changes.
427 %/. : | $(MKDIRHIER)
428         "$(MKDIRHIER)" $@
429
430 # -----------------------------------------------------------------------------
431 # Special magic for the ghc-prim package
432
433 # We want the ghc-prim package to include the GHC.Prim module when it
434 # is registered, but not when it is built, because GHC.Prim is not a
435 # real source module, it is built-in to GHC.  The old build system did
436 # this using Setup.hs, but we can't do that here, so we have a flag to
437 # enable GHC.Prim in the .cabal file (so that the ghc-prim package
438 # remains compatible with the old build system for the time being).
439 # GHC.Prim module in the ghc-prim package with a flag:
440 #
441 libraries/ghc-prim_CONFIGURE_OPTS += --flag=include-ghc-prim
442
443 # And then we strip it out again before building the package:
444 define libraries/ghc-prim_PACKAGE_MAGIC
445 libraries/ghc-prim_dist-install_MODULES := $$(filter-out GHC.Prim,$$(libraries/ghc-prim_dist-install_MODULES))
446 endef
447
448 PRIMOPS_TXT = $(GHC_COMPILER_DIR)/prelude/primops.txt
449
450 libraries/ghc-prim/dist-install/build/GHC/PrimopWrappers.hs : $(GENPRIMOP_INPLACE) $(PRIMOPS_TXT) | $$(dir $$@)/.
451         "$(GENPRIMOP_INPLACE)" --make-haskell-wrappers <$(PRIMOPS_TXT) >$@
452
453 # Required so that Haddock documents the primops.
454 libraries/ghc-prim_dist-install_EXTRA_HADDOCK_SRCS = libraries/ghc-prim/dist-install/build/autogen/GHC/Prim.hs
455
456 # -----------------------------------------------------------------------------
457 # Include build instructions from all subdirs
458
459 # For the rationale behind the build phases, see
460 #   http://hackage.haskell.org/trac/ghc/wiki/Building/Architecture/Idiom/PhaseOrdering
461
462 # Setting foo_dist_DISABLE=YES means "in directory foo, for build
463 # "dist", just read the package-data.mk file, do not build anything".
464
465 # We carefully engineer things so that we can build the
466 # package-data.mk files early on: they depend only on a few tools also
467 # built early.  Having got the package-data.mk files built, we can
468 # restart make with up-to-date information about all the packages
469 # (this is phase 0).  The remaining problem is the .depend files:
470 #
471 #   - .depend files in libraries need the stage 1 compiler to build
472 #   - ghc/stage1/.depend needs compiler/stage1 built
473 #   - compiler/stage1/.depend needs the bootstrap libs built
474 #
475 # GHC 6.11+ can build a .depend file without having built the
476 # dependencies of the package, but we can't rely on the bootstrapping
477 # compiler being able to do this, which is why we have to separate the
478 # three phases above.
479
480 # So this is the final ordering:
481
482 # Phase 0 : all package-data.mk files
483 #           (requires ghc-cabal, ghc-pkg, mkdirhier, dummy-ghc etc.)
484 # Phase 1 : .depend files for bootstrap libs
485 #           (requires hsc2hs)
486 # Phase 2 : compiler/stage1/.depend
487 #           (requires bootstrap libs and genprimopcode)
488 # Phase 3 : ghc/stage1/.depend
489 #           (requires compiler/stage1)
490 #
491 # The rest : libraries/*/dist-install, compiler/stage2, ghc/stage2
492
493 BUILD_DIRS =
494
495 ifneq "$(BINDIST)" "YES"
496 BUILD_DIRS += \
497    $(GHC_MKDIRHIER_DIR)
498 endif
499
500 BUILD_DIRS += \
501    docs/users_guide \
502    docs/ext-core \
503    docs/man \
504    libraries/Cabal/doc \
505    $(GHC_UNLIT_DIR) \
506    $(GHC_HP2PS_DIR)
507
508 ifneq "$(GhcUnregisterised)" "YES"
509 BUILD_DIRS += \
510    $(GHC_MANGLER_DIR) \
511    $(GHC_SPLIT_DIR)
512 endif
513
514 ifneq "$(BINDIST)" "YES"
515 BUILD_DIRS += \
516    $(GHC_GENPRIMOP_DIR)
517 endif
518
519 BUILD_DIRS += \
520    driver \
521    driver/ghci \
522    driver/ghc \
523    libffi \
524    includes \
525    rts
526
527 ifneq "$(BINDIST)" "YES"
528 BUILD_DIRS += \
529    bindisttest \
530    $(GHC_CABAL_DIR) \
531    $(GHC_GENAPPLY_DIR)
532 endif
533
534 BUILD_DIRS += \
535    utils/haddock \
536    utils/haddock/doc
537
538 ifneq "$(CLEANING)" "YES"
539 BUILD_DIRS += \
540    $(patsubst %, libraries/%, $(PACKAGES))
541 endif
542
543 ifneq "$(BootingFromHc)" "YES"
544 BUILD_DIRS += \
545    libraries/dph
546 endif
547
548 ifeq "$(INTEGER_LIBRARY)" "integer-gmp"
549 BUILD_DIRS += libraries/integer-gmp/gmp
550 endif
551
552 BUILD_DIRS += \
553    compiler \
554    $(GHC_HSC2HS_DIR) \
555    $(GHC_PKG_DIR) \
556    utils/testremove \
557    utils/ghctags \
558    utils/hpc \
559    utils/runghc \
560    ghc
561 ifeq "$(Windows)" "YES"
562 BUILD_DIRS += \
563    $(GHC_TOUCHY_DIR)
564 endif
565
566 BUILD_DIRS += utils/count_lines
567 BUILD_DIRS += utils/compare_sizes
568
569 ifneq "$(CLEANING)" "YES"
570 # After compiler/, because these packages depend on it
571 BUILD_DIRS += \
572    $(patsubst %, libraries/%, $(PACKAGES_STAGE2))
573 endif
574
575 # XXX libraries/% must come before any programs built with stage1, see
576 # Note [lib-depends].
577
578 ifeq "$(phase)" "0"
579 $(foreach lib,$(BOOT_PKGS),$(eval \
580   libraries/$(lib)_dist-boot_DISABLE = YES))
581 endif
582
583 ifneq "$(findstring $(phase),0 1)" ""
584 # We can build deps for compiler/stage1 in phase 2
585 compiler_stage1_DISABLE = YES
586 endif
587
588 ifneq "$(findstring $(phase),0 1 2)" ""
589 ghc_stage1_DISABLE = YES
590 endif
591
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/ghctags_dist_DISABLE = YES
597 utils/hpc_dist_DISABLE = YES
598 utils/hsc2hs_dist-install_DISABLE = YES
599 utils/ghc-pkg_dist-install_DISABLE = YES
600 utils/compare_sizes_dist_DISABLE = YES
601 compiler_stage2_DISABLE = YES
602 compiler_stage3_DISABLE = YES
603 ghc_stage2_DISABLE = YES
604 ghc_stage3_DISABLE = YES
605 $(foreach lib,$(PACKAGES) $(PACKAGES_STAGE2),$(eval \
606   libraries/$(lib)_dist-install_DISABLE = YES))
607 endif
608
609 ifneq "$(CLEANING)" "YES"
610 ifeq "$(INTEGER_LIBRARY)" "integer-gmp"
611 libraries/base_dist-install_CONFIGURE_OPTS += --flags=-integer-simple
612 else
613     ifeq "$(INTEGER_LIBRARY)" "integer-simple"
614         libraries/base_dist-install_CONFIGURE_OPTS += --flags=integer-simple
615     else
616 $(error Unknown integer library: $(INTEGER_LIBRARY))
617     endif
618 endif
619 endif
620
621 # These packages don't pass the Cabal checks because hs-source-dirs
622 # points outside the source directory. This isn't a real problem in
623 # these cases, so we just skip checking them.
624 CHECKED_libraries/dph/dph-seq = YES
625 CHECKED_libraries/dph/dph-par = YES
626 # In compiler's case, include-dirs points outside of the source tree
627 CHECKED_compiler = YES
628
629 include $(patsubst %, %/ghc.mk, $(BUILD_DIRS))
630
631 # We need -fno-warn-deprecated-flags to avoid failure with -Werror
632 GhcLibHcOpts += -fno-warn-deprecated-flags
633 GhcBootLibHcOpts += -fno-warn-deprecated-flags
634
635 # ----------------------------------------------
636 # Per-package compiler flags
637
638 # If you want to add per-package compiler flags, this 
639 # is the place to do it.  Do it like this for package <pkg>
640 #   
641 #   libraries/<pkg>_dist-boot_HC_OPTS += -Wwarn
642 #   libraries/<pkg>_dist-install_HC_OPTS += -Wwarn
643
644
645 # Add $(GhcLibHcOpts) to all library builds
646 $(foreach pkg,$(PACKAGES) $(PACKAGES_STAGE2),$(eval libraries/$(pkg)_dist-install_HC_OPTS += $$(GhcLibHcOpts)))
647
648 # ----------------------------------------------
649 # A useful pseudo-target
650 .PHONY: stage1_libs
651 stage1_libs : $(ALL_STAGE1_LIBS)
652
653 ifeq "$(HADDOCK_DOCS)" "YES"
654 libraries/index.html: $(ALL_HADDOCK_FILES)
655         cd libraries && sh gen_contents_index --inplace
656 $(eval $(call all-target,library_doc_index,libraries/index.html))
657 INSTALL_LIBRARY_DOCS += libraries/*.html libraries/*.gif libraries/*.css libraries/*.js
658 CLEAN_FILES += libraries/doc-index* libraries/haddock*.css \
659                libraries/haddock*.js libraries/index*.html libraries/*.gif
660 endif
661
662 ifeq "$(CHECK_PACKAGES)" "YES"
663 all: check_packages
664 endif
665
666 # -----------------------------------------------------------------------------
667 # Bootstrapping libraries
668
669 # We need to build a few libraries with the installed GHC, since GHC itself
670 # and some of the tools depend on them:
671
672 ifneq "$(BINDIST)" "YES"
673
674 ifneq "$(BOOTSTRAPPING_CONF)" ""
675 ifeq "$(wildcard $(BOOTSTRAPPING_CONF))" ""
676 $(shell echo "[]" >$(BOOTSTRAPPING_CONF))
677 endif
678 endif
679
680 $(eval $(call clean-target,$(BOOTSTRAPPING_CONF),,$(BOOTSTRAPPING_CONF)))
681
682 # These three libraries do not depend on each other, so we can build
683 # them straight off:
684
685 $(eval $(call build-package,libraries/hpc,dist-boot,0))
686 $(eval $(call build-package,libraries/extensible-exceptions,dist-boot,0))
687 $(eval $(call build-package,libraries/Cabal,dist-boot,0))
688 $(eval $(call build-package,libraries/binary,dist-boot,0))
689 $(eval $(call build-package,libraries/bin-package-db,dist-boot,0))
690
691 # register the boot packages in strict sequence, because running
692 # multiple ghc-pkgs in parallel doesn't work (registrations may get
693 # lost).
694 fixed_pkg_prev=
695 $(foreach pkg,$(BOOT_PKGS),$(eval $(call fixed_pkg_dep,$(pkg),dist-boot)))
696
697 compiler/stage1/package-data.mk : \
698     libraries/Cabal/dist-boot/package-data.mk \
699     libraries/hpc/dist-boot/package-data.mk \
700     libraries/extensible-exceptions/dist-boot/package-data.mk \
701     libraries/bin-package-db/dist-boot/package-data.mk
702
703 # These are necessary because the bootstrapping compiler may not know
704 # about cross-package dependencies:
705 $(compiler_stage1_depfile_haskell) : $(BOOT_LIBS)
706 $(ghc_stage1_depfile_haskell) : $(compiler_stage1_v_LIB)
707
708 # A few careful dependencies between bootstrapping packages.  When we
709 # can rely on the stage 0 compiler being able to generate
710 # cross-package dependencies with -M (fixed in GHC 6.12.1) we can drop
711 # these, and also some of the phases.
712 #
713 # If you miss any out here, then 'make -j8' will probably tell you.
714 #
715 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)
716
717 $(foreach pkg,$(BOOT_PKGS),$(eval libraries/$(pkg)_dist-boot_HC_OPTS += $$(GhcBootLibHcOpts)))
718
719 # Make sure we have all the GHCi libs by the time we've built
720 # ghc-stage2.  DPH includes a bit of Template Haskell which needs the
721 # GHCI libs, and we don't have a better way to express that dependency.
722 #
723 GHCI_LIBS = $(foreach lib,$(PACKAGES),$(libraries/$(lib)_dist-install_GHCI_LIB)) \
724             $(compiler_stage2_GHCI_LIB)
725
726 ghc/stage2/build/tmp/$(ghc_stage2_PROG) : $(GHCI_LIBS)
727
728 endif
729
730 # -----------------------------------------------------------------------------
731 # Creating a local mingw copy on Windows
732
733 ifeq "$(Windows)" "YES"
734
735 install : install_mingw
736 .PHONY: install_mingw
737 install_mingw : $(INPLACE_MINGW)
738         "$(CP)" -Rp $(INPLACE_MINGW) $(prefix)
739
740 install : install_perl
741 .PHONY: install_perl
742 install_perl : $(INPLACE_PERL)
743         "$(CP)" -Rp $(INPLACE_PERL) $(prefix)
744
745 endif # Windows
746
747 ifneq "$(BINDIST)" "YES"
748 $(ghc-prim-$(libraries/ghc-prim_dist-install_VERSION)_HADDOCK_FILE): \
749     libraries/ghc-prim/dist-install/build/autogen/GHC/Prim.hs \
750     libraries/ghc-prim/dist-install/build/autogen/GHC/PrimopWrappers.hs
751 endif # BINDIST
752
753 libraries/ghc-prim/dist-install/build/autogen/GHC/Prim.hs: \
754                             $(PRIMOPS_TXT) $(GENPRIMOP_INPLACE) \
755                           | $$(dir $$@)/.
756         "$(GENPRIMOP_INPLACE)" --make-haskell-source < $< > $@
757
758 libraries/ghc-prim/dist-install/build/autogen/GHC/PrimopWrappers.hs: \
759                             $(PRIMOPS_TXT) $(GENPRIMOP_INPLACE) \
760                           | $$(dir $$@)/.
761         "$(GENPRIMOP_INPLACE)" --make-haskell-wrappers < $< > $@
762
763 .PHONY: tags
764 tags: tags_compiler
765
766 .PHONY: TAGS
767 TAGS: TAGS_compiler
768
769 # -----------------------------------------------------------------------------
770 # Installation
771
772 install: install_packages install_libs install_libexecs install_headers \
773          install_libexec_scripts install_bins install_docs \
774                  install_topdirs
775
776 install_bins: $(INSTALL_BINS)
777         $(INSTALL_DIR) "$(DESTDIR)$(bindir)"
778         for i in $(INSTALL_BINS); do \
779                 $(INSTALL_PROGRAM) $(INSTALL_BIN_OPTS) $$i "$(DESTDIR)$(bindir)" ;  \
780         done
781
782 install_libs: $(INSTALL_LIBS)
783         $(INSTALL_DIR) "$(DESTDIR)$(ghclibdir)"
784         for i in $(INSTALL_LIBS); do \
785                 case $$i in \
786                   *.a) \
787                     $(INSTALL_DATA) $(INSTALL_OPTS) $$i "$(DESTDIR)$(ghclibdir)"; \
788                     $(RANLIB) $(DESTDIR)$(ghclibdir)/`basename $$i` ;; \
789                   *.dll) \
790                     $(INSTALL_DATA) -s $(INSTALL_OPTS) $$i "$(DESTDIR)$(ghclibdir)" ;; \
791                   *.so) \
792                     $(INSTALL_SHLIB) $(INSTALL_OPTS) $$i "$(DESTDIR)$(ghclibdir)" ;; \
793                   *.dylib) \
794                     $(INSTALL_SHLIB) $(INSTALL_OPTS) $$i "$(DESTDIR)$(ghclibdir)";; \
795                   *) \
796                     $(INSTALL_DATA) $(INSTALL_OPTS) $$i "$(DESTDIR)$(ghclibdir)"; \
797                 esac; \
798         done
799
800 install_libexec_scripts: $(INSTALL_LIBEXEC_SCRIPTS)
801 ifeq "$(INSTALL_LIBEXEC_SCRIPTS)" ""
802         @:
803 else
804         $(INSTALL_DIR) "$(DESTDIR)$(ghclibexecdir)"
805         for i in $(INSTALL_LIBEXEC_SCRIPTS); do \
806                 $(INSTALL_SCRIPT) $(INSTALL_OPTS) $$i "$(DESTDIR)$(ghclibexecdir)"; \
807         done
808 endif
809
810 install_libexecs:  $(INSTALL_LIBEXECS)
811 ifeq "$(INSTALL_LIBEXECS)" ""
812         @:
813 else
814         $(INSTALL_DIR) "$(DESTDIR)$(ghclibexecdir)"
815         for i in $(INSTALL_LIBEXECS); do \
816                 $(INSTALL_PROGRAM) $(INSTALL_BIN_OPTS) $$i "$(DESTDIR)$(ghclibexecdir)"; \
817         done
818 # We rename ghc-stage2, so that the right program name is used in error
819 # messages etc.
820         "$(MV)" "$(DESTDIR)$(ghclibexecdir)/ghc-stage2" "$(DESTDIR)$(ghclibexecdir)/ghc"
821 endif
822
823 install_topdirs: $(INSTALL_TOPDIRS)
824         $(INSTALL_DIR) "$(DESTDIR)$(topdir)"
825         for i in $(INSTALL_TOPDIRS); do \
826                 $(INSTALL_PROGRAM) $(INSTALL_BIN_OPTS) $$i "$(DESTDIR)$(topdir)"; \
827         done
828
829 install_headers: $(INSTALL_HEADERS)
830         $(INSTALL_DIR) "$(DESTDIR)$(ghcheaderdir)"
831         for i in $(INSTALL_HEADERS); do \
832                 $(INSTALL_HEADER) $(INSTALL_OPTS) $$i "$(DESTDIR)$(ghcheaderdir)"; \
833         done
834
835 install_docs: $(INSTALL_DOCS)
836         $(INSTALL_DIR) "$(DESTDIR)$(docdir)"
837 ifneq "$(INSTALL_DOCS)" ""
838         for i in $(INSTALL_DOCS); do \
839                 $(INSTALL_DOC) $(INSTALL_OPTS) $$i "$(DESTDIR)$(docdir)"; \
840         done
841 endif
842         $(INSTALL_DIR) $(INSTALL_OPTS) "$(DESTDIR)$(docdir)/html"
843         $(INSTALL_DOC) $(INSTALL_OPTS) docs/index.html "$(DESTDIR)$(docdir)/html"
844 ifneq "$(INSTALL_LIBRARY_DOCS)" ""
845         $(INSTALL_DIR) $(INSTALL_OPTS) "$(DESTDIR)$(docdir)/html/libraries"
846         for i in $(INSTALL_LIBRARY_DOCS); do \
847                 $(INSTALL_DOC) $(INSTALL_OPTS) $$i "$(DESTDIR)$(docdir)/html/libraries/"; \
848         done
849         $(INSTALL_DATA) $(INSTALL_OPTS) libraries/prologue.txt "$(DESTDIR)$(docdir)/html/libraries/"
850         $(INSTALL_SCRIPT) $(INSTALL_OPTS) libraries/gen_contents_index "$(DESTDIR)$(docdir)/html/libraries/"
851 endif
852 ifneq "$(INSTALL_HTML_DOC_DIRS)" ""
853         for i in $(INSTALL_HTML_DOC_DIRS); do \
854                 $(INSTALL_DIR) $(INSTALL_OPTS) "$(DESTDIR)$(docdir)/html/`basename $$i`"; \
855                 $(INSTALL_DOC) $(INSTALL_OPTS) $$i/* "$(DESTDIR)$(docdir)/html/`basename $$i`"; \
856         done
857 endif
858
859 INSTALLED_PACKAGE_CONF=$(DESTDIR)$(topdir)/package.conf.d
860
861 # Install packages in the right order, so that ghc-pkg doesn't complain.
862 # Also, install ghc-pkg first.
863 ifeq "$(Windows)" "NO"
864 INSTALLED_GHC_REAL=$(DESTDIR)$(ghclibexecdir)/ghc
865 INSTALLED_GHC_PKG_REAL=$(DESTDIR)$(ghclibexecdir)/ghc-pkg
866 else
867 INSTALLED_GHC_REAL=$(DESTDIR)$(bindir)/ghc.exe
868 INSTALLED_GHC_PKG_REAL=$(DESTDIR)$(bindir)/ghc-pkg.exe
869 endif
870
871 INSTALLED_PACKAGES := $(filter-out haskeline mtl terminfo utf8-string xhtml,$(PACKAGES))
872 ifeq "$(InstallExtraPackages)" "NO"
873 INSTALLED_PACKAGES := $(filter-out $(EXTRA_PACKAGES), $(INSTALLED_PACKAGES))
874 endif
875
876 HIDDEN_PACKAGES = binary
877
878 define set_INSTALL_DISTDIR
879 # $1 = libraries/base, $2 = dist-install
880 # =>
881 # INSTALL_DISTDIR_libraries/base = dist-install
882 INSTALL_DISTDIR_$1 = $2
883 endef
884
885 $(eval $(foreach p,$(INSTALLED_PACKAGES) $(PACKAGES_STAGE2),\
886 $(call set_INSTALL_DISTDIR,libraries/$p,dist-install)))
887 INSTALL_DISTDIR_compiler = stage2
888
889 ALL_INSTALLED_PACKAGES = $(addprefix libraries/,$(INSTALLED_PACKAGES)) \
890                          compiler \
891                          $(addprefix libraries/,$(PACKAGES_STAGE2))
892
893 install_packages: install_libexecs
894 install_packages: libffi/package.conf.install rts/package.conf.install
895         $(INSTALL_DIR) "$(DESTDIR)$(topdir)"
896         "$(RM)" $(RM_OPTS_REC) "$(INSTALLED_PACKAGE_CONF)"
897         $(INSTALL_DIR) "$(INSTALLED_PACKAGE_CONF)"
898         "$(INSTALLED_GHC_PKG_REAL)" --force --global-conf "$(INSTALLED_PACKAGE_CONF)" update libffi/package.conf.install
899         "$(INSTALLED_GHC_PKG_REAL)" --force --global-conf "$(INSTALLED_PACKAGE_CONF)" update rts/package.conf.install
900         $(foreach p, $(ALL_INSTALLED_PACKAGES),\
901             "$(GHC_CABAL_INPLACE)" install \
902                  "$(INSTALLED_GHC_REAL)" \
903                  "$(INSTALLED_GHC_PKG_REAL)" \
904                  "$(STRIP_CMD)" \
905                  "$(DESTDIR)$(topdir)" \
906                  $p $(INSTALL_DISTDIR_$p) \
907                  '$(DESTDIR)' '$(prefix)' '$(ghclibdir)' '$(docdir)/html/libraries' \
908                  $(RelocatableBuild) &&) true
909         $(foreach p, $(HIDDEN_PACKAGES),\
910             "$(INSTALLED_GHC_PKG_REAL)" --global-conf "$(INSTALLED_PACKAGE_CONF)" \
911                                       hide $p &&) true
912
913 # -----------------------------------------------------------------------------
914 # Binary distributions
915
916 ifneq "$(CLEANING)" "YES"
917 # This rule seems to hold some files open on Windows which prevents
918 # cleaning, perhaps due to the $(wildcard).
919
920 $(eval $(call bindist,.,\
921     LICENSE \
922     README \
923     INSTALL \
924     configure config.sub config.guess install-sh \
925     extra-gcc-opts.in \
926     Makefile \
927     mk/config.mk.in \
928     $(INPLACE_BIN)/mkdirhier \
929     $(INPLACE_BIN)/ghc-cabal \
930     utils/ghc-pwd/ghc-pwd \
931         $(BINDIST_WRAPPERS) \
932         $(BINDIST_PERL_SOURCES) \
933         $(BINDIST_LIBS) \
934         $(BINDIST_HI) \
935         $(BINDIST_EXTRAS) \
936         $(includes_H_CONFIG) \
937         $(includes_H_PLATFORM) \
938     $(includes_H_FILES) \
939         includes/ghcconfig.h \
940         includes/rts/Config.h \
941     $(INSTALL_HEADERS) \
942     $(INSTALL_LIBEXECS) \
943     $(INSTALL_LIBEXEC_SCRIPTS) \
944     $(INSTALL_TOPDIRS) \
945     $(INSTALL_BINS) \
946     $(INSTALL_MANPAGES) \
947     $(INSTALL_DOCS) \
948     $(INSTALL_LIBRARY_DOCS) \
949     $(addsuffix /*,$(INSTALL_HTML_DOC_DIRS)) \
950         docs/index.html \
951         compiler/stage2/doc \
952         $(wildcard libraries/*/dist-install/doc/) \
953         $(wildcard libraries/*/*/dist-install/doc/) \
954     $(filter-out extra-gcc-opts,$(INSTALL_LIBS)) \
955     $(filter-out %/project.mk mk/config.mk %/mk/install.mk,$(MAKEFILE_LIST)) \
956         mk/project.mk \
957         mk/install.mk.in \
958         bindist.mk \
959         libraries/gen_contents_index \
960         libraries/prologue.txt \
961         libraries/dph/LICENSE \
962  ))
963 endif
964 # mk/project.mk gets an absolute path, so we manually include it in
965 # the bindist with a relative path
966
967 BIN_DIST_MK = $(BIN_DIST_PREP_DIR)/bindist.mk
968
969 unix-binary-dist-prep:
970         "$(RM)" $(RM_OPTS_REC) bindistprep/
971         "$(MKDIRHIER)" $(BIN_DIST_PREP_DIR)
972         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 distrib/configure.ac distrib/README distrib/INSTALL; do ln -s ../../$$i $(BIN_DIST_PREP_DIR)/; done
973         echo "HADDOCK_DOCS       = $(HADDOCK_DOCS)"       >> $(BIN_DIST_MK)
974         echo "LATEX_DOCS         = $(LATEX_DOCS)"         >> $(BIN_DIST_MK)
975         echo "BUILD_DOCBOOK_HTML = $(BUILD_DOCBOOK_HTML)" >> $(BIN_DIST_MK)
976         echo "BUILD_DOCBOOK_PS   = $(BUILD_DOCBOOK_PS)"   >> $(BIN_DIST_MK)
977         echo "BUILD_DOCBOOK_PDF  = $(BUILD_DOCBOOK_PDF)"  >> $(BIN_DIST_MK)
978         echo "BUILD_MAN          = $(BUILD_MAN)"          >> $(BIN_DIST_MK)
979         cd $(BIN_DIST_PREP_DIR) && autoreconf
980         "$(RM)" $(RM_OPTS) $(BIN_DIST_PREP_TAR)
981 # h means "follow symlinks", e.g. if aclocal.m4 is a symlink to a source
982 # tree then we want to include the real file, not a symlink to it
983         cd bindistprep && "$(TAR_CMD)" hcf - -T ../$(BIN_DIST_LIST) | bzip2 -c > ../$(BIN_DIST_PREP_TAR_BZ2)
984
985 windows-binary-dist-prep:
986         "$(RM)" $(RM_OPTS_REC) bindistprep/
987         $(MAKE) prefix=$(TOP)/$(BIN_DIST_PREP_DIR) install
988         cd bindistprep && "$(TAR_CMD)" cf - $(BIN_DIST_NAME) | bzip2 -c > ../$(BIN_DIST_PREP_TAR_BZ2)
989
990 windows-installer:
991 ifeq "$(ISCC_CMD)" ""
992         @echo No ISCC_CMD, so not making installer
993 else
994         "$(ISCC_CMD)" /O. /Fbindistprep/$(WINDOWS_INSTALLER_BASE) - < distrib/ghc.iss
995 endif
996
997 # tryTimes tries to run its third argument multiple times, until it
998 # succeeds. Don't call it directly; call try10Times instead.
999 # The first and second argument to tryTimes are lists of values.
1000 # The length of the first argument is the number of times we have
1001 # already tried. The length of the second argument is the number more
1002 # times we will try.
1003 tryTimes = $(if $2, \
1004                 { echo 'Try $(words x $1): $3' ; $3 ; } || \
1005                 $(call tryTimes,x $1,$(wordlist 2,$(words $2),$2),$3), \
1006                 )
1007
1008 # Try to run the argument 10 times. If all 10 fail, fail.
1009 try10Times = $(call tryTimes,,x x x x x x x x x x,$1) { echo Failed; false; }
1010
1011 .PHONY: publish-binary-dist
1012 publish-binary-dist:
1013         $(call try10Times,$(PublishCp) $(BIN_DIST_TAR_BZ2) $(PublishLocation)/dist)
1014 ifeq "$(mingw32_TARGET_OS)" "1"
1015         $(call try10Times,$(PublishCp) $(WINDOWS_INSTALLER) $(PublishLocation)/dist)
1016 endif
1017
1018 .PHONY: publish-docs
1019 publish-docs:
1020         $(call try10Times,$(PublishCp) -r bindisttest/installed/share/doc/ghc/* $(PublishLocation)/docs)
1021
1022 # -----------------------------------------------------------------------------
1023 # Source distributions
1024
1025 # Do it like this:
1026 #
1027 #       $ make
1028 #       $ make sdist
1029 #
1030
1031 # A source dist is built from a complete build tree, because we
1032 # require some extra files not contained in a darcs checkout: the
1033 # output from Happy and Alex, for example.
1034 #
1035 # The steps performed by 'make dist' are as follows:
1036 #   - create a complete link-tree of the current build tree in /tmp
1037 #   - run 'make distclean' on that tree
1038 #   - remove a bunch of other files that we know shouldn't be in the dist
1039 #   - tar up first the extralibs package, then the main source package
1040
1041 #
1042 # Directory in which we're going to build the src dist
1043 #
1044 SRC_DIST_NAME=ghc-$(ProjectVersion)
1045 SRC_DIST_DIR=$(shell pwd)/$(SRC_DIST_NAME)
1046
1047 #
1048 # Files to include in source distributions
1049 #
1050 SRC_DIST_DIRS = mk rules docs distrib bindisttest libffi includes utils docs rts compiler ghc driver libraries ghc-tarballs
1051 SRC_DIST_FILES += \
1052         configure.ac config.guess config.sub configure \
1053         aclocal.m4 README ANNOUNCE HACKING LICENSE Makefile install-sh \
1054         ghc.spec.in ghc.spec extra-gcc-opts.in VERSION \
1055         boot boot-pkgs packages ghc.mk
1056
1057 SRC_DIST_TARBALL = $(SRC_DIST_NAME)-src.tar.bz2
1058
1059 VERSION :
1060         echo $(ProjectVersion) >VERSION
1061
1062 sdist : VERSION
1063
1064 # Use:
1065 #     $(call sdist_file,compiler,stage2,cmm,Foo/Bar,CmmLex,x)
1066 # to copy the generated file that replaces compiler/cmm/Foo/Bar/CmmLex.x, where
1067 # "stage2" is the dist dir.
1068 define sdist_file
1069         "$(CP)" $1/$2/build/$4/$5.hs $(SRC_DIST_DIR)/$1/$3/$4
1070         mv $(SRC_DIST_DIR)/$1/$3/$4/$5.$6 $(SRC_DIST_DIR)/$1/$3/$4/$5.$6.source
1071 endef
1072
1073 .PHONY: sdist-prep
1074 sdist-prep :
1075         "$(RM)" $(RM_OPTS_REC) $(SRC_DIST_DIR)
1076         "$(RM)" $(RM_OPTS) $(SRC_DIST_TARBALL)
1077         mkdir $(SRC_DIST_DIR)
1078         cd $(SRC_DIST_DIR) && for i in $(SRC_DIST_DIRS); do mkdir $$i; ( cd $$i && lndir $(TOP)/$$i ); done
1079         cd $(SRC_DIST_DIR) && for i in $(SRC_DIST_FILES); do $(LN_S) $(TOP)/$$i .; done
1080         cd $(SRC_DIST_DIR) && $(MAKE) distclean
1081         rm -rf $(SRC_DIST_DIR)/libraries/tarballs/
1082         rm -rf $(SRC_DIST_DIR)/libraries/stamp/
1083         $(call sdist_file,compiler,stage2,cmm,,CmmLex,x)
1084         $(call sdist_file,compiler,stage2,cmm,,CmmParse,y)
1085         $(call sdist_file,compiler,stage2,parser,,Lexer,x)
1086         $(call sdist_file,compiler,stage2,parser,,Parser,y.pp)
1087         $(call sdist_file,compiler,stage2,parser,,ParserCore,y)
1088         $(call sdist_file,utils/hpc,dist,,,HpcParser,y)
1089         $(call sdist_file,utils/genprimopcode,dist,,,Lexer,x)
1090         $(call sdist_file,utils/genprimopcode,dist,,,Parser,y)
1091         $(call sdist_file,utils/haddock,dist,src,Haddock,Lex,x)
1092         $(call sdist_file,utils/haddock,dist,src,Haddock,Parse,y)
1093         cd $(SRC_DIST_DIR) && "$(RM)" $(RM_OPTS_REC) compiler/stage[123] mk/build.mk
1094         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_REC)
1095
1096 .PHONY: sdist
1097 sdist : sdist-prep
1098         "$(TAR_CMD)" chf - $(SRC_DIST_NAME) 2>$src_log | bzip2 >$(TOP)/$(SRC_DIST_TARBALL)
1099
1100 sdist-manifest : $(SRC_DIST_TARBALL)
1101         tar tjf $(SRC_DIST_TARBALL) | sed "s|^ghc-$(ProjectVersion)/||" | sort >sdist-manifest
1102
1103 # Upload the distribution(s)
1104 # Retrying is to work around buggy firewalls that corrupt large file transfers
1105 # over SSH.
1106 ifneq "$(PublishLocation)" ""
1107 publish-sdist :
1108         $(call try10Times,$(PublishCp) $(SRC_DIST_TARBALL) $(PublishLocation)/dist)
1109 endif
1110
1111 ifeq "$(BootingFromHc)" "YES"
1112 # In a normal build we use GHC to compile C files (see
1113 # rules/c-suffix-rules.mk), which passes a number of its own options
1114 # to the C compiler.  So when bootstrapping we have to provide these
1115 # flags explicitly to C compilations.
1116 SRC_CC_OPTS += -DNO_REGS -DUSE_MINIINTERPRETER
1117 SRC_CC_OPTS += -D__GLASGOW_HASKELL__=$(ProjectVersionInt)
1118 SRC_CC_OPTS += -I$(GHC_INCLUDE_DIR)
1119 endif
1120
1121 # -----------------------------------------------------------------------------
1122 # sdisting libraries
1123
1124 # Use manually, with e.g.:
1125 #     make sdist_directory
1126
1127 sdist_%:
1128         inplace/bin/ghc-cabal sdist libraries/$* dist-install
1129
1130 # -----------------------------------------------------------------------------
1131 # Cleaning
1132
1133 .PHONY: clean
1134
1135 CLEAN_FILES += utils/ghc-pwd/ghc-pwd
1136 CLEAN_FILES += utils/ghc-pwd/ghc-pwd.exe
1137 CLEAN_FILES += utils/ghc-pwd/ghc-pwd.hi
1138 CLEAN_FILES += utils/ghc-pwd/ghc-pwd.o
1139 CLEAN_FILES += libraries/bootstrapping.conf
1140 CLEAN_FILES += libraries/integer-gmp/cbits/GmpDerivedConstants.h
1141 CLEAN_FILES += libraries/integer-gmp/cbits/mkGmpDerivedConstants
1142
1143 clean : clean_files clean_libraries
1144
1145 .PHONY: clean_files
1146 clean_files :
1147         "$(RM)" $(RM_OPTS) $(CLEAN_FILES)
1148
1149 ifneq "$(NO_CLEAN_GMP)" "YES"
1150 CLEAN_FILES += libraries/integer-gmp/gmp/gmp.h
1151 CLEAN_FILES += libraries/integer-gmp/gmp/libgmp.a
1152
1153 clean : clean_gmp
1154 .PHONY: clean_gmp
1155 clean_gmp:
1156         "$(RM)" $(RM_OPTS_REC) libraries/integer-gmp/gmp/objs
1157         "$(RM)" $(RM_OPTS_REC) libraries/integer-gmp/gmp/gmpbuild
1158 endif
1159
1160 .PHONY: clean_libraries
1161 clean_libraries: $(patsubst %,clean_libraries/%_dist-install,$(PACKAGES) $(PACKAGES_STAGE2))
1162 clean_libraries: $(patsubst %,clean_libraries/%_dist-boot,$(BOOT_PKGS))
1163
1164 clean_libraries:
1165         "$(RM)" $(RM_OPTS_REC) $(patsubst %, libraries/%/dist, $(PACKAGES) $(PACKAGES_STAGE2))
1166         "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/*.buildinfo, $(PACKAGES) $(PACKAGES_STAGE2))
1167
1168 # We have to define a clean target for each library manually, because the
1169 # libraries/*/ghc.mk files are not included when we're cleaning.
1170 ifeq "$(CLEANING)" "YES"
1171 $(foreach lib,$(PACKAGES) $(PACKAGES_STAGE2),\
1172   $(eval $(call clean-target,libraries/$(lib),dist-install,libraries/$(lib)/dist-install)))
1173 endif
1174
1175 clean : clean_bindistprep
1176 .PHONY: clean_bindistprep
1177 clean_bindistprep:
1178         "$(RM)" $(RM_OPTS_REC) bindistprep/
1179
1180 distclean : clean
1181         "$(RM)" $(RM_OPTS) config.cache config.status config.log mk/config.h mk/stamp-h
1182         "$(RM)" $(RM_OPTS) mk/config.mk mk/are-validating.mk mk/project.mk
1183         "$(RM)" $(RM_OPTS) mk/config.mk.old mk/project.mk.old
1184         "$(RM)" $(RM_OPTS) extra-gcc-opts docs/users_guide/ug-book.xml
1185         "$(RM)" $(RM_OPTS) compiler/ghc.cabal compiler/ghc.cabal.old
1186         "$(RM)" $(RM_OPTS) ghc/ghc-bin.cabal
1187         "$(RM)" $(RM_OPTS) libraries/base/include/HsBaseConfig.h
1188         "$(RM)" $(RM_OPTS) libraries/directory/include/HsDirectoryConfig.h
1189         "$(RM)" $(RM_OPTS) libraries/process/include/HsProcessConfig.h
1190         "$(RM)" $(RM_OPTS) libraries/unix/include/HsUnixConfig.h
1191         "$(RM)" $(RM_OPTS) libraries/old-time/include/HsTimeConfig.h
1192
1193         "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/config.log, $(PACKAGES) $(PACKAGES_STAGE2))
1194         "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/config.status, $(PACKAGES) $(PACKAGES_STAGE2))
1195         "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/include/Hs*Config.h, $(PACKAGES) $(PACKAGES_STAGE2))
1196         "$(RM)" $(RM_OPTS_REC) $(patsubst %, libraries/%/autom4te.cache, $(PACKAGES) $(PACKAGES_STAGE2))
1197
1198 maintainer-clean : distclean
1199         "$(RM)" $(RM_OPTS) configure mk/config.h.in
1200         "$(RM)" $(RM_OPTS_REC) autom4te.cache libraries/*/autom4te.cache
1201         "$(RM)" $(RM_OPTS) ghc.spec
1202         "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/GNUmakefile, \
1203                 $(PACKAGES) $(PACKAGES_STAGE2))
1204         "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/ghc.mk, $(PACKAGES) $(PACKAGES_STAGE2))
1205         "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/configure, \
1206                 $(PACKAGES) $(PACKAGES_STAGE2))
1207         "$(RM)" $(RM_OPTS) libraries/base/include/HsBaseConfig.h.in
1208         "$(RM)" $(RM_OPTS) libraries/directory/include/HsDirectoryConfig.h.in
1209         "$(RM)" $(RM_OPTS) libraries/process/include/HsProcessConfig.h.in
1210         "$(RM)" $(RM_OPTS) libraries/unix/include/HsUnixConfig.h.in
1211         "$(RM)" $(RM_OPTS) libraries/old-time/include/HsTimeConfig.h.in
1212
1213 .PHONY: all_libraries
1214
1215 .PHONY: bootstrapping-files
1216 bootstrapping-files: $(OTHER_LIBS)
1217 bootstrapping-files: includes/ghcautoconf.h
1218 bootstrapping-files: includes/DerivedConstants.h
1219 bootstrapping-files: includes/GHCConstants.h
1220
1221 .DELETE_ON_ERROR:
1222