Changes between Version 12 and Version 13 of Building/GettingTheSources


Ignore:
Timestamp:
Oct 9, 2007 8:06:05 AM (7 years ago)
Author:
simonmar
Comment:

reorganise

Legend:

Unmodified
Added
Removed
Modified
  • Building/GettingTheSources

    v12 v13  
    2626The first thing to do is install [http://darcs.net/ darcs]. 
    2727 
    28 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: 
     28A source tree consists of the GHC repository, with a set of packages in the libraries directory.  If you only want to download the latest sources and aren't interested in working on GHC, then you can get ''partial'' repositories: 
    2929 
    3030{{{ 
     
    3535}}} 
    3636 
    37 '''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. 
     37The command `darcs-all` automates the fetching of the repositories for the libraries, and it automatically adds the `--partial` flag. 
    3838 
    39 Getting GHC without `--partial` may take a while, so we occasionally make tarballs of the full GHC repo, which you can look for in [http://darcs.haskell.org/ here] (look for files named `ghc-HEAD-<date>.tar.bz2`).  However, if you do this, do it as follows  
     39If you plan to modify GHC, then you really want to get repositories with full history rather than just partial repositories, the reason being that darcs has some bugs that sometimes cause problems when using partial repositories for anything more than just pulling the latest patches.  However, don't just omit the `--partial` flag: GHC has more than 16,000 patches and the get will take forever.  Instead, download a complete bundle of the required repositories first, these are on [http://darcs.haskell.org/] in files of the form `ghc-HEAD-`''date''`-ghc-corelibs-testsuite.tar.bz2`, e.g. `ghc-HEAD-2007-08-29-ghc-corelibs-testsuite.tar.bz2`.  After unpacking the bundle, update your repositories like this: 
     40 
    4041{{{ 
    4142   $ ..untar tarball..