[Haskell] ANNOUNCE: Haddock version 2.0.0.0

[David Waern]

2008/1/23, David Waern <david.waern at gmail.com>:
> 2008/1/23, Ross Paterson <ross at soi.city.ac.uk>:
> > On Wed, Jan 23, 2008 at 05:57:18PM +0100, David Waern wrote:
> > > 2008/1/23, Ross Paterson <ross at soi.city.ac.uk>:
> > > > If I add the new-style attributes to the base package, it hides those
> > > > modules in the documentation for base, but packages that depend on base
> > > > seem to generate links to locations in those hidden modules, e.g. uses
> > > > of IO point at GHC.IOBase.IO.
> > >
> > > That's definitely a bug, I'm adding it to the TODO file.
> >
> > That one is a show-stopper for HackageDB.
>
> Right, we have to prioritize this one.

I've now fixed this issue - a patch is available in the darcs repository.

> > > > Also, the new haddock rejects some modules the old one accepted.
> > > > For example, it doesn't like extra doc comments that aren't attached
> > > > to anything.
> > >
> > > Hmm, it is possible that the parser has (accidentally) become a bit stricter.
> >
> > Some examples of things people do that were harmless before:
> >
> > -- | module header
> >
> > -- | extra comment describing module
> > module MyModule where
> >
> > import Stuff -- ^ we might use this
> >
> > type MyInt = Int  -- ^ comment

I've tried these examples with Haddock 0.9 and it only accepts the
last one. That's a regression in Haddock 2. But the other examples
don't seem to be regressions.

David