[Haskell-cafe] developer docs with haddock: cabal or make?

[Duncan Coutts]

On Mon, 2008-05-26 at 15:26 +0200, Misha Aizatulin wrote:
> hello,
> 
>    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
> 
>    What is the right way to do this? I see two options, but both are 
> somewhat clumsy:

The latest version of Cabal has a new flag for the haddock command:

 --internal          Run haddock for internal modules and include all
                     symbols

I think that does what you're asking for. You'd say:

$ cabal haddock --internal


This will be in the Cabal-1.4 release or you can get the darcs version
now.

Duncan