Integrating Cabal, Haddock, HsColour

Conal Elliott conal at conal.net
Fri May 4 15:02:33 EDT 2007


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 at 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 at 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 at haskell.org
> http://www.haskell.org/mailman/listinfo/cabal-devel
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.haskell.org/pipermail/cabal-devel/attachments/20070504/3c49dbba/attachment.htm


More information about the cabal-devel mailing list