[Haskell-cafe] Please fix documentation for you Hackage packages!
headprogrammingczar at gmail.com
Mon Jan 6 21:40:27 UTC 2014
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...
More information about the Haskell-Cafe