On Mon, Feb 19, 2007 at 05:36:58PM +0000, Ross Paterson wrote:
On Fri, Jan 19, 2007 at 05:18:07PM -0800, Conal Elliott wrote:
So now I have just a new pair of flags enable-use-packages & disable-use-packages, which control whether haddock gets automatically-generated --use-package flags.
There's a similar (but simpler) problem with generating Haddock documentation for HackageDB. The trouble is that --use-package is half right: it gives the interface file you want, but the wrong URL for cross-references. (And there's no way to override it, because haddock doesn't know which package a --read-interface option relates to.)
For HackageDB, I think the appropriate thing would be for Cabal to use ghc-pkg to get the haddock-interfaces field (instead of asking haddock to ask ghc-pkg for it), but for the user to be able to override the HTML URL at configure time. For HackageDB, a suitable template would be
http://hackage.haskell.org/packages/archive/$pkg/$pkgid.misc/doc/html or http://hackage.haskell.org/packages/archive/$pkg/latest.misc/doc/html
I've now implemented this (new option --html-location to setup haddock, rather than configure), and removed the --disable-use-packages and --enable-use-packages options.