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
<br><br><div><span class="gmail_quote">On 12/15/06, <b class="gmail_sendername">Simon Marlow</b> <<a href="mailto:simonmarhaskell@gmail.com" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">simonmarhaskell@gmail.com
</a>> wrote:</span><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Conal Elliott wrote:<br>> My library uses others (including base & wxHaskell), and so references<br>> to types & identifiers from those libraries show up in my Haddock docs.<br>> When I put the docs on the web, the links are bogus. How can I get
<br>> those links to be web-accessible versions instead of my local versions?<br>><br>> Similarly, I want to package up my library so that others can build on<br>> top of it and have their published haddock documentation contain
<br>> web-accessible pointers to my doc.<br>><br>> Have these issues been thought through? Thanks,<br><br>I'm not suggesting that this is a long-term solution, but Haddock does let you<br>link to docs at an arbitrary URL, using the --read-interface flag. This isn't
<br>exposed through Cabal, but you can always find out the Haddock command that<br>Cabal is executing and run a modified version by hand.<br><br>Ultimately I expect as part of the Hackage project we should automatically<br>
generate Haddock docs for all the packages and link them together. This needs<br>some thought, perhaps it's something we can talk about at Hac.<br><br>Another thing we could consider doing is putting a public Haddock URL in the
<br>.cabal file, and propagating this into the package configuration. Then when you<br>generate Haddock docs there could be an option to link to either local or<br>external docs for other packages.<br><br>Cheers,<br> Simon
<br></blockquote></div><br>