I've noticed that many of the packages I upload to haddock don't build documentation properly, although the documentation builds fine locally when I run "cabal haddock". For example: http://hackage.haskell.org/cgi-bin/hackage-scripts/package/HAppSHelpers is fine in my local environment. I am not using quasiquotation. This also seems to be affecting many of the other happs bundles. thomas. 2008/11/21 Robert Greayer :

How does Hackage run 'haddock' on uploaded packages? I had assumed it directly runs the cabal 'haddock' target, e.g.

runhaskell Setup.hs haddock

but it appears to perhaps be more complex than that.

Some backrgound --

haddock doesn't seem to like quasiquotation - running haddock on a source tree that includes quasiquotations eventually results in:

haddock: internal Haddock or GHC error: Maybe.fromJust: Nothing

(eliminating the code that contains [$xxx|....] constructs gets rid of the error.)

so "runhaskell Setup.hs haddock" ends up not generating any documentation. I worked around this problem by using a 'UserHook' and adding in an extra path element to the source path prior to running haddock via Cabal:

...

main = defaultMainWithHooks (simpleUserHooks { preHaddock = \_ _ -> return (Just $ emptyBuildInfo { hsSourceDirs = ["noqqsrc"]},[]) })

The additional directory contains an alternate version of modules that don't contain quasiquotation (just types and stubs), which seems to hide the versions that do. This works fine locally, but not on hackage (still get the same behavior in the build failure log). Of course, I'd prefer not to have to do this at all, so if anyone knows a way around the problem (or if its purely my problem -- I'm doing something wrong), I'd appreciate hearing about it.

I'm using GHC 6.10.1, and have tried setup haddock with both the shipped-with-ghc version of haddock and the latest version.

Thanks, rcg

_______________________________________________ Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://www.haskell.org/mailman/listinfo/haskell-cafe