Signed-off-by: Edward Z. Yang <ezyang@cs.stanford.edu>

During the build, when HADDOCK_DOCS=YES, the command 'cd libraries && sh
gen_contents_index --intree' is run, which calls haddock to generate the
haddock index at 'libraries/dist-haddock/index.html'.

What it did before was check the ./packages file for all libraries. The
problem is that 'base' and 'ghc-prim' were folded into the main repo
some time ago, hence don't have an entry in the ./packages file anymore.
As a result, 'base' and 'ghc-prim' were missing from the index.html
file.

It now simply runs haddock on all the all the `.haddock` files in the
libraries directory.

The only risk is that this could include the extra libraries in the
index.html, if you ever built them in the past (with
BUILD_EXTRA_PKGS=YES), even though now you want to exclude them (with
BUILD_EXTRA_PKGS=NO). gen_contents_index doesn't have access to build
system variables though (PACKAGES_STAGE1+PACKAGES_STAGE2), so fixing
this would be a little bit fiddly.

Test Plan:
'make libraries/dist-haddock/index.html && grep -q base
libraries/dist-haddock/index.html && echo ok'

Reviewed by: austin

Differential Revision: https://phabricator.haskell.org/D1247

Signed-off-by: Austin Seipp <austin@well-typed.com>

td123 authored 12 years ago and pcapriotti committed 12 years ago

Fixes http://hackage.haskell.org/trac/ghc/ticket/5992

This is tidier, and makes it easier to clean and install them correctly

We now make use of the ghc-packages file when making the haddock index.

We are now more lenient in parsing the packages file, and
we don't use any GNUisms. Based on a patch from Matthias Kilian.

We don't install dph etc, so don't put them in the doc index.

It was making incorrect URLs due to a shell script error.

On MSYS
    sed 's/.*[ \t]//'
wasn't matching
    version:<tab>1.0
so I've switched to
    's/.*[[:space:]]//'
which works on Linux, cygwin and MSYS.

You can now have multiple versions of a package installed, and
gen_contents_index will do the right thing.

Based on a patch from juhpetersen.

It now works again after it has been installed, as well as while it is
in a source tree.
After it's been installed it filters out the ghc package, as that
currently swamps everything else in the index.

One side-effect of this is that we need to build the install-utils with
stage2 rather than stage1 as we need the ghc package.

The library doc index thought that the docs were in $module.html, rather
than $package/$module.html.

Also fixes it with Solaris's sh, spotted by Christian Maeder

It's far too large now, and no-one complained when 6.8.1 didn't have one.