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@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@isolde:~/Development/haddock-0.8$ which haddock /home/michael/software/bin/haddock michael@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@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