The HP build expects that the html docs for the ghc-bundled packages will be in heirarchical directories, based on the package name (e.g., GHC.Magic docs in libraries/ghc-prim-0.3.1.0/GHC-Magic.html) which is how it has been for many ghc releases. In 7.10.1, I thought it was an error but it seems the haskell.org docs reflect this new, flat way (e.g,. GHC.Magic docs in libraries/GHC-Magic.html). Just want to make sure this is what is expected, and then change the HP build code accordingly. Follow up question: should the HP-bundled docs do the same thing? Is the flat model the way to go for all the docs? Won't this cause collisions for updated packages? Randy
2015-03-31 20:20 GMT+02:00 Randy Polen
[...] Just want to make sure this is what is expected, and then change the HP build code accordingly. [...]
Hmmm, unless there is a strong reason to change this into a flat layout, I would propose to keep the docs hierarchical. I could envision clashes and tooling problems with the flat layout, but I fail to see why it should be better. To me, it just looks like a bug. If it's not a bug, could somebody point me to the discussion regarding the rationale behind the flat layout? Another related point: All "Source" links on haskell.org are currently broken, so the docs need to be regenerated an re-uploaded, anyway.
Hi Randy,
This is due to an upstream Haddock bug I didn't manage to fix before
the release; see https://ghc.haskell.org/trac/ghc/ticket/10206 - we
really need to fix this for 7.10.2.
I believe the problem we need to fix is in Haddock. The fact that the
non-hierarchical version appears on the website is just so people can
browse it (and FWIW, the 'correct links' are there, but obviously the
hyperlinks *to* the proper places are broken...)
On Tue, Mar 31, 2015 at 1:20 PM, Randy Polen
The HP build expects that the html docs for the ghc-bundled packages will be in heirarchical directories, based on the package name (e.g., GHC.Magic docs in libraries/ghc-prim-0.3.1.0/GHC-Magic.html) which is how it has been for many ghc releases. In 7.10.1, I thought it was an error but it seems the haskell.org docs reflect this new, flat way (e.g,. GHC.Magic docs in libraries/GHC-Magic.html).
Just want to make sure this is what is expected, and then change the HP build code accordingly.
Follow up question: should the HP-bundled docs do the same thing? Is the
flat model the way to go for all the docs? Won't this cause collisions for
updated packages?
Randy _______________________________________________ ghc-devs mailing list ghc-devs@haskell.org http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-devs
-- Regards, Austin Seipp, Haskell Consultant Well-Typed LLP, http://www.well-typed.com/
participants (3)
-
Austin Seipp -
Randy Polen -
Sven Panne