Package: libghc6-hunit-doc
Version:
1.1.1-2
Severity: grave
The only documentation files contained in the libghc6-hunit-doc
package are some index files and an empty documentation page for the
module Main. The module itself is completely undocumented, unless a
link to the JUnit page counts.
I've debugged this a little, and it looks like the problem is that
cabal first preprocesses the source with ghc6 -E. This turns the code
into non-literate Haskell and expands preprocessor macros. Both of
these are necessary, since in my tests haddock doesn't seem to
understand literate Haskell code.
The problem is that ghc6 -E *also* strips all the literate comments.
I was able to work around this with some awful sed magic that
pre-strips the literate comments:
sed -e '/^$\|^[^>#]/s/^/-- /' -e 's/^>//
Presumably you could do the same thing in a Cabal hook, such as
preHaddockHook.