BTW, see also http://haskell.org/haskellwiki/Cabal-make, which automates haddock & hscolour use and a few more things, via simple make files. I like Cabal integration, so I'm all for Roberto's Cabal improvements.
- Conal
On 4/26/07, Simon Marlow <simonmarhaskell@gmail.com> wrote:
Roberto Zunino wrote:
> I've just extended Cabal so to generate docs with links to highlighted
> sources. Now
>
> ./Setup configure
> ./Setup haddock --link-to-hscolour
> ./Setup hscolour --css my_own_stylesheet.css
>
> generates HTML as this one: (run on Cabal itself)
>
> http://www.di.unipi.it/~zunino/tmp/dist/doc/html/Cabal/Distribution-Program.html#v%3AwithProgramFlag
>
> Click on the "Source" links on the right. You will be sent to the exact
> line. The whole Cabal docs+sources are online. Colours have been chosen
> to match my emacs configuration :-P .
>
> This relies on a couple of minor tweaks to Haddock and HsColour which I
> darcs-sent this morning to the authors.
>
> Comments are welcome.
>
> - Is this worth including in the next Cabal version?
Looks really nice! (BTW, cabal-devel@haskell.org is a better place to discuss
Cabal improvements).
I'm happy for it to go in.
> - Are the options above good choices?
I'd make 'Setup haddock --hscolour' do both steps.
> - Is the directory tree OK? Currently Haddock creates (under dist/doc/html)
Looks fine.
Cheers,
Simon
_______________________________________________
cabal-devel mailing list
cabal-devel@haskell.org
http://www.haskell.org/mailman/listinfo/cabal-devel