ghc.mk

   1 # -----------------------------------------------------------------------------
   2 #
   3 # (c) 2009 The University of Glasgow
   4 #
   5 # This file is part of the GHC build system.
   6 #
   7 # To understand how the build system works and how to modify it, see
   8 #      http://hackage.haskell.org/trac/ghc/wiki/Building/Architecture
   9 #      http://hackage.haskell.org/trac/ghc/wiki/Building/Modifying
  10 #
  11 # -----------------------------------------------------------------------------
  12
  13 # ToDo List.
  14 #
  15 #   * finish installation
  16 #     * other documentation
  17 #     * create doc index and contents
  18 #     * Windows: should we have ghc-pkg-<version>?
  19 #     * should we be stripping things?
  20 #     * install libgmp.a, gmp.h
  21 #   * need to fix Cabal for new Windows layout, see
  22 #     Distribution/Simple/GHC.configureToolchain.
  23 #   * remove old Makefiles, add new stubs for building in subdirs
  24 #     * utils/hsc2hs/Makefile
  25 #     * utils/haddock/Makefile
  26 #     * docs/Makefile
  27 #     * docs/docbook-cheat-sheet/Makefile
  28 #     * docs/ext-core/Makefile
  29 #     * docs/man/Makefile
  30 #     * docs/storage-mgmt/Makefile
  31 #     * docs/vh/Makefile
  32 #     * driver/Makefile
  33 #     * rts/dotnet/Makefile
  34 #     * utils/Makefile
  35 #   * GhcProfiled
  36 #   * optionally install stage3?
  37 #   * shared libraries, way dyn
  38 #   * add Makefiles for the rest of the utils/ programs that aren't built
  39 #     by default (need to exclude them from 'make all' too)
  40 #
  41 # Tickets we can now close, or fix and close:
  42 #
  43 #   * 1693 make distclean
  44 #   * 3173 make install with DESTDIR
  45
  46 # Possible cleanups:
  47 #
  48 #   * per-source-file dependencies instead of one .depend file?
  49 #   * eliminate undefined variables, and use --warn-undefined-variables?
  50 #   * perhaps we should make all the output dirs in the .depend rule, to
  51 #     avoid all these mkdirhier calls?
  52 #   * put outputs from different ways in different subdirs of distdir/build,
  53 #     then we don't have to use -osuf/-hisuf.  We would have to install
  54 #     them in different places too, so we'd need ghc-pkg support for packages
  55 #     of different ways.
  56 #   * make PACKAGES generated by configure or sh boot?
  57 #   * we should use a directory of package.conf files rather than a single
  58 #     file for the inplace package database, so that we can express
  59 #     dependencies more accurately.  Otherwise it's possible to get into
  60 #     a state where the package database is out of date, and the build
  61 #     system doesn't know.
  62
  63 # Approximate build order.
  64 #
  65 # The actual build order is defined by dependencies, and the phase
  66 # ordering used to ensure correct ordering of makefile-generation; see
  67 #    http://hackage.haskell.org/trac/ghc/wiki/Building/Architecture/Idiom/PhaseOrdering
  68 #
  69 #     * With bootstrapping compiler:
  70 #           o Build utils/ghc-cabal
  71 #           o Build utils/ghc-pkg
  72 #           o Build utils/hsc2hs
  73 #     * For each package:
  74 #           o configure, generate package-data.mk and inplace-pkg-info
  75 #           o register each package into inplace/lib/package.conf
  76 #     * build libffi
  77 #     * With bootstrapping compiler:
  78 #           o Build libraries/{filepath,hpc,extensible-exceptions,Cabal}
  79 #           o Build compiler (stage 1)
  80 #     * With stage 1:
  81 #           o Build libraries/*
  82 #           o Build rts
  83 #           o Build utils/* (except haddock)
  84 #           o Build compiler (stage 2)
  85 #     * With stage 2:
  86 #           o Build utils/haddock
  87 #           o Build compiler (stage 3) (optional)
  88 #     * With haddock:
  89 #           o libraries/*
  90 #           o compiler
  91
  92 .PHONY: default all haddock
  93
  94 default : all
  95
  96 # Just bring makefiles up to date:
  97 .PHONY: just-makefiles
  98 just-makefiles:
  99         @:
 100
 101 # -----------------------------------------------------------------------------
 102 # Misc GNU make utils
 103
 104 nothing=
 105 space=$(nothing) $(nothing)
 106 comma=,
 107
 108 # Cancel all suffix rules.  Ideally we'd like to have 'make -r' turned on
 109 # by default, because that disables all the implicit rules, but there doesn't
 110 # seem to be a good way to do that.  This turns off all the old-style suffix
 111 # rules, which does half the job and speeds up make quite a bit:
 112 .SUFFIXES:
 113
 114 # -----------------------------------------------------------------------------
 115 #                       Makefile debugging
 116 # to see the effective value used for a Makefile variable, do
 117 #  make show VALUE=MY_VALUE
 118 #
 119
 120 show:
 121         @echo '$(VALUE)="$($(VALUE))"'
 122
 123 # -----------------------------------------------------------------------------
 124 # Include subsidiary build-system bits
 125
 126 include mk/tree.mk
 127
 128 ifeq "$(findstring clean,$(MAKECMDGOALS))" ""
 129 include mk/config.mk
 130 ifeq "$(ProjectVersion)" ""
 131 $(error Please run ./configure first)
 132 endif
 133 endif
 134
 135 # (Optional) build-specific configuration
 136 include mk/custom-settings.mk
 137
 138 ifeq "$(findstring clean,$(MAKECMDGOALS))" ""
 139 ifeq "$(GhcLibWays)" ""
 140 $(error $$(GhcLibWays) is empty, it must contain at least one way)
 141 endif
 142 endif
 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))
 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 # We don't haddock base3-compat, as it has the same package name as base
 175 libraries/base3-compat_dist-install_DO_HADDOCK = NO
 176
 177 # We don't haddock the bootstrapping libraries
 178 libraries/hpc_dist-boot_DO_HADDOCK = NO
 179 libraries/Cabal_dist-boot_DO_HADDOCK = NO
 180 libraries/extensible-exceptions_dist-boot_DO_HADDOCK = NO
 181 libraries/filepath_dist-boot_DO_HADDOCK = NO
 182
 183 # -----------------------------------------------------------------------------
 184 # Ways
 185
 186 include rules/way-prelims.mk
 187
 188 $(foreach way,$(ALL_WAYS),\
 189   $(eval $(call way-prelims,$(way))))
 190
 191 # -----------------------------------------------------------------------------
 192 # Compilation Flags
 193
 194 include rules/distdir-opts.mk
 195 include rules/distdir-way-opts.mk
 196
 197 # -----------------------------------------------------------------------------
 198 # Finding source files and object files
 199
 200 include rules/hs-sources.mk
 201 include rules/c-sources.mk
 202 include rules/includes-sources.mk
 203 include rules/hs-objs.mk
 204 include rules/c-objs.mk
 205 include rules/cmm-objs.mk
 206
 207 # -----------------------------------------------------------------------------
 208 # Suffix rules
 209
 210 # Suffix rules cause "make clean" to fail on Windows (trac #3233)
 211 # so we don't make any when cleaning.
 212 ifneq "$(CLEANING)" "YES"
 213
 214 include rules/hs-suffix-rules-srcdir.mk
 215 include rules/hs-suffix-rules.mk
 216
 217 # -----------------------------------------------------------------------------
 218 # Suffix rules for .hi files
 219
 220 include rules/hi-rule.mk
 221
 222 $(foreach way,$(ALL_WAYS),\
 223   $(eval $(call hi-rule,$(way))))
 224
 225 #-----------------------------------------------------------------------------
 226 # C-related suffix rules
 227
 228 include rules/c-suffix-rules.mk
 229
 230 #-----------------------------------------------------------------------------
 231 # CMM-related suffix rules
 232
 233 include rules/cmm-suffix-rules.mk
 234
 235 endif
 236
 237 # -----------------------------------------------------------------------------
 238 # Building package-data.mk files from .cabal files
 239
 240 include rules/package-config.mk
 241
 242 # -----------------------------------------------------------------------------
 243 # Building dependencies
 244
 245 include rules/build-dependencies.mk
 246
 247 # -----------------------------------------------------------------------------
 248 # Build package-data.mk files
 249
 250 include rules/build-package-data.mk
 251
 252 # -----------------------------------------------------------------------------
 253 # Build and install a program
 254
 255 include rules/build-prog.mk
 256 include rules/shell-wrapper.mk
 257
 258 # -----------------------------------------------------------------------------
 259 # Build a perl script
 260
 261 include rules/build-perl.mk
 262
 263 # -----------------------------------------------------------------------------
 264 # Build a package
 265
 266 include rules/build-package.mk
 267 include rules/build-package-way.mk
 268 include rules/haddock.mk
 269
 270 # -----------------------------------------------------------------------------
 271 # Registering hand-written package descriptions (used in libffi and rts)
 272
 273 include rules/manual-package-config.mk
 274
 275 # -----------------------------------------------------------------------------
 276 # Docs
 277
 278 include rules/docbook.mk
 279
 280 # -----------------------------------------------------------------------------
 281 # Making bindists
 282
 283 include rules/bindist.mk
 284
 285 # -----------------------------------------------------------------------------
 286 # Building libraries
 287
 288 # XXX generate from $(TOP)/packages
 289 PACKAGES = \
 290         ghc-prim \
 291         integer-gmp \
 292         base \
 293         filepath \
 294         array \
 295         bytestring \
 296         containers
 297
 298 ifeq "$(Windows)" "YES"
 299 PACKAGES += Win32
 300 else
 301 PACKAGES += unix
 302 endif
 303
 304 PACKAGES += \
 305         old-locale \
 306         old-time \
 307         directory \
 308         process \
 309         random \
 310         extensible-exceptions \
 311         haskell98 \
 312         hpc \
 313         pretty \
 314         syb \
 315         template-haskell \
 316         base3-compat \
 317         Cabal \
 318         mtl \
 319         utf8-string
 320
 321 ifneq "$(Windows)" "YES"
 322 PACKAGES += terminfo
 323 endif
 324
 325 PACKAGES += haskeline
 326
 327 ifneq "$(BootingFromHc)" "YES"
 328 PACKAGES_STAGE2 += \
 329         dph/dph-base \
 330         dph/dph-prim-interface \
 331         dph/dph-prim-seq \
 332         dph/dph-prim-par \
 333         dph/dph-seq \
 334         dph/dph-par
 335 endif
 336
 337 BOOT_PKGS = Cabal hpc extensible-exceptions
 338
 339 # The actual .a and .so/.dll files: needed for dependencies.
 340 ALL_STAGE1_LIBS  = $(foreach lib,$(PACKAGES),$(libraries/$(lib)_dist-install_v_LIB))
 341 ifeq "$(BuildSharedLibs)" "YES"
 342 ALL_STAGE1_LIBS += $(foreach lib,$(PACKAGES),$(libraries/$(lib)_dist-install_dyn_LIB))
 343 endif
 344 BOOT_LIBS = $(foreach lib,$(BOOT_PKGS),$(libraries/$(lib)_dist-boot_v_LIB))
 345
 346 OTHER_LIBS = libffi/libHSffi$(v_libsuf) libffi/HSffi.o
 347 ifeq "$(BuildSharedLibs)" "YES"
 348 OTHER_LIBS  += libffi/libHSffi$(dyn_libsuf)
 349 endif
 350
 351 # We cannot run ghc-cabal to configure a package until we have
 352 # configured and registered all of its dependencies.  So the following
 353 # hack forces all the configure steps to happen in exactly the order
 354 # given in the PACKAGES variable above.  Ideally we should use the
 355 # correct dependencies here to allow more parallelism, but we don't
 356 # know the dependencies until we've generated the pacakge-data.mk
 357 # files.
 358 define fixed_pkg_dep
 359 libraries/$1/$2/package-data.mk : $$(GHC_PKG_INPLACE) $$(if $$(fixed_pkg_prev),libraries/$$(fixed_pkg_prev)/$2/package-data.mk)
 360 fixed_pkg_prev:=$1
 361 endef
 362
 363 ifneq "$(BINDIST)" "YES"
 364 fixed_pkg_prev=
 365 $(foreach pkg,$(PACKAGES) $(PACKAGES_STAGE2),$(eval $(call fixed_pkg_dep,$(pkg),dist-install)))
 366
 367 # We assume that the stage2 compiler depends on all the libraries, so
 368 # they all get added to the package database before we try to configure
 369 # it
 370 compiler/stage2/package-data.mk: $(foreach pkg,$(PACKAGES) $(PACKAGES_STAGE2),libraries/$(pkg)/dist-install/package-data.mk)
 371 ghc/stage1/package-data.mk: compiler/stage1/package-data.mk
 372 ghc/stage2/package-data.mk: compiler/stage2/package-data.mk
 373 # haddock depends on ghc and some libraries, but depending on GHC's
 374 # package-data.mk is sufficient, as that in turn depends on all the
 375 # libraries
 376 utils/haddock/dist/package-data.mk: compiler/stage2/package-data.mk
 377
 378 utils/hsc2hs/dist-install/package-data.mk: compiler/stage2/package-data.mk
 379
 380 # add the final two package.conf dependencies: ghc-prim depends on RTS,
 381 # and RTS depends on libffi.
 382 libraries/ghc-prim/dist-install/package-data.mk : rts/package.conf.inplace
 383 rts/package.conf.inplace : libffi/package.conf.inplace
 384 endif
 385
 386 # -----------------------------------------------------------------------------
 387 # Special magic for the ghc-prim package
 388
 389 # We want the ghc-prim package to include the GHC.Prim module when it
 390 # is registered, but not when it is built, because GHC.Prim is not a
 391 # real source module, it is built-in to GHC.  The old build system did
 392 # this using Setup.hs, but we can't do that here, so we have a flag to
 393 # enable GHC.Prim in the .cabal file (so that the ghc-prim package
 394 # remains compatible with the old build system for the time being).
 395 # GHC.Prim module in the ghc-prim package with a flag:
 396 #
 397 libraries/ghc-prim_CONFIGURE_OPTS += --flag=include-ghc-prim
 398
 399 # And then we strip it out again before building the package:
 400 define libraries/ghc-prim_PACKAGE_MAGIC
 401 libraries/ghc-prim_dist-install_MODULES := $$(filter-out GHC.Prim,$$(libraries/ghc-prim_dist-install_MODULES))
 402 endef
 403
 404 PRIMOPS_TXT = $(GHC_COMPILER_DIR)/prelude/primops.txt
 405
 406 libraries/ghc-prim/dist-install/build/GHC/PrimopWrappers.hs : $(GENPRIMOP_INPLACE) $(PRIMOPS_TXT)
 407         "$(MKDIRHIER)" $(dir $@)
 408         "$(GENPRIMOP_INPLACE)" --make-haskell-wrappers <$(PRIMOPS_TXT) >$@
 409
 410 libraries/ghc-prim/GHC/Prim.hs : $(GENPRIMOP_INPLACE) $(PRIMOPS_TXT)
 411         "$(GENPRIMOP_INPLACE)" --make-haskell-source <$(PRIMOPS_TXT) >$@
 412
 413
 414 # -----------------------------------------------------------------------------
 415 # Include build instructions from all subdirs
 416
 417 # For the rationale behind the build phases, see
 418 #   http://hackage.haskell.org/trac/ghc/wiki/Building/Architecture/Idiom/PhaseOrdering
 419
 420 # Setting foo_dist_DISABLE=YES means "in directory foo, for build
 421 # "dist", just read the package-data.mk file, do not build anything".
 422
 423 # We carefully engineer things so that we can build the
 424 # package-data.mk files early on: they depend only on a few tools also
 425 # built early.  Having got the package-data.mk files built, we can
 426 # restart make with up-to-date information about all the packages
 427 # (this is phase 0).  The remaining problem is the .depend files:
 428 #
 429 #   - .depend files in libraries need the stage 1 compiler to build
 430 #   - ghc/stage1/.depend needs compiler/stage1 built
 431 #   - compiler/stage1/.depend needs the bootstrap libs built
 432 #
 433 # GHC 6.11+ can build a .depend file without having built the
 434 # dependencies of the package, but we can't rely on the bootstrapping
 435 # compiler being able to do this, which is why we have to separate the
 436 # three phases above.
 437
 438 # So this is the final ordering:
 439
 440 # Phase 0 : all package-data.mk files
 441 #           (requires ghc-cabal, ghc-pkg, mkdirhier, dummy-ghc etc.)
 442 # Phase 1 : .depend files for bootstrap libs
 443 #           (requires hsc2hs)
 444 # Phase 2 : compiler/stage1/.depend
 445 #           (requires bootstrap libs and genprimopcode)
 446 # Phase 3 : ghc/stage1/.depend
 447 #           (requires compiler/stage1)
 448 #
 449 # The rest : libraries/*/dist-install, compiler/stage2, ghc/stage2
 450
 451 BUILD_DIRS =
 452
 453 ifneq "$(BINDIST)" "YES"
 454 BUILD_DIRS += \
 455    $(GHC_MKDEPENDC_DIR) \
 456    $(GHC_MKDIRHIER_DIR)
 457 endif
 458
 459 BUILD_DIRS += \
 460    docs/users_guide \
 461    libraries/Cabal/doc \
 462    $(GHC_UNLIT_DIR) \
 463    $(GHC_HP2PS_DIR)
 464
 465 ifneq "$(GhcUnregisterised)" "YES"
 466 BUILD_DIRS += \
 467    $(GHC_MANGLER_DIR) \
 468    $(GHC_SPLIT_DIR)
 469 endif
 470
 471 ifneq "$(BINDIST)" "YES"
 472 BUILD_DIRS += \
 473    $(GHC_GENPRIMOP_DIR)
 474 endif
 475
 476 BUILD_DIRS += \
 477    driver \
 478    driver/ghci \
 479    driver/ghc \
 480    libffi \
 481    includes \
 482    rts
 483
 484 ifneq "$(BINDIST)" "YES"
 485 BUILD_DIRS += \
 486    $(GHC_CABAL_DIR) \
 487    $(GHC_GENAPPLY_DIR)
 488 endif
 489
 490 BUILD_DIRS += \
 491    utils/haddock \
 492    utils/haddock/doc
 493
 494 ifneq "$(CLEANING)" "YES"
 495 BUILD_DIRS += \
 496    $(patsubst %, libraries/%, $(PACKAGES) $(PACKAGES_STAGE2))
 497 ifneq "$(BootingFromHc)" "YES"
 498 BUILD_DIRS += \
 499    libraries/dph
 500 endif
 501 endif
 502
 503 BUILD_DIRS += \
 504    libraries/integer-gmp/gmp \
 505    compiler \
 506    $(GHC_HSC2HS_DIR) \
 507    $(GHC_PKG_DIR) \
 508    utils/hpc \
 509    utils/runghc \
 510    ghc
 511 ifeq "$(Windows)" "YES"
 512 BUILD_DIRS += \
 513    $(GHC_TOUCHY_DIR)
 514 endif
 515
 516 # XXX libraries/% must come before any programs built with stage1, see
 517 # Note [lib-depends].
 518
 519 ifeq "$(phase)" "0"
 520 $(foreach lib,$(BOOT_PKGS),$(eval \
 521   libraries/$(lib)_dist-boot_DISABLE = YES))
 522 endif
 523
 524 ifneq "$(findstring $(phase),0 1)" ""
 525 # We can build deps for compiler/stage1 in phase 2
 526 compiler_stage1_DISABLE = YES
 527 endif
 528
 529 ifneq "$(findstring $(phase),0 1 2)" ""
 530 ghc_stage1_DISABLE = YES
 531 endif
 532
 533 ifneq "$(findstring $(phase),0 1 2 3)" ""
 534 # In phases 0-3, we disable stage2-3, the full libraries and haddock
 535 utils/haddock_dist_DISABLE = YES
 536 utils/runghc_dist_DISABLE = YES
 537 utils/hpc_dist_DISABLE = YES
 538 utils/hsc2hs_dist-install_DISABLE = YES
 539 utils/ghc-pkg_dist-install_DISABLE = YES
 540 compiler_stage2_DISABLE = YES
 541 compiler_stage3_DISABLE = YES
 542 ghc_stage2_DISABLE = YES
 543 ghc_stage3_DISABLE = YES
 544 $(foreach lib,$(PACKAGES) $(PACKAGES_STAGE2),$(eval \
 545   libraries/$(lib)_dist-install_DISABLE = YES))
 546 endif
 547
 548 include $(patsubst %, %/ghc.mk, $(BUILD_DIRS))
 549
 550 # We need -fno-warn-deprecated-flags to avoid failure with -Werror
 551 GhcLibHcOpts += -fno-warn-deprecated-flags
 552 ifeq "$(ghc_ge_609)" "YES"
 553 GhcBootLibHcOpts += -fno-warn-deprecated-flags
 554 endif
 555
 556 # Add $(GhcLibHcOpts) to all library builds
 557 $(foreach pkg,$(PACKAGES) $(PACKAGES_STAGE2),$(eval libraries/$(pkg)_dist-install_HC_OPTS += $$(GhcLibHcOpts)))
 558
 559 # XXX Hack; remove this
 560 $(foreach pkg,$(PACKAGES_STAGE2),$(eval libraries/$(pkg)_dist-install_HC_OPTS += -Wwarn))
 561
 562 # XXX we configure packages with the bootstrapping compiler (for
 563 # dependency reasons, see the phase ordering), which doesn't
 564 # necessarily support all the extensions we need, and Cabal filters
 565 # out the ones it thinks aren't supported.
 566 libraries/base3-compat_dist-install_HC_OPTS += -XPackageImports
 567
 568 # A useful pseudo-target
 569 .PHONY: stage1_libs
 570 stage1_libs : $(ALL_STAGE1_LIBS)
 571
 572 # -----------------------------------------------------------------------------
 573 # Bootstrapping libraries
 574
 575 # We need to build a few libraries with the installed GHC, since GHC itself
 576 # and some of the tools depend on them:
 577
 578 ifneq "$(BINDIST)" "YES"
 579
 580 ifneq "$(BOOTSTRAPPING_CONF)" ""
 581 ifeq "$(wildcard $(BOOTSTRAPPING_CONF))" ""
 582 $(shell echo "[]" >$(BOOTSTRAPPING_CONF))
 583 endif
 584 endif
 585
 586 $(eval $(call clean-target,$(BOOTSTRAPPING_CONF),,$(BOOTSTRAPPING_CONF)))
 587
 588 # These three libraries do not depend on each other, so we can build
 589 # them straight off:
 590
 591 $(eval $(call build-package,libraries/hpc,dist-boot,0))
 592 $(eval $(call build-package,libraries/extensible-exceptions,dist-boot,0))
 593 $(eval $(call build-package,libraries/Cabal,dist-boot,0))
 594
 595 # register the boot packages in strict sequence, because running
 596 # multiple ghc-pkgs in parallel doesn't work (registrations may get
 597 # lost).
 598 fixed_pkg_prev=
 599 $(foreach pkg,$(BOOT_PKGS),$(eval $(call fixed_pkg_dep,$(pkg),dist-boot)))
 600
 601 compiler/stage1/package-data.mk : \
 602     libraries/Cabal/dist-boot/package-data.mk \
 603     libraries/hpc/dist-boot/package-data.mk \
 604     libraries/extensible-exceptions/dist-boot/package-data.mk
 605
 606 # These are necessary because the bootstrapping compiler may not know
 607 # about cross-package dependencies:
 608 $(compiler_stage1_depfile) : $(BOOT_LIBS)
 609 $(ghc_stage1_depfile) : $(compiler_stage1_v_LIB)
 610
 611 $(foreach pkg,$(BOOT_PKGS),$(eval libraries/$(pkg)_dist-boot_HC_OPTS += $$(GhcBootLibHcOpts)))
 612
 613 endif
 614
 615 # -----------------------------------------------------------------------------
 616 # Creating a local mingw copy on Windows
 617
 618 ifeq "$(Windows)" "YES"
 619
 620 # directories don't work well as dependencies, hence a stamp file
 621 $(INPLACE)/stamp-mingw : $(MKDIRHIER)
 622         $(MKDIRHIER) $(INPLACE_MINGW)/bin
 623         GCC=`type -p $(WhatGccIsCalled)`; \
 624         GccDir=`dirname $$GCC`; \
 625         "$(CP)" -p $$GccDir/{gcc.exe,ar.exe,as.exe,dlltool.exe,dllwrap.exe,windres.exe} $(INPLACE_MINGW)/bin; \
 626         "$(CP)" -Rp $$GccDir/../include $(INPLACE_MINGW); \
 627         "$(CP)" -Rp $$GccDir/../lib     $(INPLACE_MINGW); \
 628         "$(CP)" -Rp $$GccDir/../libexec $(INPLACE_MINGW); \
 629         "$(CP)" -Rp $$GccDir/../mingw32 $(INPLACE_MINGW)
 630         touch $(INPLACE)/stamp-mingw
 631
 632 install : install_mingw
 633 .PHONY: install_mingw
 634 install_mingw : $(INPLACE_MINGW)
 635         "$(CP)" -Rp $(INPLACE_MINGW) $(prefix)
 636
 637 $(INPLACE_LIB)/perl.exe $(INPLACE_LIB)/perl56.dll :
 638         "$(CP)" $(GhcDir)../{perl.exe,perl56.dll} $(INPLACE_LIB)
 639
 640 endif # Windows
 641
 642 libraries/ghc-prim/dist-install/doc/html/ghc-prim/ghc-prim.haddock: \
 643     libraries/ghc-prim/dist-install/build/autogen/GHC/Prim.hs \
 644     libraries/ghc-prim/dist-install/build/autogen/GHC/PrimopWrappers.hs
 645
 646 libraries/ghc-prim/dist-install/build/autogen/GHC/Prim.hs: \
 647                             $(PRIMOPS_TXT) $(GENPRIMOP_INPLACE) $(MKDIRHIER)
 648         "$(MKDIRHIER)" $(dir $@)
 649         "$(GENPRIMOP_INPLACE)" --make-haskell-source < $< > $@
 650
 651 libraries/ghc-prim/dist-install/build/autogen/GHC/PrimopWrappers.hs: \
 652                             $(PRIMOPS_TXT) $(GENPRIMOP_INPLACE) $(MKDIRHIER)
 653         "$(MKDIRHIER)" $(dir $@)
 654         "$(GENPRIMOP_INPLACE)" --make-haskell-wrappers < $< > $@
 655
 656 # -----------------------------------------------------------------------------
 657 # Installation
 658
 659 install: install_packages install_libs install_libexecs install_headers \
 660          install_libexec_scripts install_bins
 661
 662 install_bins: $(INSTALL_BINS)
 663         $(INSTALL_DIR) $(DESTDIR)$(bindir)
 664         for i in $(INSTALL_BINS); do \
 665                 $(INSTALL_PROGRAM) $(INSTALL_BIN_OPTS) $$i $(DESTDIR)$(bindir) ;  \
 666                 if test "$(darwin_TARGET_OS)" = "1"; then \
 667                    sh mk/fix_install_names.sh $(libdir) $(DESTDIR)$(bindir)/$$i ; \
 668                 fi ; \
 669         done
 670
 671 install_libs: $(INSTALL_LIBS)
 672         $(INSTALL_DIR) $(DESTDIR)$(libdir)
 673         for i in $(INSTALL_LIBS); do \
 674                 case $$i in \
 675                   *.a) \
 676                     $(INSTALL_DATA) $(INSTALL_OPTS) $$i $(DESTDIR)$(libdir); \
 677                     $(RANLIB) $(DESTDIR)$(libdir)/`basename $$i` ;; \
 678                   *.dll) \
 679                     $(INSTALL_DATA) -s $(INSTALL_OPTS) $$i $(DESTDIR)$(libdir) ;; \
 680                   *.so) \
 681                     $(INSTALL_SHLIB) $(INSTALL_OPTS) $$i $(DESTDIR)$(libdir) ;; \
 682                   *.dylib) \
 683                     $(INSTALL_SHLIB) $(INSTALL_OPTS) $$i $(DESTDIR)$(libdir); \
 684                     install_name_tool -id $(DESTDIR)$(libdir)/`basename $$i` $(DESTDIR)$(libdir)/`basename $$i` ;; \
 685                   *) \
 686                     $(INSTALL_DATA) $(INSTALL_OPTS) $$i $(DESTDIR)$(libdir); \
 687                 esac; \
 688         done
 689
 690 install_libexec_scripts: $(INSTALL_LIBEXEC_SCRIPTS)
 691         "$(MKDIRHIER)" $(DESTDIR)$(libexecdir)
 692         for i in $(INSTALL_LIBEXEC_SCRIPTS); do \
 693                 $(INSTALL_SCRIPT) $(INSTALL_OPTS) $$i $(DESTDIR)$(libexecdir); \
 694         done
 695
 696 install_libexecs:  $(INSTALL_LIBEXECS)
 697         "$(MKDIRHIER)" $(DESTDIR)$(libexecdir)
 698         for i in $(INSTALL_LIBEXECS); do \
 699                 $(INSTALL_PROGRAM) $(INSTALL_BIN_OPTS) $$i $(DESTDIR)$(libexecdir); \
 700         done
 701
 702 install_headers: $(INSTALL_HEADERS)
 703         $(INSTALL_DIR) $(DESTDIR)$(headerdir)
 704         for i in $(INSTALL_HEADERS); do \
 705                 $(INSTALL_HEADER) $(INSTALL_OPTS) $$i $(DESTDIR)$(headerdir); \
 706         done
 707
 708 INSTALLED_PACKAGE_CONF=$(DESTDIR)$(libdir)/package.conf
 709
 710 # Install packages in the right order, so that ghc-pkg doesn't complain.
 711 # Also, install ghc-pkg first.
 712 ifeq "$(Windows)" "NO"
 713 INSTALLED_GHC_PKG_REAL=$(DESTDIR)$(libexecdir)/ghc-pkg
 714 else
 715 INSTALLED_GHC_PKG_REAL=$(DESTDIR)$(bindir)/ghc-pkg.exe
 716 endif
 717
 718 install_packages: install_libexecs
 719 install_packages: libffi/package.conf.install rts/package.conf.install
 720         "$(MKDIRHIER)" $(DESTDIR)$(libdir)
 721         echo "[]" > $(INSTALLED_PACKAGE_CONF)
 722         "$(INSTALLED_GHC_PKG_REAL)" --force --global-conf $(INSTALLED_PACKAGE_CONF) update libffi/package.conf.install
 723         "$(INSTALLED_GHC_PKG_REAL)" --force --global-conf $(INSTALLED_PACKAGE_CONF) update rts/package.conf.install
 724         $(foreach p, $(PACKAGES) $(PACKAGES_STAGE2),\
 725             "$(GHC_CABAL_INPLACE)" install \
 726                  $(INSTALLED_GHC_PKG_REAL) \
 727                  $(INSTALLED_PACKAGE_CONF) \
 728                  libraries/$p dist-install \
 729                  '$(DESTDIR)' '$(prefix)' '$(libdir)' '$(docdir)/libraries' &&) true
 730         "$(GHC_CABAL_INPLACE)" install \
 731                  $(INSTALLED_GHC_PKG_REAL) \
 732                  $(INSTALLED_PACKAGE_CONF) \
 733                  compiler stage2 \
 734                  '$(DESTDIR)' '$(prefix)' '$(libdir)' '$(docdir)/libraries'
 735
 736 # -----------------------------------------------------------------------------
 737 # Binary distributions
 738
 739 $(eval $(call bindist,.,\
 740     LICENSE \
 741     configure config.sub config.guess install-sh \
 742     extra-gcc-opts.in \
 743     Makefile \
 744     mk/config.mk.in \
 745     $(INPLACE_BIN)/mkdirhier \
 746     $(INPLACE_BIN)/ghc-cabal \
 747     utils/ghc-pwd/ghc-pwd \
 748         $(BINDIST_WRAPPERS) \
 749         $(BINDIST_LIBS) \
 750         $(BINDIST_HI) \
 751         $(BINDIST_EXTRAS) \
 752     $(INSTALL_HEADERS) \
 753     $(INSTALL_LIBEXECS) \
 754     $(INSTALL_LIBEXEC_SCRIPTS) \
 755     $(INSTALL_BINS) \
 756     $(filter-out extra-gcc-opts,$(INSTALL_LIBS)) \
 757     $(filter-out %/project.mk,$(filter-out mk/config.mk,$(MAKEFILE_LIST))) \
 758         mk/fix_install_names.sh \
 759         mk/project.mk \
 760         libraries/dph/LICENSE \
 761  ))
 762 # mk/project.mk gets an absolute path, so we manually include it in
 763 # the bindist with a relative path
 764
 765 binary-dist:
 766         "$(RM)" $(RM_OPTS) -r $(BIN_DIST_NAME)
 767         mkdir $(BIN_DIST_NAME)
 768         set -e; for i in LICENSE compiler ghc rts libraries utils docs libffi includes driver mk rules Makefile aclocal.m4 config.sub config.guess install-sh extra-gcc-opts.in ghc.mk inplace; do ln -s ../$$i $(BIN_DIST_NAME)/; done
 769         ln -s ../distrib/configure-bin.ac $(BIN_DIST_NAME)/configure.ac
 770         cd $(BIN_DIST_NAME) && autoreconf
 771         "$(RM)" $(RM_OPTS) $(BIN_DIST_TAR)
 772 # h means "follow symlinks", e.g. if aclocal.m4 is a symlink to a source
 773 # tree then we want to include the real file, not a symlink to it
 774         "$(TAR)" hcf - -T $(BIN_DIST_LIST) | bzip2 -c > $(BIN_DIST_TAR_BZ2)
 775
 776 windows-binary-dist:
 777         "$(RM)" $(RM_OPTS) -r $(BIN_DIST_NAME)
 778         $(MAKE) prefix=$(BIN_DIST_DIR) install
 779         "$(TAR)" cf - $(BIN_DIST_NAME) | bzip2 -c > $(BIN_DIST_TAR_BZ2)
 780
 781 windows-installer:
 782         "$(ISCC)" /O. /F$(WINDOWS_INSTALLER_BASE) - < distrib/ghc.iss
 783
 784 nTimes = set -e; for i in `seq 1 $(1)`; do echo Try "$$i: $(2)"; if $(2); then break; fi; done
 785
 786 .PHONY: publish-binary-dist
 787 publish-binary-dist:
 788         $(call nTimes,10,$(PublishCp) $(BIN_DIST_TAR_BZ2) $(PublishLocation)/dist)
 789 ifeq "$(mingw32_TARGET_OS)" "1"
 790         $(call nTimes,10,$(PublishCp) $(WINDOWS_INSTALLER) $(PublishLocation)/dist)
 791 endif
 792
 793 # -----------------------------------------------------------------------------
 794 # Source distributions
 795
 796 # Do it like this:
 797 #
 798 #       $ make
 799 #       $ make sdist
 800 #
 801
 802 # A source dist is built from a complete build tree, because we
 803 # require some extra files not contained in a darcs checkout: the
 804 # output from Happy and Alex, for example.
 805 #
 806 # The steps performed by 'make dist' are as follows:
 807 #   - create a complete link-tree of the current build tree in /tmp
 808 #   - run 'make distclean' on that tree
 809 #   - remove a bunch of other files that we know shouldn't be in the dist
 810 #   - tar up first the extralibs package, then the main source package
 811
 812 #
 813 # Directory in which we're going to build the src dist
 814 #
 815 SRC_DIST_NAME=ghc-$(ProjectVersion)
 816 SRC_DIST_DIR=$(shell pwd)/$(SRC_DIST_NAME)
 817
 818 #
 819 # Files to include in source distributions
 820 #
 821 SRC_DIST_DIRS = mk rules docs distrib bindisttest libffi includes utils docs rts compiler ghc driver libraries
 822 SRC_DIST_FILES += \
 823         configure.ac config.guess config.sub configure \
 824         aclocal.m4 README ANNOUNCE HACKING LICENSE Makefile install-sh \
 825         ghc.spec.in ghc.spec extra-gcc-opts.in VERSION boot ghc.mk
 826
 827 SRC_DIST_TARBALL = $(SRC_DIST_NAME)-src.tar.bz2
 828
 829 VERSION :
 830         echo $(ProjectVersion) >VERSION
 831
 832 sdist : VERSION
 833
 834 # Use:
 835 #     $(call sdist_file,compiler,stage2,cmm,CmmLex,x)
 836 # to copy the generated file that replaces compiler/cmm/CmmLex.x, where
 837 # "stage2" is the dist dir.
 838 sdist_file = \
 839   if test -f $(TOP)/$1/$2/build/$4.hs; then \
 840     "$(CP)" $(TOP)/$1/$2/build/$4.hs $1/$3/ ; \
 841     mv $1/$3/$4.$5 $1/$3/$4.$5.source ;\
 842   else \
 843     echo "does not exist: $1/$2//build/$4.hs"; \
 844     exit 1; \
 845   fi
 846
 847 .PHONY: sdist-prep
 848 sdist-prep :
 849         "$(RM)" $(RM_OPTS) -r $(SRC_DIST_DIR)
 850         "$(RM)" $(RM_OPTS) $(SRC_DIST_TARBALL)
 851         mkdir $(SRC_DIST_DIR)
 852         ( cd $(SRC_DIST_DIR) \
 853           && for i in $(SRC_DIST_DIRS); do mkdir $$i; (cd $$i && lndir $(TOP)/$$i ); done \
 854           && for i in $(SRC_DIST_FILES); do $(LN_S) $(TOP)/$$i .; done \
 855           && $(MAKE) distclean \
 856           && if test -f $(TOP)/libraries/haskell-src/dist/build/Language/Haskell/Parser.hs; then "$(CP)" $(TOP)/libraries/haskell-src/dist/build/Language/Haskell/Parser.hs libraries/haskell-src/Language/Haskell/ ; mv libraries/haskell-src/Language/Haskell/Parser.ly libraries/haskell-src/Language/Haskell/Parser.ly.source ; fi \
 857           && $(call sdist_file,compiler,stage2,cmm,CmmLex,x) \
 858           && $(call sdist_file,compiler,stage2,cmm,CmmParse,y) \
 859           && $(call sdist_file,compiler,stage2,main,ParsePkgConf,y) \
 860           && $(call sdist_file,compiler,stage2,parser,HaddockLex,x) \
 861           && $(call sdist_file,compiler,stage2,parser,HaddockParse,y) \
 862           && $(call sdist_file,compiler,stage2,parser,Lexer,x) \
 863           && $(call sdist_file,compiler,stage2,parser,Parser,y.pp) \
 864           && $(call sdist_file,compiler,stage2,parser,ParserCore,y) \
 865           && $(call sdist_file,utils/hpc,dist,,HpcParser,y) \
 866           && $(call sdist_file,utils/genprimopcode,dist,,Lexer,x) \
 867           && $(call sdist_file,utils/genprimopcode,dist,,Parser,y) \
 868           && "$(RM)" $(RM_OPTS) -r compiler/stage[123] mk/build.mk \
 869           && "$(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 "$(RM)" $(RM_OPTS) -r \
 870         )
 871
 872 .PHONY: sdist
 873 sdist : sdist-prep
 874         "$(TAR)" chf - $(SRC_DIST_NAME) 2>$src_log | bzip2 >$(TOP)/$(SRC_DIST_TARBALL)
 875
 876 sdist-manifest : $(SRC_DIST_TARBALL)
 877         tar tjf $(SRC_DIST_TARBALL) | sed "s|^ghc-$(ProjectVersion)/||" | sort >sdist-manifest
 878
 879 # Upload the distribution(s)
 880 # Retrying is to work around buggy firewalls that corrupt large file transfers
 881 # over SSH.
 882 ifneq "$(PublishLocation)" ""
 883 publish-sdist :
 884         $(call nTimes,10,$(PublishCp) $(SRC_DIST_TARBALL) $(PublishLocation)/dist)
 885 endif
 886
 887 ifeq "$(GhcUnregisterised)" "YES"
 888 SRC_CC_OPTS += -DNO_REGS -DUSE_MINIINTERPRETER -D__GLASGOW_HASKELL__=$(ProjectVersionInt)
 889 endif
 890
 891 # -----------------------------------------------------------------------------
 892 # Cleaning
 893
 894 .PHONY: clean
 895
 896 CLEAN_FILES += utils/ghc-pwd/ghc-pwd
 897 CLEAN_FILES += utils/ghc-pwd/ghc-pwd.exe
 898 CLEAN_FILES += utils/ghc-pwd/ghc-pwd.hi
 899 CLEAN_FILES += utils/ghc-pwd/ghc-pwd.o
 900 CLEAN_FILES += libraries/bootstrapping.conf
 901
 902 clean : clean_files clean_libraries
 903
 904 .PHONY: clean_files
 905 clean_files :
 906         "$(RM)" $(RM_OPTS) $(CLEAN_FILES)
 907
 908 .PHONY: clean_libraries
 909 clean_libraries:
 910         "$(RM)" $(RM_OPTS) -r $(patsubst %, libraries/%/dist, $(PACKAGES) $(PACKAGES_STAGE2))
 911         "$(RM)" $(RM_OPTS) -r $(patsubst %, libraries/%/dist-install, $(PACKAGES) $(PACKAGES_STAGE2))
 912         "$(RM)" $(RM_OPTS) -r $(patsubst %, libraries/%/dist-boot, $(PACKAGES) $(PACKAGES_STAGE2))
 913         "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/*.buildinfo, $(PACKAGES) $(PACKAGES_STAGE2))
 914
 915 distclean : clean
 916         "$(RM)" $(RM_OPTS) config.cache config.status config.log mk/config.h mk/stamp-h
 917         "$(RM)" $(RM_OPTS) mk/config.mk mk/are-validating.mk mk/project.mk
 918         "$(RM)" $(RM_OPTS) extra-gcc-opts docs/users_guide/ug-book.xml
 919         "$(RM)" $(RM_OPTS) compiler/ghc.cabal ghc/ghc-bin.cabal
 920         "$(RM)" $(RM_OPTS) libraries/base/include/HsBaseConfig.h
 921         "$(RM)" $(RM_OPTS) libraries/directory/include/HsDirectoryConfig.h
 922         "$(RM)" $(RM_OPTS) libraries/process/include/HsProcessConfig.h
 923         "$(RM)" $(RM_OPTS) libraries/unix/include/HsUnixConfig.h
 924         "$(RM)" $(RM_OPTS) libraries/old-time/include/HsTimeConfig.h
 925         "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/config.log, $(PACKAGES) $(PACKAGES_STAGE2))
 926         "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/config.status, $(PACKAGES) $(PACKAGES_STAGE2))
 927         "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/include/Hs*Config.h, $(PACKAGES) $(PACKAGES_STAGE2))
 928         "$(RM)" $(RM_OPTS) -r $(patsubst %, libraries/%/autom4te.cache, $(PACKAGES) $(PACKAGES_STAGE2))
 929
 930 maintainer-clean : distclean
 931         "$(RM)" $(RM_OPTS) configure mk/config.h.in
 932         "$(RM)" $(RM_OPTS) -r autom4te.cache libraries/*/autom4te.cache
 933         "$(RM)" $(RM_OPTS) ghc.spec
 934         "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/GNUmakefile, \
 935                 $(PACKAGES) $(PACKAGES_STAGE2))
 936         "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/ghc.mk, $(PACKAGES) $(PACKAGES_STAGE2))
 937         "$(RM)" $(RM_OPTS) $(patsubst %, libraries/%/configure, \
 938                 $(PACKAGES) $(PACKAGES_STAGE2))
 939         "$(RM)" $(RM_OPTS) libraries/base/include/HsBaseConfig.h.in
 940         "$(RM)" $(RM_OPTS) libraries/directory/include/HsDirectoryConfig.h.in
 941         "$(RM)" $(RM_OPTS) libraries/process/include/HsProcessConfig.h.in
 942         "$(RM)" $(RM_OPTS) libraries/unix/include/HsUnixConfig.h.in
 943         "$(RM)" $(RM_OPTS) libraries/old-time/include/HsTimeConfig.h.in
 944
 945 .PHONY: all_libraries
 946
 947 .PHONY: bootstrapping-files
 948 bootstrapping-files: $(OTHER_LIBS)
 949 bootstrapping-files: includes/ghcautoconf.h
 950 bootstrapping-files: includes/DerivedConstants.h
 951 bootstrapping-files: includes/GHCConstants.h
 952
 953 .DELETE_ON_ERROR:
 954