commercialhaskell / commercialhaskell/stack

Post-GHC 9.6.7, links between GHC boot packages fail in Haddock documentation

Open
#6,807 4 comments 0 reactions 0 assignees View on GitHub
Dominant language
Haskell
Stars
4.1k
Forks
850
Avg merge
10h 37m
Merged PRs (30d)
4

Description

Context:
* https://github.com/commercialhaskell/stackage/issues/7818

On Windows, GHC 9.6.7 provides HTML files for Haddock documentation of GHC boot packages in folders like:
* `... \ghc-9.6.7\doc\html\libraries\base-4.18.3.0`

Subsequently, GHC provides those files in folders like (e.g. GHC 9.10.3):
* `...\ghc-9.10.3\doc\html\libraries\base-4.20.2.0-39f9`

Stack is unware of this change and in `.stack-work\install\ ... \doc` continues to have folders named after GHC boot package name-version (not id/key).

This situation results in duff links between GHC boot packages in Haddock documentation.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.