[Haskell-cafe] Please fix documentation for you Hackage packages!

[Joe Quinn]

On 1/6/2014 11:39 AM, Malcolm Wallace wrote:
> Doxygen doesn't generate *.o files, either AFAIK...
> Ya!  Haddock's insistence on actually compiling the module (rather than just generating documentation) was the source of one of our most puzzling bugs ever.
>
> (1) Compile library with ghc.
> (2) Generate docs with Haddock.
> (3) Link library.
>
> Who would ever suspect that the code got recompiled with different options in that middle step?
>
You never know when you will want to have your documentation 
automatically generated by Template Haskell...