[Haskell] ANNOUNCE: Haddock version 2.0.0.0

[David Waern]

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.

> > > 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 added this as a bug to TODO, but I'm not sure how to fix it easily.

David