[[project @ 2002-07-01 14:27:26 by simonmar] simonmar**20020701142726 Add a top-level HTML page pulling together all the GHC documentation. ] { addfile ./ghc/docs/index.html hunk ./ghc/docs/Makefile 10 + +install-docs :: index.html + $(INSTALL_DATA) $(INSTALL_OPTS) index.html $(datadir)/html hunk ./ghc/docs/index.html 1 + + +
+Welcome to GHC! + +
This is the top of the GHC documentation tree, where you will find +links to all the supplied documentation about GHC and its +libraries.
+ +The User's Guide has all you need to know about using GHC: + command line options, language extensions, GHCi, etc. +
+
Hierarchical Libraries + +
GHC comes with a large number of libraries, arranged + hierarchically. The libraries are divided into packages - + to use a package of libraries from GHC or GHCi just add the flag + -package <name> to the command line, where + <name> is the name of the package (see the + section on packages in the User's Guide for more information). The + base and haskell98 packages are always available, + so you don't need to use the -package flag to get these. + +
+
++
Previous versions of GHC (before version 5.04) came with a suite + of libraries known as hslibs, aka the Hugs-GHC libraries. + As we are in the process of moving towards using hierarchical + libraries for everything, many of these libraries have moved over to + the new packages in the hierarchical libraries above. We still + provide the old hslibs libraries for backwards compatibility + and also for those libraries which have yet to move into the + hierarchy. For libraries which have moved, the documentation + contains a pointer to the location in the new libraries. +