Bitbucket is a code hosting site with unlimited public and private repositories. We're also free for small teams!

Close
The Glasgow Haskell Compiler
============================

This is the source tree for GHC, a compiler and interactive
environment for the Haskell functional programming language.

For more information, visit GHC's web site:

  http://www.haskell.org/ghc/

Information for developers of GHC can be found here:

  http://hackage.haskell.org/trac/ghc/


Getting the Source
==================

There are two ways to get a source tree:

  1. Download source tarballs
  ---------------------------

  Download the GHC source distribution:

      ghc-<version>-src.tar.bz2

  which contains GHC itself and the "boot" libraries.

  2. Check out the source code from git
  -------------------------------------

  First get the GHC git repository:

    $ git clone http://darcs.haskell.org/ghc.git/

  Then run the sync-all script in that repository
  to get the other repositories:

     $ cd ghc
     $ ./sync-all get

  This checks out the "boot" packages.


Building & Installing
=====================

For full information on building GHC, see the GHC Building Guide [3].
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.  For instructions on how to port GHC to a
new platform, see the Building Guide.

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 and
dblatex.

Quick start:  the following gives you a default build:

    $ perl boot
    $ ./configure
    $ make
    $ make install

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.

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.

Once you have a build you need to keep it going.  You need to keep all
repos in sync with the sync-all script [7].  To get the latest changes:

    $ ./sync-all pull
    $ ./sync-all get


References
==========

 [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
 [7] http://hackage.haskell.org/trac/ghc/wiki/Building/SyncAll


Contributors
============

Please see

   http://www.haskell.org/ghc/contributors.html

Recent activity

Kei Hibino

Commits by Kei Hibino were pushed to khibino/ghc-hack

c273ba9 - Same numbering in one NonRec series. Buffering bind into env, and flush into subst when entering expr tree. Not activating gvn flag only optimize is ...
Kei Hibino

Commits by Kei Hibino were pushed to khibino/ghc-hack

456752d - Implement GVN using core language substitution.
Kei Hibino

Commits by Kei Hibino were pushed to khibino/ghc-hack

b840b78 - Add an environment with subst which transform core to use value numbering.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.