Re: bit rotting of Haddock

On Wed, Aug 29, 2012 at 02:38:11PM +0200, David Waern wrote:
> Hi Simon,
> 
> 2012/8/28 Simon Hengel <[email protected]>:
> 
> > The following issues still persist:
> >
> >  (e) The library component does not build anymore, due to a refactoring
> >      of Main.hs, which was done in:
> >
> >       commit 315338287ea84b525da7d8fa8252cc9ec99597bb
> >       Author: Ian Lynagh <[email protected]>
> >       Date:   Tue Jun 12 14:38:01 2012 +0100
> >
> >           Follow changes in GHC
> >
> >  (f) The Unicode test fails for me.  Looks like characters outside the
> >      ASCII range are just striped from the documentation.
> 
> Yes, this is still not properly fixed.
> 
> >  (g) The TypeOperators test is brocken.
> 
> Probably due to the syntax changes in GHC 7.6.1.
> 
> > I guess (c) was an intended change, right?  What commit introduced that?
> 
> No idea about this one.
> 
> > What about (d)?  I made two commits to fix that, [2] and [3].  I'm
> > confident about [2], but is [3] an intended change?
> 
> Looks good to me. I think the CrossPackageDocs changes are due to API
> changes.

Hmm, I've still no explanation why the (Monad (Either e)) is gone from
the documentation.  I'll adapt the test for now, but until we come up
with a proper explanation for the changed behavior, I consider it a
regression.

Cheers,
Simon