-This is the root directory for functional-programming tools
-distributed by the Computing Science Department at Glasgow University.
-Simon Peyton Jones <simonpj@dcs.gla.ac.uk> is the ringleader of this
-effort. The tools are:
-
- ghc the Glasgow Haskell compilation system
- hslibs collection of Haskell libraries
- haggis the Haggis GUI toolkit
- happy the Happy Haskell parser generator
- green-card a foreign function interface pre-processor for Haskell.
- nofib the NoFib Haskell benchmarking suite
- literate the Glasgow "literate programming" system
- glafp-utils shared utility programs
- mk GNU make setup used by all of fptools
- docs documentation on the installing and using
- the fptools suite.
-
-The "literate" stuff is usually distributed *with* other systems, but
-not necessarily. Components which are always part of a distribution
-(never stand-alone) are "glafp-utils" and "mk" (a configuration
-system).
+fptools build system
+====================
+
+This is the top-level directory of the fptools build system. Several
+packages are part of this build system; if you got this as part of a
+source distribution (eg. for GHC), then you will have one or more of
+the following directories:
+
+ ghc The Glasgow Haskell Compiler
+ hslibs A Collection of Haskell libraries
+ haddock A Haskell documentation tool
+ haggis The Haggis GUI toolkit
+ happy The Happy Haskell parser generator
+ hdirect Haskell interop tool
+ green-card A foreign function interface pre-processor for Haskell.
+ libraries Haskell libraries (reqd. by ghc)
+ nofib The NoFib Haskell benchmarking suite
+
+Additional documentation for each project can be found in its
+respective directory.
+
+In addition, the following directories contain project-independent bits:
+
+ mk GNU make setup used by all of fptools
+ glafp-utils Shared utility programs
+ docs Documentation on the installing and using
+ the fptools build system.
+ distrib Tools and additional bits for building distributions
+
+Quick start: the following is *supposed* to work
+
+ $ ./configure
+ $ make
+ $ make install
+
+where 'make' is whatever GNU make is called on your system (GNU make
+is *required*). The configuration script is a standard GNU autoconf
+script which accepts all the normal arguments, eg. --prefix=<blah> to
+install the package somewhere other than /usr/local. Try ./configure
+--help to get a full list of the options.