GitLab

At the top level we now have cabal/ and cabal-install/

The chapter on installing packages still needs to be rewritten
to describe the cabal tool, rather than runhaskell Setup.hs

Means we only need to have the version in one place now. Yay.

Useless docbook tools.

The 1.8.x branch remains at 1.8.0.1

A few changes since version 1.8.0 that was released with ghc-6.12rc1

Add an explicit intermediate ProgramInvocation data type.

Apparently xsltproc does not validate against the dtd.
This should stop errors creaping back in.

As it says in http://docbook.sourceforge.net/release/xsl/current/README:

  - Use the base canonical URI in combination with one of the
    pathnames below. For example, for "chunked" HTML, output:

    http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl

This is to work around the file permissions problems with the
standard System.Directory.copyFile function. When installing
files we do not want to copy permissions or attributes from the
source files. On unix we want to use specific permissions and
on windows we want to inherit default permissions. On unix:
copyOrdinaryFile   sets the permissions to -rw-r--r--
copyExecutableFile sets the permissions to -rwxr-xr-x

Building the haddock docs requires building first. Arguably this is
a Cabal bug. It should probably generate the "autogen" files for
haddock and not just for build.

It did not actually contain any release notes and just
duplicated information in the README which was confusing.

To make easier to track recent Cabal / cabal-install changes

We need these types for their Read instances so that we
can still read older GHCs package db files when we make
changes to the current InstalledPackageInfo type, or the
types contained in it, like PackageIdentifier or License.

The user guide gets built in two different ways. There's a target
in Cabal's the top level Makefile and there is also the stuff that
the ghc build system uses. The ghc build system expects to copy in
doc/fptools.css and then delete it again on make clean. We want a
persistent copy so that we can make the docs when we've just got a
standalone Cabal build tree, so that's now kept as doc/Cabal.css.

Though we should try and limit divergence until 1.4.0 is released.

Keep up with recent minor api changes