I wanted to have a look at the latest happstack release, and noticed the documentation still wasn’t available on haddock.
http://hackage.haskell.org/package/happstack
It wasn’t available locally either, when I did cabal install happstack-server. In fact, haddock was not available offline for anything.
To get the haddocks locally, I edited ~/.cabal/config, setting
Documentation: True
(and uncommenting that line by removing the starting –)
After this, cabal install –reinstall built the documentation in
.cabal/share/doc/happstack-server-0.3.3/html/
handy
But shouldn’t this flag be on by default?
UPDATE:
cabal haddock –hyperlink-source
installs documentation with links to source code, which imho should also be on by defualt.
cabal install –haddock-options=–hyperlink sourceblehblehbleh
doesn’t throw an error. without the blehblehbleh it runs, but doesn’t install with source links, which seems like a bug to me.
Wow, this really helps. Thanks!
I also expected this to be on by default.
I tried this and got cabal to install a package with docs by default. Thanks! Any idea how to get it to add the source links by default?
Worked like a charm, but I should add that the “cabal –reinstall install foo” command has two hyphens but the blog system made a lovely ndash out of it. Nice to have the documentation offline for on the go hacking.