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