[Haskell-cafe] developer docs with haddock: cabal or make?
avatar at hot.ee
Mon May 26 13:38:06 EDT 2008
>> for the project I am doing, I would like to be able to create two
>> documentation sets:
>> - the user documentation, done with normal Setup.hs --haddock and
>> - the developer documentation, where all modules are exposed and
>> haddock is run with --ignore-all-exports
> The latest version of Cabal has a new flag for the haddock command:
> --internal Run haddock for internal modules and include all
wow, it's cool, how things happen right when you need them! :) This
new flag should make me happy indeed.
I am still interested if there is any plan to facilitate adding
custom Setup commands? The author might like to run something on the
code that isn't handled by Cabal already. In a Makefile you just add a
new target, but there is no easy way to do so in a Setup.hs yet.
One particular example would be the install-docs command, that
installs only the documentation. Because of it's absence, ghc currently
doesn't install the library documentation, when you do "make install-docs".
More information about the Haskell-Cafe