"failed to parse haddock prologue from file" error on module

[jberryman]

I've attached the project-in-progress that gives me this error (please ignore the ugly code therein). I tried removing some of the blocks of comments to see if any of them were causing a parse error, but without luck.

» cabal configure && cabal haddock                                                    1 ↵
Resolving dependencies...
Configuring pez-0.1.0...
Running Haddock for pez-0.1.0...
Preprocessing library pez-0.1.0...
Warning: The documentation for the following packages are not installed. No
links will be generated to these packages: rts-1.0, fclabels-1.0.4
Warning: Cannot read /home/me/.cabal/share/doc/thrist-0.2/html/thrist.haddock:
   Interface file is of wrong version: /home/me/.cabal/share/doc/thrist-0.2/html/thrist.haddock
Skipping this interface.
haddock coverage for dist/build/tmp16310/Data/Label/Zipper.hs:   28/30  93%
Warning: Data.Label.Zipper: could not find link destinations for:
    Data.Label.Abstract.Lens Data.Label.Maybe.:~>
haddock: failed to parse haddock prologue from file: dist/doc/html/pez/haddock-prolog16310.txt

I am able to build documentation for some other modules on my disk, but this one craps out on me.

» whereis haddock
haddock: /usr/bin/haddock /usr/share/man/man1/haddock.1.gz
» whereis cabal
cabal: /usr/bin/cabal
» cabal --version
cabal-install version 0.10.2
using version 1.10.1.0 of the Cabal library 
» haddock --version
Haddock version 2.9.2, (c) Simon Marlow 2006
Ported to use the GHC API by David Waern 2006-2008

sorry to dump my whole project on you all, but I can't seem to get any helpful debugging messages or track down the source of the error.

[jberryman]

failing project

[jberryman]

I figured out what haddock was choking on: I needed a new line with a dot in the package description before a code block:

    Changes 0.0.4 -> 0.1.0:
    .
    >  - use fclabels 1.0
    >  - zipper operations in Maybe by default

Naturally it would be nice if haddock could report a useful message in this case. Even knowing that the issue was in the .cabal file would have been a tremendous help.

[anonymous]

Milestone 2.10.0 deleted