[project @ 2005-02-07 11:11:33 by simonmar]
[ghc.git] / README
1 fptools build system
2 ====================
3
4 This is the top-level directory of the fptools build system.  Several
5 packages are part of this build system; if you got this as part of a
6 source distribution (eg. for GHC), then you will have one or more of
7 the following directories:
8
9     ghc           The Glasgow Haskell Compiler
10     hslibs        A Collection of Haskell libraries
11     haddock       A Haskell documentation tool
12     haggis        The Haggis GUI toolkit
13     happy         The Happy Haskell parser generator
14     hdirect       Haskell interop tool
15     greencard     A foreign function interface pre-processor for Haskell.
16     libraries     Haskell libraries (reqd. by ghc)
17     nofib         The NoFib Haskell benchmarking suite
18
19 Additional documentation for each project can be found in its
20 respective directory.
21
22 In addition, the following directories contain project-independent bits:
23
24     mk            GNU make setup used by all of fptools
25     glafp-utils   Shared utility programs
26     docs          Documentation on the installing and using
27                   the fptools build system.
28     distrib       Tools and additional bits for building distributions
29
30 Quick start:  the following is *supposed* to work
31
32         $ ./configure
33         $ make
34         $ make install
35
36 where 'make' is whatever GNU make is called on your system (GNU make
37 is *required*).  The configuration script is a standard GNU autoconf
38 script which accepts all the normal arguments, eg. --prefix=<blah> to
39 install the package somewhere other than /usr/local.  Try ./configure
40 --help to get a full list of the options.
41
42 There is usually an ANNOUNCE* file with any distribution.  Please
43 consult that, or the <piece>/README file, to find out how to proceed.
44
45 Full documentation for the fptools build system can be found in the 
46 Building Guide:
47
48         http://www.haskell.org/ghc/docs/latest/html/building/building-guide.html
49
50 More information about GHC can be found here:
51
52         http://www.haskell.org/ghc/
53
54 --
55 The GHC Team,  glasgow-haskell-users@haskell.org