X-Git-Url: http://git.megacz.com/?p=ghc-hetmet.git;a=blobdiff_plain;f=README;h=0adcfdd9a20c46f986ab38f4156de0672dc11344;hp=14265c5fa744d3a756a35b887674be511338cace;hb=c883f6969ad957637649f3af1a2b6977555bdd32;hpb=70d359351d459248fd4abd832077c65f3be8487d

diff --git a/README b/README
index 14265c5..0adcfdd 100644
--- a/README
+++ b/README
@@ -1,23 +1,60 @@
-This is the root directory for functional-programming tools
-distributed by the Computing Science Department at Glasgow University.
-Simon Peyton Jones <simonpj@microsoft.com> 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
-    hdirect     Haskell interop tool
-    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.
-
-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
+    greencard	  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*).  If there are any other tools required for the build,
+then the configure script will detect them and tell you if any are
+missing.  For example, a working GHC installation is required for
+building most of the tools (including GHC itself).
+
+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.
 
 There is usually an ANNOUNCE* file with any distribution.  Please
 consult that, or the <piece>/README file, to find out how to proceed.
+
+Full documentation for the fptools build system can be found in the 
+Building Guide:
+
+	http://www.haskell.org/ghc/docs/latest/html/building/building-guide.html
+
+More information about GHC can be found here:
+
+	http://www.haskell.org/ghc/
+
+--
+The GHC Team,  glasgow-haskell-users@haskell.org