haddock & web-friendly library links?
conal at conal.net
Tue Jan 9 20:32:43 EST 2007
I like your idea of placing a Haddock package URL in the .cabal file. Given
the creativity of the Haskell community, it'll be important to have a
mechanism for these cross-project links. I hope it gets some attention at
Hac. Cheers, - Conal
On 12/15/06, Simon Marlow <simonmarhaskell at gmail.com> wrote:
> Conal Elliott wrote:
> > My library uses others (including base & wxHaskell), and so references
> > to types & identifiers from those libraries show up in my Haddock docs.
> > When I put the docs on the web, the links are bogus. How can I get
> > those links to be web-accessible versions instead of my local versions?
> > Similarly, I want to package up my library so that others can build on
> > top of it and have their published haddock documentation contain
> > web-accessible pointers to my doc.
> > Have these issues been thought through? Thanks,
> I'm not suggesting that this is a long-term solution, but Haddock does let
> link to docs at an arbitrary URL, using the --read-interface flag. This
> exposed through Cabal, but you can always find out the Haddock command
> Cabal is executing and run a modified version by hand.
> Ultimately I expect as part of the Hackage project we should automatically
> generate Haddock docs for all the packages and link them together. This
> some thought, perhaps it's something we can talk about at Hac.
> Another thing we could consider doing is putting a public Haddock URL in
> .cabal file, and propagating this into the package configuration. Then
> when you
> generate Haddock docs there could be an option to link to either local or
> external docs for other packages.
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the Libraries