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

Rogan Creswick creswick at gmail.com
Mon Jan 6 19:02:56 UTC 2014


On Mon, Jan 6, 2014 at 8:47 AM, MigMit <miguelimo38 at yandex.ru> wrote:

> Hmmm, what if some parts of the code are TemplateHaskell-generated using
> some macros defined in the same package?
>

I'd be happy with it failing in that case.  It would be better than what we
have now!

I tend to think this could also be fixed (in many situations) but we *don't
need* a perfect solution.

--Rogan


> On 06 Jan 2014, at 20:23, Sven Panne <svenpanne at gmail.com> wrote:
>
> > 2014/1/6 Niklas Hambüchen <mail at nh2.me>:
> >> Haddock can't do it. The "Broken documentation on Hackage." thread
> >> explains it.
> >
> > That's not a good reason, it is just a technical accident and an
> > artifact of how the documentation is currently built. My point is: To
> > build the documentation, we should probably not build the package
> > itself, this seems to be the source of most problems. Doxygen doesn't
> > generate *.o files, either AFAIK...
> > _______________________________________________
> > Haskell-Cafe mailing list
> > Haskell-Cafe at haskell.org
> > http://www.haskell.org/mailman/listinfo/haskell-cafe
>
> _______________________________________________
> Haskell-Cafe mailing list
> Haskell-Cafe at haskell.org
> http://www.haskell.org/mailman/listinfo/haskell-cafe
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.haskell.org/pipermail/haskell-cafe/attachments/20140106/d3ecdc0d/attachment-0001.html>


More information about the Haskell-Cafe mailing list