[Haskell] ANNOUNCE: Haddock version

Ross Paterson ross at soi.city.ac.uk
Wed Jan 23 12:26:40 EST 2008

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

More information about the Libraries mailing list