Re: [Haskell] ANNOUNCE: Haddock version 2.0.0.0

23 Jan 2008


      On Wed, Jan 23, 2008 at 05:57:18PM +0100, David Waern wrote:
...
2008/1/23, Ross Paterson :
...
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