[Haskell] ANNOUNCE: Haddock version 2.0.0.0

[Ross Paterson]

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.

> > 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