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

[Malcolm Wallace]

On 6 Jan 2014, at 16:23, Sven Panne wrote:

> 2014/1/6 Niklas Hambüchen <mail at nh2.me>:
>> Haddock can't do it.
> 
> 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?

Regards,
    Malcolm