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