[Haskell-cafe] Haddock doesn't work -- with Haddock

[Donald Bruce Stewart]

ttmrichter:
> 
>    I've been wrestling the last few days with putting Haddock
>    documentation into my code.  After a dead-simple library
>    failed to generate anything meaningful, I gave up, turfed my
>    copy of Haddock and downloaded the latest from the web
>    site.  (Haddock 0.8, it seems.)
> 
>      runhaskell Setup.lhs configure
>      runhaskell Setup.lhs build
>      runhaskell Setup.lhs install
> 
>    These three worked fine and I verified with "which haddock"
>    that the right executable is being run.  Then I typed
>    "runhaskell Setup.lhs haddock" and got this:
> 
>      michael at isolde:~/Development/haddock-0.8$ runhaskell
>      Setup.lhs install
>      Installing:
>      /home/michael/software/lib/haddock-0.8/ghc-6.6.1 &
>      /home/michael/software/bin haddock-0.8...
>      michael at isolde:~/Development/haddock-0.8$ which haddock
>      /home/michael/software/bin/haddock
>      michael at isolde:~/Development/haddock-0.8$ runhaskell
>      Setup.lhs haddock
>      Preprocessing executables for haddock-0.8...
>      Running Haddock for haddock-0.8...
>      Warning: cannot use package haddock-0.8:
>         ghc-pkg failed
>      Warning: cannot use package base-2.1.1:
>         interface
>      /home/michael/software/share/ghc-6.6.1/html/libraries/bas
>      e/base.haddock does not exist.
>      Warning: cannot use package haskell98-1.0:
>         HTML directory
>      /home/michael/software/share/ghc-6.6.1/html/libraries/has
>      kell98 does not exist.

All fine up to this point.

>      dist/build/tmp/src/Main.hs:"dist/build/tmp/src/Main.hs":
>      39:1: Parse error

Parse error in oen of the comments, around line 39.

>      michael at isolde:~/Development/haddock-0.8$
> 
>    This is exactly the same problem I had running Haddock on my
>    own project.  What's the next step from here?

Check that the comment is not using one the chars invalid in
H98/haddock. '/' is a common source of issues.

-- Don