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

Malcolm Wallace malcolm.wallace at me.com
Mon Jan 6 16:39:38 UTC 2014


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


More information about the Haskell-Cafe mailing list