> Just a few short questions after all these doc-related changes: What
> is the actual make incantation to build and install the documentation
> for GHC, hslibs, and libraries? Which tools are needed? Which subdirs
> of fptools/ are needed? My local ghc.spec is a little bit out
> of sync...
Ah yes, I was going to mention that to you (or try to fix it myself).
The documentation story is somewhat simpler now:
$ make html
from anywhere in the tree to build (recursively) all html docs,
including Haddock docs. Similarly for ps, pdf, etc. Tools needed:
DocBook tools as before to build the User's Guide, and Haddock to build
the docs in fptools/libraries. You need to checkout Haddock into the
source tree (fptools/haddock) and build it before doing 'make html'.
Then,
$ make install-docs
to install the docs in the appropriate place, which is $(datadir) for
everything except HTML. HTML goes in $(datadir)/html, in various
subdirectories for each document (or package, in the case of libraries).
After installing GHC now, you get a nice documentation tree in
$(datadir)/html with a root document $(datadir)/html/index.html which
points to the other components. Eg, here's one I installed earlier:
~/builds/install/share/ghc-5.03.20020701/html > ls
base/ haskell98/ haskell-src/ hslibs/ index.html network/
users_guide/
Take a look and let me know what you think!
Cheers,
Simon
_______________________________________________
Cvs-ghc mailing list
[EMAIL PROTECTED]
http://www.haskell.org/mailman/listinfo/cvs-ghc
