|Version 12 (modified by igloo, 8 years ago) (diff)|
Video: Getting and Building, layout of the source tree, how to set up build.mk (23'43")
Getting the GHC Sources
There are two ways to get sources to GHC: download a source distribution, or get the sources directly from our repository using darcs.
A source distribution is a file like ghc-6.6-src.tar.bz2, which contains a complete snapshot of the source tree for a particular version of GHC. Source distributions for all versions of GHC are available from the download page.
Starting with GHC 6.6, we have split the source distribution in two:
- ghc-<version>-src.tar.bz2 contains GHC itself and the minimum libraries needed to bootstrap GHC.
- ghc-<version>-extralibs.tar.bz2 contains a selection of supplemental libraries that can be built and installed at the same time as GHC. Just unpack this on top of ghc-<version>-src.tar.bz2, and the extra libraries will be built automatically.
In addition to fixed releases of GHC, source distributions are also made each night from the current source repository, for both the HEAD and STABLE branches. To download these snapshots, head over to the download page.
Source distributions are easier to build, because we also include the output from running certain external tools like Happy, so you don't need to install these tools. See Building/Prerequisites for details.
Getting a GHC source tree using darcs
The first thing to do is install darcs.
A source tree consists of the GHC repository, with a set of packages in the libraries directory. We supply a script to automate the checking out of packages, darcs-all. Checking out a tree goes like this:
$ darcs get --partial http://darcs.haskell.org/ghc $ cd ghc $ chmod +x darcs-all $ ./darcs-all get
NOTE: You really want --partial when grabbing GHC. There are some 15000 patches in the repository, which take a long time to download without --partial. The darcs-all script automatically adds --partial for the packages. However, if you are a developer and intend to make changes to your GHC source tree, then we recommend not using --partial, and adding --complete to the darcs-all command-line which disables its default use of --partial. We avoid --partial when developing due to bugs in darcs that affect moving patches between partial repositories.
Getting GHC without --partial may take a while, so we occasionally make tarballs of the full GHC repo, which you can look for in here (look for files named ghc-HEAD-<date>.tar.bz2). However, if you do this, do it as follows
$ ..untar tarball.. $ cd ghc $ darcs pull -a $ ./darcs-all get
If you do darcs-all, and that pulls in a patch that modifies the darcs-all script itself, then bizarre things can (or at least could in the past) happen. The safe thing to do is to get your main ghc repo up to date (the darcs pull line) and then run the script.
The above will grab the "core" set of packages. This is the minimal set of packages required to bootstrap GHC. If you want to get a more comprehensive set of packages and include them in your GHC build, then you can say:
$ ./darcs-all --extra get
This isn't usually necessary: extra packages can be compiled and installed separately using Cabal, after you have built and installed GHC itself with its core packages. The list of "core" and "extra" packages is below.
Optionally, you might want to grab the testsuite and benchmark suite too, which also become sub-directories of ghc:
$ ./darcs-all --testsuite get $ ./darcs-all --nofib get
The full list of darcs repositories relating to GHC is at DarcsRepositories.
Getting a branch
The above instructions will get the HEAD - the main trunk of GHC development. There are also branches, from which stable releases are made. The active branches are listed on DarcsRepositories.
To get a branch, add the branch name after http://darcs.haskell.org/. For example, to get the ghc-6.6 branch, you would first say
$ darcs get --partial http://darcs.haskell.org/ghc-6.6/ghc
and then use darcs-all as above to get the rest of the respositories.
Pulling new patches
To update your tree from the master repositories, the quickest way is to use the darcs-all script:
$ ./darcs-all pull -a
See Building/Rebuilding for how to update your build after pulling patches.