ghc bindist doesn't bundle up the assets needed for hyperlinked-source properly and doesn't treat certain base modules right
i've had to copy some files that aren't shipped with ghc, or perhaps i need to reinstall haddock in userland?
~ $ haddock --hyperlinked-source
haddock: internal error: /Users/carter/.install-ghc/ghc-8.0.0.20160417/lib/ghc-8.0.0.20160417/html/solarized.css: copyFile: does not exist (No such file or directory)
~ $ cp /Users/carter/.install-ghc/ghc-8.0.0.20160417/share/doc/ghc-8.0.0.20160417/html/libraries/base-4.9.0.0/src/style.css /Users/carter/.install-ghc/ghc-8.0.0.20160417/lib/ghc-8.0.0.20160417/html/solarized.css
cp /Users/carter/.install-ghc/ghc-8.0.0.20160417/share/doc/ghc-8.0.0.20160417/html/libraries/base-4.9.0.0/src/highlight.js /Users/carter/.install-ghc/ghc-8.0.0.20160417/lib/ghc-8.0.0.20160417/html/highlight.js
additionally i need to set
haddock-options: --hyperlinked-source
correctly in the ~/.cabal/config file, and if thats set wrong, source files are silently not generated as part of the docs, so debugging a typo there is pretty confusing!
sooo... either way, there seems to be two missing asset files in my build! namely those two files i had to CP!
as additional data, heres the customized perf build way i did
EXTRA_HADDOCK_OPTS=--hyperlinked-source
HADDOCK_DOCS = YES
BUILD_SPHINX_HTML = YES
BUILD_SPHINX_PDF = YES
libraries/integer-gmp_CONFIGURE_OPTS += --configure-option=--with-intree-gmp
my "debugging technique" was to run haddock --hyperlinked-source
and figure out what file is in the pretty builds and CP that over to the location haddock was complaining about and repeat
Trac metadata
Trac field | Value |
---|---|
Version | 8.0.1-rc3 |
Type | Bug |
TypeOfFailure | OtherFailure |
Priority | normal |
Resolution | Unresolved |
Component | Compiler |
Test case | |
Differential revisions | |
BlockedBy | |
Related | |
Blocking | |
CC | |
Operating system | |
Architecture |