X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=README;h=042137bf2f0e5fa720f5440504d4e0d14d8a0fad;hb=44d4bf2c3eff873d18e683c0629f17a228e9dfe0;hp=3010e9e10a53869381f149f7ad1f7fafcd46152a;hpb=ed4240c7ff1a532e3eeadd9e5814fb191fc227fa;p=ghc-hetmet.git diff --git a/README b/README index 3010e9e..042137b 100644 --- a/README +++ b/README @@ -27,7 +27,7 @@ There are two ways to get a source tree: ghc--src-extralibs.tar.bz2 You only need the first one, which contains GHC itself and - the "core" libraries. + the "boot" libraries. The extralibs package contains a bunch of optional libraries. If you want, you can unpack this over the top of your source tree, and @@ -45,16 +45,17 @@ There are two ways to get a source tree: $ darcs get http://darcs.haskell.org/ghc/ - Then run the darcs-all shell script in that repository + Then run the darcs-all script in that repository to get the other repositories: $ cd ghc - $ sh darcs-all get + $ chmod +x darcs-all + $ ./darcs-all get - This grabs the "core" packages by default. To get the full set of + This grabs the "boot" packages by default. To get the full set of packages, instead say - $ sh darcs-all --extra get + $ ./darcs-all --extra get This also downloads the libraries that are normally bundled in the "extralibs" package (see above). @@ -71,44 +72,51 @@ below). You also need a few other tools installed: Happy [4], Alex [5], and Haddock [6] (for building library documentation), and a good DocBook -XML toolchain if you want to build the compiler documentation. +XML toolchain if you want to build the compiler documentation. Quick start: the following gives you a default build: - $ autoreconf - $ ./configure - $ make - $ make install + $ sh boot + $ ./configure + $ make + $ make install -The autoreconf step is only necessary if this is a tree checked out +The "sh boot" step is only necessary if this is a tree checked out from darcs. For source distributions downloaded from GHC's web site, this step has already been performed. +If you want the documentation too then use these commands instead: + + $ echo "XMLDocWays = html" > mk/build.mk + $ echo "HADDOCK_DOCS = YES" >> mk/build.mk + $ sh boot + $ ./configure + $ make + $ make install + $ make install-docs + These steps give you the default build, which includes everything optimised and built in various ways (eg. profiling libs are built). It can take a long time. To customise the build, see the file HACKING. -For full information on building GHC, see the GHC Building Guide [3], -which is also available in source form (DocBook XML) in docs/building. +For full information on building GHC, see the GHC Building Guide [3]. References ========== - [1] http://www.haskell.org/ghc/ GHC Home Page - [2] http://hackage.haskell.org/trac/ghc GHC Developer's Wiki - [3] http://www.haskell.org/ghc/docs/latest/html/building/index.html - Building Guide - - [4] http://www.haskell.org/happy/ Happy - [5] http://www.haskell.org/alex/ Alex - [6] http://www.haskell.org/haddock/ Haddock + [1] http://www.haskell.org/ghc/ GHC Home Page + [2] http://hackage.haskell.org/trac/ghc GHC Developer's Wiki + [3] http://hackage.haskell.org/trac/ghc/wiki/Building Building Guide + [4] http://www.haskell.org/happy/ Happy + [5] http://www.haskell.org/alex/ Alex + [6] http://www.haskell.org/haddock/ Haddock Contributors ============ Please see - + http://www.haskell.org/ghc/contributors.html