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, [email protected] 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
[email protected]
http://www.haskell.org/mailman/listinfo/cabal-devel

Reply via email to