[commit: ghc] master: Build system: cleanup BUILD_DIRS + add lots of Notes (8be43dd)

[git at git.haskell.org]

Repository : ssh://git@git.haskell.org/ghc

On branch  : master
Link       : http://ghc.haskell.org/trac/ghc/changeset/8be43dd966c9c56e530eab266d6bf2710f9b07f4/ghc

>---------------------------------------------------------------

commit 8be43dd966c9c56e530eab266d6bf2710f9b07f4
Author: Thomas Miedema <thomasmiedema at gmail.com>
Date:   Sat Jul 11 00:50:58 2015 +0200

    Build system: cleanup BUILD_DIRS + add lots of Notes
    
    Summary:
    See Note [CrossCompiling vs Stage1Only] in mk/config.mk.in.
    See Note [Stage1Only vs stage=1] in mk/config.mk.in.
    See Note [No stage2 packages when CrossCompiling or Stage1Only].
    
    Also:
      * use stage2 to build mkUserGuidePart, as was probably intended.
        Now the following represent the same set of packages:
        - packages that we build with ghc-stage2
        - packages that depend on the ghc library
        Those packages are: haddock, mkUserGuidePart and ghctags.
      * don't let utils that don't depend on the ghc library depend on its
        package-data.mk file. Instead, let those utils directly depend on
        the package-data.mk files of the stage1 packages. Not sure if it
        improves anything, but I found it easier to explain what's going on
        this way.
    
    (partially) reviewed by: austin
    
    Differential Revision: https://phabricator.haskell.org/D1218


>---------------------------------------------------------------

8be43dd966c9c56e530eab266d6bf2710f9b07f4
 compiler/ghc.mk              |   1 +
 ghc.mk                       | 174 +++++++++++++++++++++++++++++--------------
 ghc/ghc.mk                   |   2 +
 mk/config.mk.in              |  54 +++++++++++++-
 utils/ghc-pkg/ghc.mk         |   2 +
 utils/mkUserGuidePart/ghc.mk |   2 +-
 6 files changed, 176 insertions(+), 59 deletions(-)

Diff suppressed because of size. To see it, use:

    git diff-tree --root --patch-with-stat --no-color --find-copies-harder --ignore-space-at-eol --cc 8be43dd966c9c56e530eab266d6bf2710f9b07f4