[Conal Elliott] Re: getting cabal to pass more info to haddock

[Ross Paterson]

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.