X-Git-Url: http://git.megacz.com/?p=ghc-hetmet.git;a=blobdiff_plain;f=README;h=c7d390d5c0182d623ba0fe262bc7b77ce86b7353;hp=44df7eccb26fea2e20cc5d5384c9d21bc339e374;hb=e5c3b478b3cd1707cf122833822f44b2ac09b8e9;hpb=383e71451b12d29a9b0d63fe37ce8bb7ffa87a8b diff --git a/README b/README index 44df7ec..c7d390d 100644 --- a/README +++ b/README @@ -27,35 +27,18 @@ There are two ways to get a source tree: which contains GHC itself and the "boot" libraries. - 2. Check out the source code from darcs - --------------------------------------- + 2. Check out the source code from git + ------------------------------------- - The recommended way to get a darcs checkout is to start off by - downloading a snapshot with a name like: + First get the GHC git repository: - ghc-HEAD-2009-09-09-ghc-corelibs-testsuite.tar.bz2 + $ git clone http://darcs.haskell.org/ghc.git/ - from: - - http://darcs.haskell.org/ - - and then untar it and bring it up-to-date with: - - $ cd ghc - $ ./darcs-all get - - - Alternatively you can use darcs to get the repos, but it will take a - lot longer. First get the GHC darcs repository: - - $ darcs get http://darcs.haskell.org/ghc/ - - Then run the darcs-all script in that repository + Then run the sync-all script in that repository to get the other repositories: $ cd ghc - $ chmod +x darcs-all - $ ./darcs-all get + $ ./sync-all get This checks out the "boot" packages. @@ -68,41 +51,30 @@ Here follows a summary - if you get into trouble, the Building Guide has all the answers. NB. you need GHC installed in order to build GHC, because the compiler -is itself written in Haskell. It is possible to build GHC using just -a C compiler, but we don't recommend this as the normal route. If you -*really* want to do it this way, then see the Building Guide. +is itself written in Haskell. For instructions on how to port GHC to a +new platform, see the Building Guide. -If you're building from darcs sources (as opposed to a source +If you're building from git sources (as opposed to a source distribution) then you also need to install Happy [4] and Alex [5]. For building library documentation, you'll need Haddock [6]. To build -the compiler documentation, you need a good DocBook XML toolchain. +the compiler documentation, you need a good DocBook XML toolchain and +dblatex. Quick start: the following gives you a default build: - $ sh boot + $ perl boot $ ./configure $ make $ make install -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, +The "perl boot" step is only necessary if this is a tree checked out +from git. 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. +It can take a long time. To customise the build, see the file HACKING.